Re: When are toolkit file dialogs used?

[Jan D.]

> In man/files.texi I am rewriting
>
>   When Emacs is built with a suitable GUI toolkit, it pops up the
> standard File Selection dialog of that toolkit instead of prompting for
> the file name in the minibuffer.  On Unix and GNU/Linux platforms, 
> Emacs
> does that when built with LessTif and Motif toolkits; on MS-Windows, 
> the
> GUI version does that by default.
>
> as follows:
>
>   When Emacs is built with a suitable GUI toolkit, commands invoked
> with the mouse use standard File Selection dialog of that toolkit
> instead of prompting for the file name in the minibuffer.  On Unix and
> GNU/Linux platforms, Emacs does that when built with GTK, LessTif, and
> Motif toolkits; on MS-Windows, the GUI version does that by default.
>
>
> However, is that correct nowadays?  Or is more changed needed?

I don't know if this is the appropriate place, but the variable 
use-file-dialog also controls if a file dialog is used (the variable is 
new in 21.4).  use-file-dialog is documented in frames.texi so maybe it 
is redundant to mention it in files.texi also.

C-h v use-file-dialog

*Non-nil means mouse commands use a file dialog to ask for files.
This applies to commands from menus and tool bar buttons.  The value of
`use-dialog-box' takes precedence over this variable, so a file dialog 
is only
used if both `use-dialog-box' and this variable are non-nil.

        Jan D.