[Emacs-diffs] /srv/bzr/emacs/trunk r106529: More updates for the Frames chapter in Emacs manual.

[Chong Yidong]

------------------------------------------------------------
revno: 106529
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sun 2011-11-27 16:22:37 +0800
message:
  More updates for the Frames chapter in Emacs manual.
  
  * doc/emacs/frames.texi (Creating Frames): Move frame parameter example to
  Frame Parameters node.
  (Frame Commands): C-x 5 o does not warp the mouse by default.
  (Fonts): Add more GTK-style properties; also, they should be
  capitalized.
  (Special Buffer Frames): Node deleted; special-display is on the
  way out.
  (Frame Parameters): Example moved here from Creating Frames.
  Clarify that default-frame-alist affects the initial frame too.
  Delete auto-raise-mode and auto-lower-mode.
  (Wheeled Mice): Node deleted.  Content moved to Mouse Commands.
  (Dialog Boxes): Delete x-gtk-use-old-file-dialog.
  
  * doc/emacs/windows.texi (Window Choice): Add xref to Lisp manual for
  special-display-*.
modified:
  doc/emacs/ChangeLog
  doc/emacs/display.texi
  doc/emacs/emacs.texi
  doc/emacs/frames.texi
  doc/emacs/windows.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-11-26 13:51:58 +0000
+++ b/doc/emacs/ChangeLog       2011-11-27 08:22:37 +0000
@@ -1,3 +1,21 @@
+2011-11-27  Chong Yidong  <address@hidden>
+
+       * frames.texi (Creating Frames): Move frame parameter example to
+       Frame Parameters node.
+       (Frame Commands): C-x 5 o does not warp the mouse by default.
+       (Fonts): Add more GTK-style properties; also, they should be
+       capitalized.
+       (Special Buffer Frames): Node deleted; special-display is on the
+       way out.
+       (Frame Parameters): Example moved here from Creating Frames.
+       Clarify that default-frame-alist affects the initial frame too.
+       Delete auto-raise-mode and auto-lower-mode.
+       (Wheeled Mice): Node deleted.  Content moved to Mouse Commands.
+       (Dialog Boxes): Delete x-gtk-use-old-file-dialog.
+
+       * windows.texi (Window Choice): Add xref to Lisp manual for
+       special-display-*.
+
 2011-11-26  Eli Zaretskii  <address@hidden>
 
        * display.texi (Text Display): Update the description,

=== modified file 'doc/emacs/display.texi'
--- a/doc/emacs/display.texi    2011-11-26 13:51:58 +0000
+++ b/doc/emacs/display.texi    2011-11-27 08:22:37 +0000
@@ -122,7 +122,7 @@
 address@hidden value, Emacs adjusts point this way even if the scroll
 command leaves point in the window.  This variable affects all the
 scroll commands documented in this section, as well as scrolling with
-the mouse wheel (@pxref{Wheeled Mice}); in general, it affects any
+the mouse wheel (@pxref{Mouse Commands}); in general, it affects any
 command that has a address@hidden @code{scroll-command} property.
 @xref{Property Lists,,, elisp, The Emacs Lisp Reference Manual}.
 

=== modified file 'doc/emacs/emacs.texi'
--- a/doc/emacs/emacs.texi      2011-10-26 14:07:31 +0000
+++ b/doc/emacs/emacs.texi      2011-11-27 08:22:37 +0000
@@ -505,10 +505,8 @@
 * Fonts::               Changing the frame font.
 * Speedbar::            How to make and use a speedbar frame.
 * Multiple Displays::   How one Emacs job can talk to several displays.
-* Special Buffer Frames::  You can make certain buffers have their own frames.
 * Frame Parameters::    Changing the colors and other modes of frames.
 * Scroll Bars::         How to enable and disable scroll bars; how to use them.
-* Wheeled Mice::        Using mouse wheels for scrolling.
 * Drag and Drop::       Using drag and drop to open files and insert text.
 * Menu Bars::           Enabling and disabling the menu bar.
 * Tool Bars::           Enabling and disabling the tool bar.

