X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/af330736d14bb0fe3b8121d90bd5bbf92bdd20f8..27f70a64389dbf769cf75fb672a50ea313495e3f:/man/frames.texi diff --git a/man/frames.texi b/man/frames.texi index 43b061a57e..f319101443 100644 --- a/man/frames.texi +++ b/man/frames.texi @@ -57,7 +57,7 @@ so that you can use many of the features described in this chapter. * Tooltips:: Displaying information at the current mouse position. * Mouse Avoidance:: Moving the mouse pointer out of the way. * Non-Window Terminals:: Multiple frames on terminals that show only one. -* XTerm Mouse:: Using the mouse in an XTerm terminal emulator. +* Text-Only Mouse:: Using the mouse in text-only terminals. @end menu @node Mouse Commands @@ -516,13 +516,13 @@ Here's a similar example for specifying a foreground color: @kindex C-z @r{(X windows)} @findex iconify-or-deiconify-frame Iconify the selected Emacs frame (@code{iconify-or-deiconify-frame}). +When typed on an Emacs frame's icon, deiconify instead. + The normal meaning of @kbd{C-z}, to suspend Emacs, is not useful under a graphical display that allows multiple applications to operate -simultaneously in their own windies, so Emacs gives @kbd{C-z} a +simultaneously in their own windows, so Emacs gives @kbd{C-z} a different binding in that case. -If you type this command on an Emacs frame's icon, it deiconifies the frame. - @item C-x 5 0 @kindex C-x 5 0 @findex delete-frame @@ -547,12 +547,18 @@ Delete all frames except the selected one. how the system (or the window manager) generally handles focus-switching between windows. There are two possibilities: either simply moving the mouse onto a window selects it (gives it focus), or -you have to click on it in a suitable way to do so. Unfortunately -there is no way Emacs can find out automatically which way the system -handles this, so you have to explicitly say, by setting the variable -@code{focus-follows-mouse}. If just moving the mouse onto a window -selects it, that variable should be @code{t}; if a click is necessary, -the variable should be @code{nil}. +you have to click on it in a suitable way to do so. On X, this focus +policy also affects whether the focus is given to a frame that Emacs +raises. Unfortunately there is no way Emacs can find out +automatically which way the system handles this, so you have to +explicitly say, by setting the variable @code{focus-follows-mouse}. +If just moving the mouse onto a window selects it, that variable +should be @code{t}; if a click is necessary, the variable should be +@code{nil}. + +The window manager that is part of MS-Windows always gives focus to a +frame that raises, so this variable has no effect in the native +MS-Windows build of Emacs. @node Speedbar @section Speedbar Frames @@ -865,6 +871,8 @@ protocol, are currently supported. @section Menu Bars @cindex Menu Bar mode @cindex mode, Menu Bar +@findex menu-bar-mode +@vindex menu-bar-mode You can turn display of menu bars on or off with @kbd{M-x menu-bar-mode} or by customizing the variable @code{menu-bar-mode}. @@ -904,6 +912,8 @@ global tool bar. XPM icons if Emacs was built with XPM support. Otherwise, the tool bar uses monochrome icons (PBM or XBM format). +@findex tool-bar-mode +@vindex tool-bar-mode You can turn display of tool bars on or off with @kbd{M-x tool-bar-mode} or by customizing the option @code{tool-bar-mode}. @@ -935,11 +945,18 @@ of hidden files (files starting with a dot) in that dialog. The variable @code{x-gtk-show-hidden-files} controls whether to show hidden files by default. -@vindex x-use-old-gtk-file-dialog - For Gtk+ version 2.4 and 2.6, you can make Emacs use the old file dialog -by setting the variable @code{x-use-old-gtk-file-dialog} to a non-@code{nil} -value. If Emacs is built with a Gtk+ version that has only one file dialog, -the setting of this variable has no effect. +@vindex x-gtk-use-old-file-dialog + For Gtk+ versions 2.4 through 2.10, you can select the old file +dialog (@code{gtk-file-selector}) by setting the variable +@code{x-gtk-use-old-file-dialog} to a non-@code{nil} value. If it is +@code{nil}, Emacs uses @code{gtk-file-chooser}. If Emacs is built +with a Gtk+ version that has only one file dialog, this variable has +no effect. + +@vindex x-gtk-file-dialog-help-text + Emacs adds help text to the Gtk+ file chooser dialog. The variable +@code{x-gtk-file-dialog-help-text} specifies the text to add; if it is +@code{nil}, that disables the added text. @node Tooltips @section Tooltips @@ -1031,21 +1048,26 @@ and use @kbd{M-x select-frame-by-name @key{RET} @var{name} @key{RET}} to select a frame according to its name. The name you specify appears in the mode line when the frame is selected. -@node XTerm Mouse +@node Text-Only Mouse @section Using a Mouse in Terminal Emulators -@cindex xterm, mouse support +@cindex mouse support @cindex terminal emulators, mouse support - Some terminal emulators under X support mouse clicks in the terminal -window. In a terminal emulator which is compatible with @code{xterm}, +Some terminal emulators support mouse clicks in the terminal window. + +@cindex xterm +In a terminal emulator which is compatible with @code{xterm}, you can use @kbd{M-x xterm-mouse-mode} to give Emacs control over simple use of the mouse---basically, only non-modified single clicks are supported. The normal @code{xterm} mouse functionality for such clicks is still available by holding down the @kbd{SHIFT} key when you -press the mouse button. +press the mouse button. Xterm Mouse mode is a global minor mode +(@pxref{Minor Modes}). Repeating the command turns the mode off +again. - Xterm Mouse mode is a global minor mode (@pxref{Minor Modes}). -Repeating the command turns the mode off again. +In the console on GNU/Linux, you can use @kbd{M-x t-mouse-mode}. You +need to have the gpm package installed and running on your system in +order for this to work. @ignore arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49