aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2001-06-15 16:30:57 +0000
committerEli Zaretskii2001-06-15 16:30:57 +0000
commit4f09cbeb0fd8acf015f2ff6a76b6664913665867 (patch)
treeb7cb9d15155bd25122f41447665c70d22754e45d
parentd5b49f470f3cfa7dd882f227186f332660435338 (diff)
downloademacs-4f09cbeb0fd8acf015f2ff6a76b6664913665867.tar.gz
emacs-4f09cbeb0fd8acf015f2ff6a76b6664913665867.zip
Proofreading fixes from Art the Lemming <lemming@gimp.shacknet.nu>.
-rw-r--r--man/files.texi60
1 files changed, 30 insertions, 30 deletions
diff --git a/man/files.texi b/man/files.texi
index 1060354ccaf..dd6f7a5fd55 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -6,7 +6,7 @@
6@chapter File Handling 6@chapter File Handling
7@cindex files 7@cindex files
8 8
9 The operating system stores data permanently in named @dfn{files}. So 9 The operating system stores data permanently in named @dfn{files}, so
10most of the text you edit with Emacs comes from a file and is ultimately 10most of the text you edit with Emacs comes from a file and is ultimately
11stored in a file. 11stored in a file.
12 12
@@ -56,7 +56,7 @@ this makes it easy to operate on that file with any of the Emacs file
56commands. 56commands.
57 57
58@vindex default-directory 58@vindex default-directory
59 Each buffer has a default directory, normally the same as the 59 Each buffer has a default directory which is normally the same as the
60directory of the file visited in that buffer. When you enter a file 60directory of the file visited in that buffer. When you enter a file
61name without a directory, the default directory is used. If you specify 61name without a directory, the default directory is used. If you specify
62a directory in a relative fashion, with a name that does not start with 62a directory in a relative fashion, with a name that does not start with
@@ -120,7 +120,7 @@ Variables}.)
120 120
121 To access a file with @samp{$} in its name, type @samp{$$}. This pair 121 To access a file with @samp{$} in its name, type @samp{$$}. This pair
122is converted to a single @samp{$} at the same time as variable 122is converted to a single @samp{$} at the same time as variable
123substitution is performed for single @samp{$}. Alternatively, quote the 123substitution is performed for a single @samp{$}. Alternatively, quote the
124whole file name with @samp{/:} (@pxref{Quoted File Names}). File names 124whole file name with @samp{/:} (@pxref{Quoted File Names}). File names
125which begin with a literal @samp{~} should also be quoted with @samp{/:}. 125which begin with a literal @samp{~} should also be quoted with @samp{/:}.
126 126
@@ -166,7 +166,7 @@ to hold. Emacs constructs the buffer name from the file name by
166throwing away the directory, keeping just the name proper. For example, 166throwing away the directory, keeping just the name proper. For example,
167a file named @file{/usr/rms/emacs.tex} would get a buffer named 167a file named @file{/usr/rms/emacs.tex} would get a buffer named
168@samp{emacs.tex}. If there is already a buffer with that name, a unique 168@samp{emacs.tex}. If there is already a buffer with that name, a unique
169name is constructed by appending @samp{<2>}, @samp{<3>}, or so on, using 169name is constructed by appending @samp{<2>}, @samp{<3>}, and so on, using
170the lowest number that makes a name that is not already in use. 170the lowest number that makes a name that is not already in use.
171 171
172 Each window's mode line shows the name of the buffer that is being displayed 172 Each window's mode line shows the name of the buffer that is being displayed
@@ -218,7 +218,7 @@ message is printed. @xref{Interlocking,,Simultaneous Editing}.
218 Since Emacs reads the visited file in its entirety, files whose size 218 Since Emacs reads the visited file in its entirety, files whose size
219is larger than the maximum Emacs buffer size (@pxref{Buffers}) cannot be 219is larger than the maximum Emacs buffer size (@pxref{Buffers}) cannot be
220visited; if you try, Emacs will print an error message saying that the 220visited; if you try, Emacs will print an error message saying that the
221maximum buffer size is exceeded. 221maximum buffer size has been exceeded.
222 222
223@cindex creating files 223@cindex creating files
224 What if you want to create a new file? Just visit it. Emacs prints 224 What if you want to create a new file? Just visit it. Emacs prints
@@ -233,7 +233,7 @@ carriage-return (used on the Macintosh)---and automatically converts the
233contents to the normal Emacs convention, which is that the newline 233contents to the normal Emacs convention, which is that the newline
234character separates lines. This is a part of the general feature of 234character separates lines. This is a part of the general feature of
235coding system conversion (@pxref{Coding Systems}), and makes it possible 235coding system conversion (@pxref{Coding Systems}), and makes it possible
236to edit files imported from various different operating systems with 236to edit files imported from different operating systems with
237equal convenience. If you change the text and save the file, Emacs 237equal convenience. If you change the text and save the file, Emacs
238performs the inverse conversion, changing newlines back into 238performs the inverse conversion, changing newlines back into
239carriage-return linefeed or just carriage-return if appropriate. 239carriage-return linefeed or just carriage-return if appropriate.
@@ -253,12 +253,12 @@ Archives}, for more about these features.
253 253
254@cindex wildcard characters in file names 254@cindex wildcard characters in file names
255@vindex find-file-wildcards 255@vindex find-file-wildcards
256 If the file name you specify contains shell-style wildcard 256 If the file name you specify contains shell-style wildcard characters,
257characters, Emacs visits all the files that match it. Wildcards 257Emacs visits all the files that match it. Wildcards comprise @samp{?},
258comprise @samp{?}, @samp{*} and @samp{[@dots{}]} sequences. 258@samp{*} and @samp{[@dots{}]} sequences. @xref{Quoted File Names}, for
259@xref{Quoted File Names}, for how to visit a file whose name actually 259information on how to visit a file whose name actually contains wildcard
260contains wildcard characters. You can disable the wildcard feature by 260characters. You can disable the wildcard feature by customizing
261customizing @code{find-file-wildcards}. 261@code{find-file-wildcards}.
262 262
263 If you visit a file that the operating system won't let you modify, 263 If you visit a file that the operating system won't let you modify,
264Emacs makes the buffer read-only, so that you won't go ahead and make 264Emacs makes the buffer read-only, so that you won't go ahead and make
@@ -278,10 +278,10 @@ the file with the command @kbd{C-x C-r} (@code{find-file-read-only}).
278wrong file name), use the @kbd{C-x C-v} command 278wrong file name), use the @kbd{C-x C-v} command
279(@code{find-alternate-file}) to visit the file you really wanted. 279(@code{find-alternate-file}) to visit the file you really wanted.
280@kbd{C-x C-v} is similar to @kbd{C-x C-f}, but it kills the current 280@kbd{C-x C-v} is similar to @kbd{C-x C-f}, but it kills the current
281buffer (after first offering to save it if it is modified). When it 281buffer (after first offering to save it if it is modified). When
282reads the file name to visit, it inserts the entire default file name in 282@kbd{C-x C-v} reads the file name to visit, it inserts the entire
283the buffer, with point just after the directory part; this is convenient 283default file name in the buffer, with point just after the directory
284if you made a slight error in typing the name. 284part; this is convenient if you made a slight error in typing the name.
285 285
286 If you find a file which exists but cannot be read, @kbd{C-x C-f} 286 If you find a file which exists but cannot be read, @kbd{C-x C-f}
287signals an error. 287signals an error.
@@ -488,7 +488,7 @@ value is @code{t}, so that Emacs does write backup files.
488 488
489 For files managed by a version control system (@pxref{Version 489 For files managed by a version control system (@pxref{Version
490Control}), the variable @code{vc-make-backup-files} determines whether 490Control}), the variable @code{vc-make-backup-files} determines whether
491to make backup files. By default, it is @code{nil}, since backup files 491to make backup files. By default it is @code{nil}, since backup files
492are redundant when you store all the previous versions in a version 492are redundant when you store all the previous versions in a version
493control system. @xref{General VC Options}. 493control system. @xref{General VC Options}.
494 494
@@ -516,7 +516,7 @@ the buffer with @kbd{C-u C-x C-s}, the version thus saved will be made
516into a backup file if you save the buffer again. @kbd{C-u C-u C-x C-s} 516into a backup file if you save the buffer again. @kbd{C-u C-u C-x C-s}
517saves the buffer, but first makes the previous file contents into a new 517saves the buffer, but first makes the previous file contents into a new
518backup file. @kbd{C-u C-u C-u C-x C-s} does both things: it makes a 518backup file. @kbd{C-u C-u C-u C-x C-s} does both things: it makes a
519backup from the previous contents, and arranges to make another from the 519backup from the previous contents and arranges to make another from the
520newly saved contents, if you save again. 520newly saved contents, if you save again.
521 521
522@menu 522@menu
@@ -605,7 +605,7 @@ time a new backup is made.
605@vindex kept-new-versions 605@vindex kept-new-versions
606 The two variables @code{kept-old-versions} and 606 The two variables @code{kept-old-versions} and
607@code{kept-new-versions} control this deletion. Their values are, 607@code{kept-new-versions} control this deletion. Their values are,
608respectively the number of oldest (lowest-numbered) backups to keep and 608respectively, the number of oldest (lowest-numbered) backups to keep and
609the number of newest (highest-numbered) ones to keep, each time a new 609the number of newest (highest-numbered) ones to keep, each time a new
610backup is made. Recall that these values are used just after a new 610backup is made. Recall that these values are used just after a new
611backup version is made; that newly made backup is included in the count 611backup version is made; that newly made backup is included in the count
@@ -660,7 +660,7 @@ change. @code{backup-by-copying-when-mismatch} is @code{t} by default
660if you start Emacs as the superuser. The fourth variable, 660if you start Emacs as the superuser. The fourth variable,
661@code{backup-by-copying-when-privileged-mismatch}, gives the highest 661@code{backup-by-copying-when-privileged-mismatch}, gives the highest
662numeric user-id for which @code{backup-by-copying-when-mismatch} will be 662numeric user-id for which @code{backup-by-copying-when-mismatch} will be
663forced on. This is useful when low-numbered user-id are assigned to 663forced on. This is useful when low-numbered user-ids are assigned to
664special system users, such as @code{root}, @code{bin}, @code{daemon}, 664special system users, such as @code{root}, @code{bin}, @code{daemon},
665etc., which must maintain ownership of files. 665etc., which must maintain ownership of files.
666 666
@@ -805,7 +805,7 @@ shadow-define-cluster}.
805@cindex modification dates 805@cindex modification dates
806@cindex locale, date format 806@cindex locale, date format
807 807
808You can arrange put a time stamp in a file, so that it will be updated 808You can arrange to put a time stamp in a file, so that it will be updated
809automatically each time you edit and save the file. The time stamp 809automatically each time you edit and save the file. The time stamp
810has to be in the first eight lines of the file, and you should 810has to be in the first eight lines of the file, and you should
811insert it like this: 811insert it like this:
@@ -1813,9 +1813,9 @@ This is the common way to pick up recent changes from the repository,
1813regardless of whether you have already changed the file yourself. 1813regardless of whether you have already changed the file yourself.
1814 1814
1815 You can also enter a branch number or a pair of version numbers in 1815 You can also enter a branch number or a pair of version numbers in
1816the minibuffer. Then it finds the changes from that branch, or between 1816the minibuffer. Then @kbd{C-x v m} finds the changes from that branch,
1817the two versions you specified, and merges them into the current version 1817or between the two versions you specified, and merges them into the
1818of the current file. 1818current version of the current file.
1819 1819
1820 As an example, suppose that you have finished a certain feature on 1820 As an example, suppose that you have finished a certain feature on
1821branch 1.3.1. In the meantime, development on the trunk has proceeded 1821branch 1.3.1. In the meantime, development on the trunk has proceeded
@@ -1989,12 +1989,12 @@ prefix argument, and specify RCS as the back end.)
1989You can do this at any time; it does not matter whether you have 1989You can do this at any time; it does not matter whether you have
1990already modified the file with respect to the version in the CVS 1990already modified the file with respect to the version in the CVS
1991repository. If possible, VC tries to make the RCS master start with 1991repository. If possible, VC tries to make the RCS master start with
1992the unmodified repository version, then checking in any local changes 1992the unmodified repository version, then checks in any local changes
1993as a new version. This works if you have not made any changes yet, or 1993as a new version. This works if you have not made any changes yet, or
1994if the unmodified repository version exists locally as a version 1994if the unmodified repository version exists locally as a version
1995backup (@pxref{Version Backups}). If the unmodified version is not 1995backup (@pxref{Version Backups}). If the unmodified version is not
1996available locally, the RCS master starts with the modified version; 1996available locally, the RCS master starts with the modified version;
1997the only drawback of this is that you cannot compare your changes 1997the only drawback to this is that you cannot compare your changes
1998locally to what is stored in the repository. 1998locally to what is stored in the repository.
1999 1999
2000The version number of the RCS master is derived from the current CVS 2000The version number of the RCS master is derived from the current CVS
@@ -2137,7 +2137,7 @@ RCS and SCCS to explain how to update the snapshots by hand.
2137 2137
2138 Using @code{vc-rename-file} makes the snapshot remain valid for 2138 Using @code{vc-rename-file} makes the snapshot remain valid for
2139retrieval, but it does not solve all problems. For example, some of the 2139retrieval, but it does not solve all problems. For example, some of the
2140files in the program probably refer to others by name. At the very 2140files in your program probably refer to others by name. At the very
2141least, the makefile probably mentions the file that you renamed. If you 2141least, the makefile probably mentions the file that you renamed. If you
2142retrieve an old snapshot, the renamed file is retrieved under its new 2142retrieve an old snapshot, the renamed file is retrieved under its new
2143name, which is not the name that the makefile expects. So the program 2143name, which is not the name that the makefile expects. So the program
@@ -2206,7 +2206,7 @@ messages that start with `#'.}. Then @kbd{C-x v a} visits
2206@noindent 2206@noindent
2207You can then edit the new change log entry further as you wish. 2207You can then edit the new change log entry further as you wish.
2208 2208
2209 Some of the new change log entry may duplicate what's already in 2209 Some of the new change log entries may duplicate what's already in
2210ChangeLog. You will have to remove these duplicates by hand. 2210ChangeLog. You will have to remove these duplicates by hand.
2211 2211
2212 Normally, the log entry for file @file{foo} is displayed as @samp{* 2212 Normally, the log entry for file @file{foo} is displayed as @samp{*
@@ -2767,8 +2767,8 @@ the old contents of the file @var{new}.
2767 2767
2768@findex make-symbolic-link 2768@findex make-symbolic-link
2769 @kbd{M-x make-symbolic-link} reads two file names @var{target} and 2769 @kbd{M-x make-symbolic-link} reads two file names @var{target} and
2770@var{linkname}, then creates a symbolic link named @var{linkname} and 2770@var{linkname}, then creates a symbolic link named @var{linkname}, which
2771pointing at @var{target}. The effect is that future attempts to open file 2771points at @var{target}. The effect is that future attempts to open file
2772@var{linkname} will refer to whatever file is named @var{target} at the 2772@var{linkname} will refer to whatever file is named @var{target} at the
2773time the opening is done, or will get an error if the name @var{target} is 2773time the opening is done, or will get an error if the name @var{target} is
2774not in use at that time. This command does not expand the argument 2774not in use at that time. This command does not expand the argument