=== modified file 'doc/emacs/frames.texi'
--- a/doc/emacs/frames.texi     2011-11-25 15:43:34 +0000
+++ b/doc/emacs/frames.texi     2011-11-27 08:22:37 +0000
@@ -8,7 +8,7 @@
 
   When Emacs is started on a graphical display, e.g. on the X Window
 System, it occupies a graphical system-level ``window''.  In this
-manual, we call this a @dfn{frame}; we reserve the word ``window'' for
+manual, we call this a @dfn{frame}, reserving the word ``window'' for
 the part of the frame used for displaying a buffer.  A frame initially
 contains one window, but it can be subdivided into multiple windows
 (@pxref{Windows}).  A frame normally also contains a menu bar, tool
@@ -53,10 +53,8 @@
 * Fonts::               Changing the frame font.
 * Speedbar::            How to make and use a speedbar frame.
 * Multiple Displays::   How one Emacs job can talk to several displays.
-* Special Buffer Frames::  You can make certain buffers have their own frames.
 * Frame Parameters::    Changing the colors and other modes of frames.
 * Scroll Bars::         How to enable and disable scroll bars; how to use them.
-* Wheeled Mice::        Using mouse wheels for scrolling.
 * Drag and Drop::       Using drag and drop to open files and insert text.
 * Menu Bars::           Enabling and disabling the menu bar.
 * Tool Bars::           Enabling and disabling the tool bar.
@@ -95,7 +93,7 @@
 
 @findex mouse-set-point
   The most basic mouse command is @code{mouse-set-point}, which is
-called by clicking with the left mouse button, @kbd{Mouse-1}, in the
+invoked by clicking with the left mouse button, @kbd{Mouse-1}, in the
 text area of a window.  This moves point to the position where you
 clicked.  If that window was not the selected window, it becomes the
 selected window.
@@ -190,6 +188,22 @@
 unshifted cursor motion command, in addition to the usual ways of
 deactivating the mark.  @xref{Shift Selection}.
 
address@hidden mouse wheel
address@hidden mouse-wheel-mode
address@hidden Mouse Wheel minor mode
address@hidden mode, Mouse Wheel
address@hidden mouse-wheel-follow-mouse
address@hidden mouse-wheel-scroll-amount
address@hidden mouse-wheel-progressive-speed
+  Some mice have a ``wheel'' which can be used for scrolling.  Emacs
+supports scrolling windows with the mouse wheel, by default, on most
+graphical displays.  To toggle this feature, use @kbd{M-x
+mouse-wheel-mode}.  The variables @code{mouse-wheel-follow-mouse} and
address@hidden determine where and by how much
+buffers are scrolled.  The variable
address@hidden determines whether the scroll
+speed is linked to how fast you move the wheel.
+
 @node Word and Line Mouse
 @section Mouse Commands for Words and Lines
 
@@ -366,13 +380,13 @@
 @cindex creating frames
 
 @kindex C-x 5
-  The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with
-parallel subcommands.  The difference is that @kbd{C-x 5} commands
-create a new frame rather than just a new window in the selected frame
-(@pxref{Pop Up Window}).  If an existing visible or iconified
-(``minimized'') frame already displays the requested material, these
-commands use the existing frame, after raising or deiconifying
-(``un-minimizing'') as necessary.
+  The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}.  Whereas
+each @kbd{C-x 4} command pops up a buffer in a different window in the
+selected frame (@pxref{Pop Up Window}), the @kbd{C-x 5} commands use a
+different frame.  If an existing visible or iconified (``minimized'')
+frame already displays the requested buffer, that frame is raised and
+deiconified (``un-minimized''); otherwise, a new frame is created on
+the current display terminal.
 
   The various @kbd{C-x 5} commands differ in how they find or create the
 buffer to select:
