From 7d0a2d305d823c08dbeead135f4b1fc9bde29c61 Mon Sep 17 00:00:00 2001
From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 30 Jun 2006 13:27:10 +0000
Subject: [PATCH] (ls in Lisp, Windows Keyboard, Windows Mouse) (Windows
 Processes, Windows Misc): Shorten the printed version by selectively
 conditioning less important portions by @ifnottex.

---
 man/msdog.texi | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/man/msdog.texi b/man/msdog.texi
index f0def233f1f..565ede38d7c 100644
--- a/man/msdog.texi
+++ b/man/msdog.texi
@@ -175,7 +175,7 @@ default ignores letter-case in file names during completion.
 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.
+features, so use it only on fast machines.
 
 @node ls in Lisp
 @section Emulation of @code{ls} on MS-Windows
@@ -189,8 +189,13 @@ 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.
+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
@@ -274,6 +279,7 @@ restart Emacs, since @file{ls-lisp.el} is preloaded.
 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
@@ -333,6 +339,7 @@ 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}
@@ -359,6 +366,7 @@ instead of the shifted version of they keys.  The default value is
 @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
@@ -398,6 +406,7 @@ users find this frustrating.
 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
@@ -417,6 +426,7 @@ its normal effect: for example, @kbd{@key{Lwindow}} opens the
 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
@@ -433,10 +443,12 @@ 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
@@ -497,6 +509,7 @@ 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
@@ -504,6 +517,7 @@ 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
@@ -655,6 +669,7 @@ printer, put this in your @file{.emacs} file:
 
   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
@@ -667,6 +682,7 @@ click-to-focus policy.
 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