[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/msdog.texi,v
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] Changes to emacs/man/msdog.texi,v |
Date: |
Sat, 24 Jun 2006 15:08:45 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Eli Zaretskii <eliz> 06/06/24 15:08:45
Index: msdog.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/msdog.texi,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -b -r1.51 -r1.52
--- msdog.texi 20 May 2006 18:56:22 -0000 1.51
+++ msdog.texi 24 Jun 2006 15:08:44 -0000 1.52
@@ -29,6 +29,7 @@
@menu
* Text and Binary:: Text files use CRLF to terminate lines.
* Windows Files:: File-name conventions on Windows.
+* ls in Lisp:: Emulation of @code{ls} for Dired.
* Windows HOME:: Where Emacs looks for your @file{.emacs}.
* Windows Processes:: Running subprocesses on Windows.
* Windows Printing:: How to specify the printer on MS-Windows.
@@ -167,6 +168,104 @@
On MS-DOS/MS-Windows, file names are case-insensitive, so Emacs by
default ignores letter-case in file names during completion.
address@hidden ls in Lisp
address@hidden Emulation of @code{ls} on MS-Windows
address@hidden Dired, and MS-Windows/MS-DOS
address@hidden @code{ls} emulation
+
+ Dired normally uses the external program @code{ls} (or its close
+work-alike) to produce the directory listing displayed in Dired
+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}
address@hidden in Lisp, by using the @file{ls-lisp.el} package. While
address@hidden 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},
address@hidden, @option{-i}, @option{-G}, @option{-g}, @option{-R},
address@hidden, @option{-S}, @option{-s}, @option{-t}, @option{-U},
address@hidden, and @option{-X}. The @option{-F} switch is partially
+supported (it appends the character that classifies the file, but does
+not prevent symlink following).
+
address@hidden ls-lisp-use-insert-directory-program
+ On MS-Windows and MS-DOS, @file{ls-lisp.el} is preloaded when Emacs
+is built, so the Lisp emulation of @code{ls} is always used on those
+platforms. If you have a ported @code{ls}, setting
address@hidden to a address@hidden value
+will revert to using an external program named by the variable
address@hidden
+
address@hidden ls-lisp-ignore-case
+ By default, @file{ls-lisp.el} uses a case-sensitive sort order for
+the directory listing it produces; this is so the listing looks the
+same as on other platforms. If you wish that the files be sorted in
+case-insensitive order, set the variable @code{ls-lisp-ignore-case} to
+a address@hidden value.
+
address@hidden ls-lisp-dirs-first
+ By default, files and subdirectories are sorted together, to emulate
+the behavior of @code{ls}. However, native MS-Windows/MS-DOS file
+managers list the directories before the files; if you want that
+behavior, customize the option @code{ls-lisp-dirs-first} to a
address@hidden value.
+
address@hidden ls-lisp-verbosity
+ The variable @code{ls-lisp-verbosity} controls the file attributes
+that @file{ls-lisp.el} displays. The value should be a list that
+contains one or more of the symbols @code{links}, @code{uid}, and
address@hidden @code{links} means display the count of different file
+names that are associated with (a.k.a.@: @dfn{links to}) the file's
+data. @code{uid} means display the numerical identifier of the user
+who owns the file. @code{gid} means display the numerical identifier
+of the file owner's group. The default value is @code{(links uid gid)}
+i.e.@: all the 3 optional attributes are displayed.
+
address@hidden ls-lisp-emulation
+ The variable @code{ls-lisp-emulation} controls the flavour of the
address@hidden emulation by setting the defaults for the 3 options
+described above: @code{ls-lisp-ignore-case},
address@hidden, and @code{ls-lisp-verbosity}. The value of
+this option can be one of the following symbols:
+
address@hidden @code
address@hidden GNU
address@hidden nil
+Emulate @sc{gnu} systems; this is the default. This sets
address@hidden and @code{ls-lisp-dirs-first} to
address@hidden, and @code{ls-lisp-verbosity} to @code{(links uid gid)}.
address@hidden UNIX
+Emulate Unix systems. Like @code{GNU}, but sets
address@hidden to @code{(links uid)}.
address@hidden MacOS
+Emulate MacOS. Sets @code{ls-lisp-ignore-case} to @code{t}, and
address@hidden and @code{ls-lisp-verbosity} to @code{nil}.
address@hidden MS-Windows
+Emulate MS-Windows. Sets @code{ls-lisp-ignore-case} and
address@hidden to @code{t}, and @code{ls-lisp-verbosity} to
address@hidden(links)} on Windows NT/2K/XP/2K3 and to @code{nil} on Windows 9X.
+Note that the default emulation is @emph{not} @code{MS-Windows}, even
+on Windows, since many users of Emacs on those platforms prefer the
address@hidden defaults.
address@hidden table
+
address@hidden
+Any other value of @code{ls-lisp-emulation} means the same as
address@hidden Note that this option needs to be set @emph{before}
address@hidden is loaded, which means that on MS-Windows and MS-DOS
+you will have to set the value from your @file{.emacs} file and then
+restart Emacs, since @file{ls-lisp.el} is preloaded.
+
address@hidden ls-lisp-support-shell-wildcards
+ The variable @code{ls-lisp-support-shell-wildcards} controls how
+file-name patterns are supported: if it is address@hidden (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
- [Emacs-diffs] Changes to emacs/man/msdog.texi,v,
Eli Zaretskii <=
- [Emacs-diffs] Changes to emacs/man/msdog.texi,v, Eli Zaretskii, 2006/06/24
- [Emacs-diffs] Changes to emacs/man/msdog.texi,v, Eli Zaretskii, 2006/06/24
- [Emacs-diffs] Changes to emacs/man/msdog.texi,v, Eli Zaretskii, 2006/06/24
- [Emacs-diffs] Changes to emacs/man/msdog.texi,v, Eli Zaretskii, 2006/06/30