@@ -407,56 +421,32 @@
 @xref{Visiting}.
 @end table
 
address@hidden default-frame-alist
address@hidden initial-frame-alist
address@hidden face customization, in init file
address@hidden color customization, in init file
-  You can control the appearance of new frames you create by setting the
-frame parameters in @code{default-frame-alist}.  You can use the
-variable @code{initial-frame-alist} to specify parameters that affect
-only the initial frame.  @xref{Initial Parameters,,, elisp, The Emacs
-Lisp Reference Manual}, for more information.
-
address@hidden font (default)
-  Here is an example of using @code{default-frame-alist} to specify
-the default foreground color and font:
-
address@hidden
-(add-to-list 'default-frame-alist '(font . "10x20"))
-(add-to-list 'default-frame-alist
-             '(foreground-color . "blue"))
address@hidden example
-
address@hidden
-By putting such customizations in your init file, you can control the
-appearance of all the frames Emacs creates, including the initial one
-(@pxref{Init File}).  @xref{Fonts}, for other ways to set the default
-font.
+  You can control the appearance and behavior of the newly-created
+frames by specifying @dfn{frame parameters}.  @xref{Frame Parameters}.
 
 @node Frame Commands
 @section Frame Commands
 
-  The following commands let you create, delete and operate on frames:
+  The following commands are used to delete and operate on frames:
 
 @table @kbd
address@hidden C-x 5 0
address@hidden C-x 5 0
address@hidden delete-frame
+Delete the selected frame (@code{delete-frame}).  This signals an
+error if there is only one frame.
+
 @item C-z
 @kindex C-z @r{(X windows)}
 @findex suspend-frame
 Minimize (or ``iconify) the selected Emacs frame
 (@code{suspend-frame}).  @xref{Exiting}.
 
address@hidden C-x 5 0
address@hidden C-x 5 0
address@hidden delete-frame
-Delete the selected frame (@code{delete-frame}).  This is not allowed
-if there is only one frame.
-
 @item C-x 5 o
 @kindex C-x 5 o
 @findex other-frame
-Select another frame, raise it, and warp the mouse to it.  If you
-repeat this command, it cycles through all the frames on your
-terminal.
+Select another frame, and raise it.  If you repeat this command, it
+cycles through all the frames on your terminal.
 
 @item C-x 5 1
 @kindex C-x 5 1
@@ -464,43 +454,37 @@
 Delete all frames on the current terminal, except the selected one.
 @end table
 
-  The @kbd{C-x 5 0} (@code{delete-frame}) command never deletes the
-last frame.  This prevents you from losing the ability to interact
-with the Emacs process.  Note that when Emacs is run as a daemon
-(@pxref{Emacs Server}), there is always a ``virtual frame'' that
-remains after all the ordinary, interactive frames are deleted.  In
-this case, @kbd{C-x 5 0} can delete the last interactive frame; you
-can use @command{emacsclient} to reconnect to the Emacs session.
+  The @kbd{C-x 5 0} (@code{delete-frame}) command deletes the selected
+frame.  However, it will refuse to delete the last frame in an Emacs
+session, to prevent you from losing the ability to interact with the
+Emacs session.  Note that when Emacs is run as a daemon (@pxref{Emacs
+Server}), there is always a ``virtual frame'' that remains after all
+the ordinary, interactive frames are deleted.  In this case, @kbd{C-x
+5 0} can delete the last interactive frame; you can use
address@hidden to reconnect to the Emacs session.
 
-  The @kbd{C-x 5 1} (@code{delete-other-frames}) command only deletes
-frames on the current terminal.  For example, if you call it from an X
-frame, it deletes the other frames on that X display; if the Emacs
-process has frames open on other X displays or text terminals, those
-are not deleted.
+  The @kbd{C-x 5 1} (@code{delete-other-frames}) command deletes all
+other frames on the current terminal (this terminal refers to either a
+graphical display, or a text-only terminal; @pxref{Non-Window
+Terminals}).  If the Emacs session has frames open on other graphical
+displays or text terminals, those are not deleted.
 
 @vindex focus-follows-mouse
-  On X, you may have to tell Emacs how the window manager handles
-focus-switching between windows, in order for @kbd{C-x 5 o}
-(@code{other-frame}) to work properly.  Unfortunately, there is no way
-for Emacs to detect this automatically, so you should set the variable
address@hidden  The default is @code{nil}, meaning you
-have to click on the window to select it (the default for most modern
-window managers).  You should change it to @code{t} if your window
-manager selects a window and gives it focus anytime you move the mouse
-onto the window.
-
-  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.  However, you may still wish to set this
-variable to @code{t} to have Emacs automatically move the mouse
-pointer to the raised frame.
+  The @kbd{C-x 5 o} (@code{other-frame}) command selects the next
+frame on the current terminal.  If you are using Emacs on the X Window
+System with a window manager that selects (or @dfn{gives focus to})
+whatever frame the mouse cursor is over, you have to change the
+variable @code{focus-follows-mouse} to @code{t} in order for this
+command to work properly.  Then invoking @kbd{C-x 5 o} will also warp
+the mouse cursor to the chosen frame.
 
 @node Fonts
 @section Fonts
 @cindex fonts
 
-  By default, Emacs displays text in X using a 12-point monospace
-font.  There are several different ways to specify a different font:
+  By default, Emacs displays text on graphical displays using a
+12-point monospace font.  There are several different ways to specify
+a different font:
 
 @itemize
 @item
@@ -514,7 +498,7 @@
 parameter (@pxref{Creating Frames}), like this:
 
 @smallexample
-(add-to-list 'default-frame-alist '(font . "DejaVu Sans Mono-12"))
+(add-to-list 'default-frame-alist '(font . "DejaVu Sans Mono-10"))
 @end smallexample
 
 @cindex X defaults file
@@ -536,18 +520,16 @@
 If you are running Emacs on the GNOME desktop, you can tell Emacs to
 use the default system font by setting the variable
 @code{font-use-system-font} to @code{t} (the default is @code{nil}).
-For this to work, Emacs must be compiled with Gconf support; this is
-done automatically if the libraries are present at compile time.
+For this to work, Emacs must have been compiled with Gconf support.
 
 @item
 Use the command line option @samp{-fn} (or @samp{--font}).  @xref{Font
 X}.
 @end itemize
 
-To check what font you're currently using, the @kbd{C-u C-x =}
-command can be helpful.  It'll describe the character under point, and
-also say what font it's rendered in, if the window system you're
-running under supports that.
+  To check what font you're currently using, the @kbd{C-u C-x =}
+command can be helpful.  It describes the character at point, and
+names the font that it's rendered in.
 
 @cindex fontconfig
   On X, there are four different ways to express a ``font name''.  The
@@ -561,7 +543,7 @@
 @noindent
 Within this format, any of the elements in braces may be omitted.
 Here, @var{fontname} is the @dfn{family name} of the font, such as
address@hidden or @samp{DejaVu Serif}; @var{fontsize} is the
address@hidden or @samp{DejaVu Sans Mono}; @var{fontsize} is the
 @dfn{point size} of the font (one @dfn{printer's point} is about 1/72
 of an inch); and the @address@hidden@var{values}} entries specify
 settings such as the slant and weight of the font.  Each @var{values}
@@ -574,7 +556,7 @@
 
 @table @samp
 @item slant
-One of @samp{italic}, @samp{oblique} or @samp{roman}.
+One of @samp{italic}, @samp{oblique}, or @samp{roman}.
 
 @item weight
 One of @samp{light}, @samp{medium}, @samp{demibold}, @samp{bold} or
@@ -608,8 +590,9 @@
 Fontconfig manual, which is distributed with Fontconfig and available
 online at @url{http://fontconfig.org/fontconfig-user.html}.
 
-  The second way to specify a font is to use a @dfn{GTK font
-description}.  These have the syntax
address@hidden GTK font pattern
+  The second way to specify a font is to use a @dfn{GTK font pattern}.
+These have the syntax
 
 @smallexample
 @var{fontname} address@hidden address@hidden
@@ -618,20 +601,24 @@
 @noindent
 where @var{fontname} is the family name, @var{properties} is a list of
 property values separated by spaces, and @var{fontsize} is the point
-size.  The properties that you may specify are as follows:
+size.  The properties that you may specify for GTK font patterns are
+as follows:
 
address@hidden @samp
address@hidden style
-One of @samp{roman}, @samp{italic} or @samp{oblique}.  If omitted, the
address@hidden style is used.
address@hidden weight
-One of @samp{medium}, @samp{ultra-light}, @samp{light},
address@hidden, or @samp{bold}.  If omitted, @samp{medium} weight is
-used.
address@hidden table
address@hidden
address@hidden
+Slant properties: @samp{Italic} or @samp{Oblique}.  If omitted, the
+default (roman) slant is implied.
address@hidden
+Weight properties: @samp{Bold}, @samp{Book}, @samp{Light},
address@hidden, @samp{Semi-bold}, or @samp{Ultra-light}.  If omitted,
address@hidden weight is implied.
address@hidden
+Width properties: @samp{Semi-Condensed} or @samp{Condensed}.  If
+omitted, a default width is used.
address@hidden itemize
 
 @noindent
-Here are some examples of GTK font descriptions:
+Here are some examples of GTK font patterns:
 
 @smallexample
 Monospace 12
@@ -683,8 +670,8 @@
 @samp{extended}, or @samp{semicondensed} (some font names support
 other values).
 @item style
-An optional additional style name.  Usually it is empty---most long
-font names have two hyphens in a row at this point.
+An optional additional style name.  Usually it is empty---most XLFDs
+have two hyphens in a row at this point.
 @item pixels
 The font height, in pixels.
 @item height
@@ -853,117 +840,41 @@
 frame.  The commands you enter with a particular X server apply to
 that server's selected frame.
 
-  It is even possible to use this feature to let two or more users
-type simultaneously on the two displays, within the same Emacs job.
-In practice, however, the different users can easily interfere with
-each others' edits if they are not careful.
-
address@hidden Special Buffer Frames
address@hidden Special Buffer Frames
-
address@hidden special-display-buffer-names
-  You can make certain chosen buffers, which Emacs normally displays
-in ``some other window'' (@pxref{Displaying Buffers}), appear in
-special frames of their own.  To do this, set the variable
address@hidden to a list of buffer names; any
-buffer whose name is in that list automatically gets a special frame.
address@hidden Choice}, for how this fits in with the other ways for
-Emacs to choose a window to display in.
-
-  For example, if you set the variable this way,
-
address@hidden
-(setq special-display-buffer-names
-      '("*Completions*" "*grep*" "*tex-shell*"))
address@hidden example
-
address@hidden
-then completion lists, @code{grep} output and the @TeX{} mode shell
-buffer get individual frames of their own.  These frames, and the
-windows in them, are never automatically split or reused for any other
-buffers.  They continue to show the buffers they were created for,
-unless you alter them by hand.  Killing the special buffer deletes its
-frame automatically.
-
address@hidden special-display-regexps
-  More generally, you can set @code{special-display-regexps} to a list
-of regular expressions; then a buffer gets its own frame if its name
-matches any of those regular expressions.  (Once again, this applies only
-to buffers that normally get displayed for you in ``another window.'')
-
address@hidden special-display-frame-alist
-  The variable @code{special-display-frame-alist} specifies the frame
-parameters for these frames.  It has a default value, so you don't need
-to set it.
-
-  For those who know Lisp, an element of
address@hidden or @code{special-display-regexps}
-can also be a list.  Then the first element is the buffer name or
-regular expression; the rest of the list specifies how to create the
-frame.  It can be an association list specifying frame parameter
-values; these values take precedence over parameter values specified
-in @code{special-display-frame-alist}.  If you specify the symbol
address@hidden as a ``frame parameter'' in this list, with a
address@hidden value, that means to use the selected window if
-possible.  If you use the symbol @code{same-frame} as a ``frame
-parameter'' in this list, with a address@hidden value, that means to
-use the selected frame if possible.
-
-  Alternatively, the value can have this form:
-
address@hidden
-(@var{function} @var{args}...)
address@hidden example
-
address@hidden
-where @var{function} is a symbol.  Then the frame is constructed by
-calling @var{function}; its first argument is the buffer, and its
-remaining arguments are @var{args}.
-
 @node Frame Parameters
address@hidden Setting Frame Parameters
address@hidden Auto-Raise mode
address@hidden Auto-Lower mode
-
-  These commands are available for controlling the window management
-behavior of the selected frame:
-
address@hidden @kbd
address@hidden auto-raise-mode
address@hidden M-x auto-raise-mode
-Toggle whether or not the selected frame should auto-raise.  Auto-raise
-means that every time you move the mouse onto the frame, it raises the
-frame.
-
-Some window managers also implement auto-raise.  If you enable
-auto-raise for Emacs frames in your window manager, it will work, but
-it is beyond Emacs' control, so @code{auto-raise-mode} has no effect
-on it.
-
address@hidden auto-lower-mode
address@hidden M-x auto-lower-mode
-Toggle whether or not the selected frame should auto-lower.
-Auto-lower means that every time you move the mouse off the frame,
-the frame moves to the bottom of the stack on the screen.
-
-The command @code{auto-lower-mode} has no effect on auto-lower
-implemented by the window manager.  To control that, you must use the
-appropriate window manager features.
address@hidden table
-
-  In Emacs versions that use an X toolkit, the color-setting and
-font-setting functions don't affect menus and the menu bar, since they
-are displayed by their own widget classes.  To change the appearance of
-the menus and menu bar, you must use X resources (@pxref{Resources}).
address@hidden, regarding colors.  @xref{Font X}, regarding choice of
-font.
-
-  Colors, fonts, and other attributes of the frame's display can also
-be customized by setting frame parameters in the variable
address@hidden (@pxref{Creating Frames}).  For a detailed
-description of frame parameters and customization, see @ref{Frame
address@hidden Frame Parameters
address@hidden default-frame-alist
+
+  You can control the default appearance and behavior of all frames by
+specifying a default list of @dfn{frame parameters} in the variable
address@hidden  Its value should be a list of entries,
+each specifying a parameter name and a value for that parameter.
+These entries take effect whenever Emacs creates a new frame,
+including the initial frame.
+
address@hidden frame size, specifying default
+  For example, you can add the following lines to your init file
+(@pxref{Init File}) to set the default frame width to 90 character
+columns, the default frame height to 40 character rows, and the
+default font to @samp{Monospace-10}:
+
address@hidden
+(add-to-list 'default-frame-alist '(width  . 90))
+(add-to-list 'default-frame-alist '(height . 40))
+(add-to-list 'default-frame-alist '(font . "Monospace-10"))
address@hidden example
+
+  For a list of frame parameters and their effects, see @ref{Frame
 Parameters,,, elisp, The Emacs Lisp Reference Manual}.
 
address@hidden initial-frame-alist
+  You can also specify a list of frame parameters which apply to just
+the initial frame, by customizing the variable
address@hidden
+
+  If Emacs is compiled to use an X toolkit, frame parameters that
+specify colors and fonts don't affect menus and the menu bar, since
+those are drawn by the toolkit and not directly by Emacs.
+
 @node Scroll Bars
 @section Scroll Bars
 @cindex Scroll Bar mode
@@ -1007,41 +918,17 @@
 bar width, change the @code{scroll-bar-width} frame parameter
 (@pxref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}).
 
address@hidden Wheeled Mice
address@hidden Scrolling With ``Wheeled'' Mice
-
address@hidden mouse wheel
address@hidden wheel, mouse
address@hidden mouse-wheel-mode
address@hidden Mouse Wheel minor mode
address@hidden mode, Mouse Wheel
-  Some mice have a ``wheel'' instead of a third button.  You can
-usually click the wheel to act as either @kbd{Mouse-2} or
address@hidden, depending on the setup.  You can also use the wheel to
-scroll windows instead of using the scroll bar or keyboard commands.
-Mouse wheel support only works if the system generates appropriate
-events; whenever possible, it is turned on by default.  To toggle this
-feature, use @kbd{M-x mouse-wheel-mode}.
-
address@hidden mouse-wheel-follow-mouse
address@hidden mouse-wheel-scroll-amount
address@hidden mouse-wheel-progressive-speed
-  The two variables @code{mouse-wheel-follow-mouse} and
address@hidden determine where and by how much
-buffers are scrolled.  The variable
address@hidden determines whether the scroll
-speed is linked to how fast you move the wheel.
-
 @node Drag and Drop
 @section Drag and Drop
 @cindex drag and drop
 
-  Emacs supports @dfn{drag and drop} using the mouse.  For instance,
-dropping text onto an Emacs frame inserts the text where it is dropped.
-Dropping a file onto an Emacs frame visits that file.  As a special
-case, dropping the file on a Dired buffer moves or copies the file
-(according to the conventions of the application it came from) into the
-directory displayed in that buffer.
+  In most graphical desktop environments, Emacs has basic support for
address@hidden and drop} operations.  For instance, dropping text onto an
+Emacs frame inserts the text where it is dropped.  Dropping a file
+onto an Emacs frame visits that file.  As a special case, dropping the
+file on a Dired buffer moves or copies the file (according to the
+conventions of the application it came from) into the directory
+displayed in that buffer.
 
 @vindex dnd-open-file-other-window
   Dropping a file normally visits it in the window you drop it on.  If
@@ -1058,13 +945,12 @@
 @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}.
