changeset 28327:f7b17a6af3db

(Visiting): List wildcard chars. Mention find-file-wildcards. (File Archives): Archiving programs _are_ needed (but not tar). (Remote Files): Xref quoted file names. (Quoted File Names): Can quote * as [*].

--- a/man/files.texi	Sun Mar 26 17:51:09 2000 +0000
+++ b/man/files.texi	Sun Mar 26 17:56:47 2000 +0000
@@ -220,9 +220,14 @@
 variable @code{find-file-run-dired} is @code{nil}, then it is an error
 to try to visit a directory.
 
-  If the file name you specify contains wildcard characters, Emacs
-visits all the files that match it.  @xref{Quoted File Names}, if you
-want to visit a file whose name actually contains wildcard characters.
+@cindex wildcard characters in file names
+@vindex find-file-wildcards
+  If the file name you specify contains @code{sh}-style wildcard
+characters, Emacs visits all the files that match it.  @xref{Quoted File
+Names}, if you want to visit a file whose name actually contains
+wildcard characters.  Wildcards comprise @samp{?}, @samp{*} and
+@samp{[@dots{}]} sequences.  The wildcard feature can be disabled by
+customizing @code{find-file-wildcards}.
 
   If you visit a file that the operating system won't let you modify,
 Emacs makes the buffer read-only, so that you won't go ahead and make
@@ -2402,6 +2407,9 @@
 mode will be used also for compressed archives in files with extensions
 @samp{.tgz}, @code{.tar.Z} and @code{.tar.gz}.
 
+It is not necessary to have the @code{tar} program available to use Tar
+mode or Archive mode---Emacs reads the archives directly.
+
 @cindex @code{arc}
 @cindex @code{jar}
 @cindex @code{zip}
@@ -2421,8 +2429,9 @@
 class archives with extension @samp{.jar} are also recognized.  The
 keybindings in Archive mode are similar to those in Tar mode.
 
-It is not necessary to have the archiving programs installed to use Tar
-mode or Archive mode---Emacs reads the archives directly.
+Unlike Tar mode, Archive mode runs the appropriate program to unpack and
+repack archives.  Details of the program names and their options can be
+set in the `Archive' Customize group.
 
 @node Remote Files
 @section Remote Files
@@ -2458,7 +2467,9 @@
   You can entirely turn off the FTP file name feature by removing the
 entries @var{ange-ftp-completion-hook-function} and
 @var{ange-ftp-hook-function} from the variable
-@code{file-name-handler-alist}.
+@code{file-name-handler-alist}.  You can turn off the feature in
+individual cases by quoting the file name with @samp{/:} (@pxref{Quoted
+File Names}).
 
 @node Quoted File Names
 @section Quoted File Names
@@ -2481,10 +2492,11 @@
 a file name that contains @samp{$}.  However, the @samp{/:} must be at
 the beginning of the buffer in order to quote @samp{$}.
 
+@cindex wildcard characters in file names
   You can also quote wildcard characters with @samp{/:}, for visiting.
 For example, @file{/:/tmp/foo*bar} visits the file @file{/tmp/foo*bar}.
 However, in most cases you can simply type the wildcard characters for
 themselves.  For example, if the only file name in @file{/tmp} that
 starts with @samp{foo} and ends with @samp{bar} is @file{foo*bar}, then
 specifying @file{/tmp/foo*bar} will visit just @file{/tmp/foo*bar}.
-
+Another way is to specify @file{/tmp/foo[*]bar}.