comparison man/msdog.texi @ 71544:70062eaec923

(ls in Lisp, Windows Keyboard, Windows Mouse) (Windows Processes, Windows Misc): Shorten the printed version by selectively conditioning less important portions by @ifnottex.

71543:e3e199f38bf7

@vindex w32-get-true-file-attributes
  If the variable @code{w32-get-true-file-attributes} is
non-@code{nil} (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
@cindex @code{ls} emulation

buffers (@pxref{Dired}).  However, MS-Windows and MS-DOS systems don't
come with such a program, although several ports of @sc{gnu} @code{ls}
are available.  Therefore, Emacs on those systems @emph{emulates}
@code{ls} in Lisp, by using the @file{ls-lisp.el} package.  While
@file{ls-lisp.el} provides a reasonably full emulation of @code{ls},
there are some options and features peculiar to that emulation; they
are described in this section.

  The @code{ls} emulation supports many of the @code{ls} switches, but
it doesn't support all of them.  Here's the list of the switches it
does support: @option{-A}, @option{-a}, @option{-B}, @option{-C},
@option{-c}, @option{-i}, @option{-G}, @option{-g}, @option{-R},

@vindex ls-lisp-support-shell-wildcards
  The variable @code{ls-lisp-support-shell-wildcards} controls how
file-name patterns are supported: if it is non-@code{nil} (the
default), they are treated as shell-style wildcards; otherwise they
are treated as Emacs regular expressions.

@node Windows HOME
@section HOME Directory on MS-Windows
@cindex @code{HOME} directory on MS-Windows

  The @key{F10} key on Windows activates the menu bar in a way that
makes it possible to use the menus without a mouse.  In this mode, the
arrow keys traverse the menus, @key{RET} selects a highlighted menu
item, and @key{ESC} closes the menu.

@vindex w32-alt-is-meta
@cindex @code{Alt} key (MS-Windows)
  By default, the key labeled @key{Alt} is mapped as the @key{META}
key.  If you wish it to produce the @code{Alt} modifier instead, set
the variable @code{w32-alt-is-meta} to a @code{nil} value.

@cindex keypad keys (MS-Windows)
  Similarly, if @code{w32-enable-num-lock} is @code{nil}, the
@key{NumLock} key will produce the symbol @code{kp-numlock}.  The
default is @code{t}, which causes @key{NumLock} to work as expected:
toggle the meaning of the keys on the numeric keypad.

@vindex w32-apps-modifier
  The variable @code{w32-apps-modifier} controls the effect of the
@key{Apps} key (usually located between the right @key{Alt} and the
right @key{Ctrl} keys).  Its value can be one of the symbols

  You can re-enable Windows' default handling of tapping the @key{ALT}
key by setting @code{w32-pass-alt-to-system} to a non-@code{nil}
value.

@vindex w32-pass-lwindow-to-system
@vindex w32-pass-rwindow-to-system
  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

  The variable @code{w32-recognize-altgr} controls whether the right
@key{Alt} and left @key{Ctrl} keys are recognized as the @key{AltGr}
key.  The default is @code{t}, which means these keys produce
@code{AltGr}; setting them to @code{nil} causes these keys to be
interpreted normally (as the respective modifiers).

@node Windows Mouse
@section Mouse Usage on MS-Windows
@cindex mouse, and MS-Windows

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.

@vindex w32-pass-extra-mouse-buttons-to-system
  If the variable @code{w32-pass-extra-mouse-buttons-to-system} is
non-@code{nil}, Emacs passes the fourth and fifth mouse buttons to
Windows.

@vindex 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
@code{nil} (the default), the middle button generates @kbd{mouse-2}

@code{Shutdown} command on the @code{Start} menu; that usually hangs the
system.  Instead, type @kbd{CTL-ALT-@key{DEL}} and then choose
@code{Shutdown}.  That usually works, although it may take a few minutes
to do its job.

@vindex w32-quote-process-args
  The variable @code{w32-quote-process-args} controls how the process
arguments are quoted.  If it is non-@code{nil} 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

  Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and

@node Windows Misc
@section Miscellaneous Windows-specific features

  This section describes miscellaneous Windows-specific features.

@vindex w32-grab-focus-on-raise
@cindex frame focus policy, MS-Windows
  The variable @code{w32-grab-focus-on-raise}, if set to a
non-@code{nil} value causes a frame to grab focus when it is raised.
The default is @code{t}, which fits well with the Windows default

@vindex 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 non-@code{nil}, these fonts will be included.  The default is
@code{nil}.

@vindex w32-use-visible-system-caret
@cindex 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

71544:70062eaec923

@vindex w32-get-true-file-attributes
  If the variable @code{w32-get-true-file-attributes} is
non-@code{nil} (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, so use it only on fast machines.

@node ls in Lisp
@section Emulation of @code{ls} on MS-Windows
@cindex Dired, and MS-Windows/MS-DOS
@cindex @code{ls} emulation

buffers (@pxref{Dired}).  However, MS-Windows and MS-DOS systems don't
come with such a program, although several ports of @sc{gnu} @code{ls}
are available.  Therefore, Emacs on those systems @emph{emulates}
@code{ls} in Lisp, by using the @file{ls-lisp.el} package.  While
@file{ls-lisp.el} provides a reasonably full emulation of @code{ls},
there are some options and features peculiar to that emulation;
@iftex
for more details, see the documentation of the variables whose names
begin with @code{ls-lisp}.
@end iftex
@ifnottex
they are described in this section.

  The @code{ls} emulation supports many of the @code{ls} switches, but
it doesn't support all of them.  Here's the list of the switches it
does support: @option{-A}, @option{-a}, @option{-B}, @option{-C},
@option{-c}, @option{-i}, @option{-G}, @option{-g}, @option{-R},

@vindex ls-lisp-support-shell-wildcards
  The variable @code{ls-lisp-support-shell-wildcards} controls how
file-name patterns are supported: if it is non-@code{nil} (the
default), they are treated as shell-style wildcards; otherwise they
are treated as Emacs regular expressions.
@end ifnottex

@node Windows HOME
@section HOME Directory on MS-Windows
@cindex @code{HOME} directory on MS-Windows

  The @key{F10} key on Windows activates the menu bar in a way that
makes it possible to use the menus without a mouse.  In this mode, the
arrow keys traverse the menus, @key{RET} selects a highlighted menu
item, and @key{ESC} closes the menu.

@ifnottex
@vindex w32-alt-is-meta
@cindex @code{Alt} key (MS-Windows)
  By default, the key labeled @key{Alt} is mapped as the @key{META}
key.  If you wish it to produce the @code{Alt} modifier instead, set
the variable @code{w32-alt-is-meta} to a @code{nil} value.

@cindex keypad keys (MS-Windows)
  Similarly, if @code{w32-enable-num-lock} is @code{nil}, the
@key{NumLock} key will produce the symbol @code{kp-numlock}.  The
default is @code{t}, which causes @key{NumLock} to work as expected:
toggle the meaning of the keys on the numeric keypad.
@end ifnottex

@vindex w32-apps-modifier
  The variable @code{w32-apps-modifier} controls the effect of the
@key{Apps} key (usually located between the right @key{Alt} and the
right @key{Ctrl} keys).  Its value can be one of the symbols

  You can re-enable Windows' default handling of tapping the @key{ALT}
key by setting @code{w32-pass-alt-to-system} to a non-@code{nil}
value.

@ifnottex
@vindex w32-pass-lwindow-to-system
@vindex w32-pass-rwindow-to-system
  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

  The variable @code{w32-recognize-altgr} controls whether the right
@key{Alt} and left @key{Ctrl} keys are recognized as the @key{AltGr}
key.  The default is @code{t}, which means these keys produce
@code{AltGr}; setting them to @code{nil} causes these keys to be
interpreted normally (as the respective modifiers).
@end ifnottex

@node Windows Mouse
@section Mouse Usage on MS-Windows
@cindex mouse, and MS-Windows

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.

@ifnottex
@vindex w32-pass-extra-mouse-buttons-to-system
  If the variable @code{w32-pass-extra-mouse-buttons-to-system} is
non-@code{nil}, Emacs passes the fourth and fifth mouse buttons to
Windows.
@end ifnottex

@vindex 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
@code{nil} (the default), the middle button generates @kbd{mouse-2}

@code{Shutdown} command on the @code{Start} menu; that usually hangs the
system.  Instead, type @kbd{CTL-ALT-@key{DEL}} and then choose
@code{Shutdown}.  That usually works, although it may take a few minutes
to do its job.

@ifnottex
@vindex w32-quote-process-args
  The variable @code{w32-quote-process-args} controls how the process
arguments are quoted.  If it is non-@code{nil} 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.
@end ifnottex

@node Windows Printing
@section Printing and MS-Windows

  Printing commands, such as @code{lpr-buffer} (@pxref{Printing}) and

@node Windows Misc
@section Miscellaneous Windows-specific features

  This section describes miscellaneous Windows-specific features.

@ifnottex
@vindex w32-grab-focus-on-raise
@cindex frame focus policy, MS-Windows
  The variable @code{w32-grab-focus-on-raise}, if set to a
non-@code{nil} value causes a frame to grab focus when it is raised.
The default is @code{t}, which fits well with the Windows default

@vindex 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 non-@code{nil}, these fonts will be included.  The default is
@code{nil}.
@end ifnottex

@vindex w32-use-visible-system-caret
@cindex 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