-With no argument, this command toggles Menu Bar mode, a
-minor mode.  With an argument, the command turns Menu Bar mode on if the
-argument is positive, off if the argument is not positive.  You can use
-the X resource @samp{menuBar} to control the initial setting of
-Menu Bar mode.  @xref{Resources}.
+  You can toggle the use of menu bars with @kbd{M-x menu-bar-mode}.
+With no argument, this command toggles Menu Bar mode, a global minor
+mode.  With an argument, the command turns Menu Bar mode on if the
+argument is positive, off if the argument is not positive.  To control
+the use of menu bars at startup, customize the variable
address@hidden
 
 @kindex C-Mouse-3 @r{(when menu bar is disabled)}
   Expert users often turn off the menu bar, especially on text-only
@@ -1148,47 +1034,39 @@
 help text to the GTK+ file chooser dialog; to disable this help text,
 change the variable @code{x-gtk-file-dialog-help-text} to @code{nil}.
 
address@hidden x-gtk-use-old-file-dialog
-  In GTK+ versions 2.4 through 2.10, you can choose to use an older
-version of the GTK+ file dialog by setting the variable
address@hidden to a address@hidden value.  If Emacs
-is built with a GTK+ version that has only one file dialog, this
-variable has no effect.
-
 @node Tooltips
 @section Tooltips
 @cindex tooltips
 
