[Emacs-diffs] Changes to emacs/man/msdog.texi,v

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    06/06/24 17:22:48

Index: msdog.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/msdog.texi,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -b -r1.54 -r1.55
--- msdog.texi  24 Jun 2006 16:21:41 -0000      1.54
+++ msdog.texi  24 Jun 2006 17:22:48 -0000      1.55
@@ -32,9 +32,10 @@
 * ls in Lisp::          Emulation of @code{ls} for Dired.
 * Windows HOME::        Where Emacs looks for your @file{.emacs}.
 * Windows Keyboard::    Windows-specific keyboard features.
+* Windows Mouse::       Windows-specific mouse features.
 * Windows Processes::   Running subprocesses on Windows.
 * Windows Printing::    How to specify the printer on MS-Windows.
-* Windows System Menu:: Controlling what the ALT key does.
+* Windows Misc::        Miscellaneous Windows features.
 @ifnottex
 * MS-DOS::              Using Emacs on MS-DOS (otherwise known as 
@dfn{MS-DOG}).
 @end ifnottex
@@ -169,6 +170,13 @@
   On MS-DOS/MS-Windows, file names are case-insensitive, so Emacs by
 default ignores letter-case in file names during completion.
 
address@hidden w32-get-true-file-attributes
+  If the variable @code{w32-get-true-file-attributes} is
address@hidden (the default), Emacs tries to determine the accurate
+link counts for files.  This option is only useful on the NT family of
+Windows (2K/XP/2K3), and it considerably slows down Dired and other
+features.
+
 @node ls in Lisp
 @section Emulation of @code{ls} on MS-Windows
 @cindex Dired, and MS-Windows/MS-DOS
@@ -376,18 +384,30 @@
 produces the symbol @code{scroll}.
 
 @vindex w32-pass-alt-to-system
address@hidden Windows system menu
address@hidden @code{Alt} key invokes menu (Windows)
+  Emacs compiled as a native Windows application normally turns off
+the Windows feature that tapping the @key{ALT} key invokes the Windows
+menu.  The reason is that the @key{ALT} serves as @key{META} in Emacs.
+When using Emacs, users often press the @key{META} key temporarily and
+then change their minds; if this has the effect of bringing up the
+Windows menu, it alters the meaning of subsequent commands.  Many
+users find this frustrating.
+
+  You can re-enable Windows' default handling of tapping the @key{ALT}
+key by setting @code{w32-pass-alt-to-system} to a address@hidden
+value.
+
 @vindex w32-pass-lwindow-to-system
 @vindex w32-pass-rwindow-to-system
-  The variables @code{w32-pass-alt-to-system},
address@hidden, and
+  The variables @code{w32-pass-lwindow-to-system} and
 @code{w32-pass-rwindow-to-system} determine whether the respective
 keys are passed to Windows or swallowed by Emacs.  If the value is
 @code{nil}, the respective key is silently swallowed by Emacs,
-otherwise it is passed to Windows.  The default is @code{nil} for
address@hidden and @code{t} for the other two
-variables.  Passing each of these keys to Windows produces its normal
-effect: for example, @address@hidden @key{SPC}} opens the @code{System}
-menu, @address@hidden opens the @code{Start} menu, etc.
+otherwise it is passed to Windows.  The default is @code{t} for both
+of these variables.  Passing each of these keys to Windows produces
+its normal effect: for example, @address@hidden opens the
address@hidden menu, etc.
 
 @vindex w32-recognize-altgr
 @kindex AltGr @r{(MS-Windows)}
@@ -398,6 +418,32 @@
 @code{AltGr}; setting them to @code{nil} causes these keys to be
 interpreted normally (as the respective modifiers).
 
address@hidden Windows Mouse
address@hidden Mouse Usage on MS-Windows
address@hidden mouse, and MS-Windows
+
+  This section describes the Windows-specific variables related to
+mouse.
+
address@hidden w32-mouse-button-tolerance
address@hidden simulation of middle mouse button
+  The variable @code{w32-mouse-button-tolerance} specifies the
+time interval, in milliseconds, for faking middle mouse button press
+on 2-button mice.  If both mouse buttons are depressed within this
+time interval, Emacs generates a middle mouse button click event
+instead of a double click on one of the buttons.
+
address@hidden w32-pass-extra-mouse-buttons-to-system
+  If the variable @code{w32-pass-extra-mouse-buttons-to-system} is
address@hidden, Emacs passes the fourth and fifth mouse buttons to
+Windows.
+
address@hidden w32-swap-mouse-buttons
+  The variable @code{w32-swap-mouse-buttons} controls which of the 3
+mouse buttons generates the @kbd{mouse-2} events.  When it is
address@hidden (the default), the middle button generates @kbd{mouse-2}
+and the right button generates @kbd{mouse-3} events.  If this variable
+is address@hidden, the roles of these two buttons are reversed.
 
 @node Windows Processes
 @section Subprocesses on Windows 9X/ME and Windows NT/2K/XP
@@ -451,6 +497,14 @@
 @code{Shutdown}.  That usually works, although it may take a few minutes
 to do its job.
 
address@hidden w32-quote-process-args
+  The variable @code{w32-quote-process-args} controls how the process
+arguments are quoted.  If it is address@hidden means they are quoted
+with the @code{"} character.  If the value is a character, that
+character will be used to escape any quote characters that appear;
+otherwise a suitable escape character will be chosen based on the type
+of the program.
+
 @node Windows Printing
 @section Printing and MS-Windows
 
@@ -596,21 +650,33 @@
 (This assumes that Ghostscript is installed in the
 @file{D:/gs6.01} directory.)
 
address@hidden Windows System Menu
address@hidden Using the System Menu on Windows
address@hidden @code{Alt} key invokes menu (Windows)
address@hidden Windows Misc
address@hidden Miscellaneous Windows-specific features
 
-Emacs compiled as a native Windows application normally turns off the
-Windows feature that tapping the @key{ALT} key invokes the Windows
-menu.  The reason is that the @key{ALT} serves as @key{META} in Emacs.
-When using Emacs, users often press the @key{META} key temporarily and
-then change their minds; if this has the effect of bringing up the
-Windows menu, it alters the meaning of subsequent commands.  Many
-users find this frustrating.
+  This section describes miscellaneous Windows-specific features.
 
address@hidden w32-pass-alt-to-system
-You can re-enable Windows' default handling of tapping the @key{ALT} key
-by setting @code{w32-pass-alt-to-system} to a address@hidden value.
address@hidden w32-grab-focus-on-raise
address@hidden frame focus policy, MS-Windows
+  The variable @code{w32-grab-focus-on-raise}, if set to a
address@hidden value causes a frame to grab focus when it is raised.
+The default is @code{t}, which fits well with the Windows default
+click-to-focus policy.
+
address@hidden w32-list-proportional-fonts
+  The variable @code{w32-list-proportional-fonts} controls whether
+proportional fonts are included in the font selection dialog.  If its
+value is address@hidden, these fonts will be included.  The default is
address@hidden
+
address@hidden w32-use-visible-system-caret
address@hidden screen reader software, MS-Windows
+  The variable @code{w32-use-visible-system-caret} is a flag that
+determines whether to make the system caret visible.  The default is
address@hidden, which means Emacs draws its own cursor to indicate the
+position of point.  A address@hidden value means Emacs will indicate
+point location by the system caret; this facilitates use of screen
+reader software.  When this variable is address@hidden, other
+variables affecting the cursor display have no effect.
 
 @ifnottex
 @include msdog-xtra.texi