-  @dfn{Tooltips} are small windows that display text information at the
-current mouse position.  They activate when there is a pause in mouse
-movement.  There are two types of tooltip: help tooltips and GUD
-tooltips.
-
-  @dfn{Help tooltips} typically display over text---including the mode
-line---but are also available for other parts of the Emacs frame, such
-as the tool bar and menu items.
+  @dfn{Tooltips} are small windows that display text information at
+the current mouse position.  They activate when there is a pause in
+mouse movement over some significant piece of text in a window, or the
+mode line, or some other part of the Emacs frame such as a tool bar
+button or menu item.
 
 @findex tooltip-mode
-  You can toggle display of help tooltips (Tooltip mode) with the
-command @kbd{M-x tooltip-mode}.  When Tooltip mode is disabled, the
-help text is displayed in the echo area instead.
-
-  @dfn{GUD tooltips} show values of variables.  They are useful when
-you are debugging a program.  @xref{Debugger Operation}.
+  You can toggle the use of tooltips with the command @kbd{M-x
+tooltip-mode}.  When Tooltip mode is disabled, the help text is
+displayed in the echo area instead.  To control the use of tooltips at
+startup, customize the variable @code{tooltip-mode}.
 
 @vindex tooltip-delay
   The variables @code{tooltip-delay} specifies how long Emacs should
 wait before displaying a tooltip.  For additional customization
 options for displaying tooltips, use @kbd{M-x customize-group
address@hidden tooltip @key{RET}}.  @xref{X Resources}, for information on
-customizing the windows that display tooltips.
address@hidden tooltip @key{RET}}.
 
 @vindex x-gtk-use-system-tooltips
   If Emacs is built with GTK+ support, it displays tooltips via GTK+,
 using the default appearance of GTK+ tooltips.  To disable this,
 change the variable @code{x-gtk-use-system-tooltips} to @code{nil}.
-If you do this, or if Emacs is built without GTK+ support, the
address@hidden face specifies most attributes of the tooltip text.
+If you do this, or if Emacs is built without GTK+ support, most
+attributes of the tooltip text are specified by the @code{tooltip}
+face, and by X resources (@pxref{X Resources}).
+
+  @dfn{GUD tooltips} are special tooltips that show the values of
+variables when debugging a program with GUD.  @xref{Debugger
+Operation}.
 
 @node Mouse Avoidance
 @section Mouse Avoidance
@@ -1261,23 +1139,31 @@
 in the mode line when the frame is selected.
 
 @node Text-Only Mouse
address@hidden Using a Mouse in Terminal Emulators
address@hidden Using a Mouse in Text-only Terminals
 @cindex mouse support
 @cindex terminal emulators, mouse support
 
 Some text-only terminals 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
+  In a terminal emulator which is compatible with @command{xterm}, you
+can use @kbd{M-x xterm-mouse-mode} to give Emacs control over simple
+uses of the mouse---basically, only non-modified single clicks are
+supported.  The normal @command{xterm} mouse functionality for such
 clicks is still available by holding down the @kbd{SHIFT} key when you
 press the mouse button.  Xterm Mouse mode is a global minor mode
 (@pxref{Minor Modes}).  Repeating the command turns the mode off
 again.
 
 @findex gpm-mouse-mode
-In the console on GNU/Linux, you can use @kbd{M-x gpm-mouse-mode} to
-enable terminal mouse support.  You must have the gpm package
-installed and running on your system in order for this to work.
+  In the console on GNU/Linux, you can use @kbd{M-x gpm-mouse-mode} to
+enable mouse support.  You must have the gpm server installed and
+running on your system in order for this to work.
+
address@hidden
address@hidden Mouse,,,emacs-xtra,Specialized Emacs Features},
address@hidden iftex
address@hidden
address@hidden Mouse},
address@hidden ifnottex
+for information about mouse support on MS-DOS.

=== modified file 'doc/emacs/windows.texi'
--- a/doc/emacs/windows.texi    2011-11-21 06:16:49 +0000
+++ b/doc/emacs/windows.texi    2011-11-27 08:22:37 +0000
@@ -385,7 +385,8 @@
 @item
 Otherwise, if you specified that the buffer should be displayed in a
 special frame by customizing @code{special-display-buffer-names} or
address@hidden, do so.  @xref{Special Buffer Frames}.
address@hidden, do so.  @xref{Choosing Window
+Options,,, elisp, The Emacs Lisp Reference Manual}.
 
 @vindex pop-up-frames
 @item