diff options
| author | Eli Zaretskii | 2001-06-15 16:30:57 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2001-06-15 16:30:57 +0000 |
| commit | 4f09cbeb0fd8acf015f2ff6a76b6664913665867 (patch) | |
| tree | b7cb9d15155bd25122f41447665c70d22754e45d | |
| parent | d5b49f470f3cfa7dd882f227186f332660435338 (diff) | |
| download | emacs-4f09cbeb0fd8acf015f2ff6a76b6664913665867.tar.gz emacs-4f09cbeb0fd8acf015f2ff6a76b6664913665867.zip | |
Proofreading fixes from Art the Lemming <lemming@gimp.shacknet.nu>.
| -rw-r--r-- | man/files.texi | 60 |
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 |
| 10 | most of the text you edit with Emacs comes from a file and is ultimately | 10 | most of the text you edit with Emacs comes from a file and is ultimately |
| 11 | stored in a file. | 11 | stored in a file. |
| 12 | 12 | ||
| @@ -56,7 +56,7 @@ this makes it easy to operate on that file with any of the Emacs file | |||
| 56 | commands. | 56 | commands. |
| 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 |
| 60 | directory of the file visited in that buffer. When you enter a file | 60 | directory of the file visited in that buffer. When you enter a file |
| 61 | name without a directory, the default directory is used. If you specify | 61 | name without a directory, the default directory is used. If you specify |
| 62 | a directory in a relative fashion, with a name that does not start with | 62 | a 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 |
| 122 | is converted to a single @samp{$} at the same time as variable | 122 | is converted to a single @samp{$} at the same time as variable |
| 123 | substitution is performed for single @samp{$}. Alternatively, quote the | 123 | substitution is performed for a single @samp{$}. Alternatively, quote the |
| 124 | whole file name with @samp{/:} (@pxref{Quoted File Names}). File names | 124 | whole file name with @samp{/:} (@pxref{Quoted File Names}). File names |
| 125 | which begin with a literal @samp{~} should also be quoted with @samp{/:}. | 125 | which 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 | |||
| 166 | throwing away the directory, keeping just the name proper. For example, | 166 | throwing away the directory, keeping just the name proper. For example, |
| 167 | a file named @file{/usr/rms/emacs.tex} would get a buffer named | 167 | a 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 |
| 169 | name is constructed by appending @samp{<2>}, @samp{<3>}, or so on, using | 169 | name is constructed by appending @samp{<2>}, @samp{<3>}, and so on, using |
| 170 | the lowest number that makes a name that is not already in use. | 170 | the 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 |
| 219 | is larger than the maximum Emacs buffer size (@pxref{Buffers}) cannot be | 219 | is larger than the maximum Emacs buffer size (@pxref{Buffers}) cannot be |
| 220 | visited; if you try, Emacs will print an error message saying that the | 220 | visited; if you try, Emacs will print an error message saying that the |
| 221 | maximum buffer size is exceeded. | 221 | maximum 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 | |||
| 233 | contents to the normal Emacs convention, which is that the newline | 233 | contents to the normal Emacs convention, which is that the newline |
| 234 | character separates lines. This is a part of the general feature of | 234 | character separates lines. This is a part of the general feature of |
| 235 | coding system conversion (@pxref{Coding Systems}), and makes it possible | 235 | coding system conversion (@pxref{Coding Systems}), and makes it possible |
| 236 | to edit files imported from various different operating systems with | 236 | to edit files imported from different operating systems with |
| 237 | equal convenience. If you change the text and save the file, Emacs | 237 | equal convenience. If you change the text and save the file, Emacs |
| 238 | performs the inverse conversion, changing newlines back into | 238 | performs the inverse conversion, changing newlines back into |
| 239 | carriage-return linefeed or just carriage-return if appropriate. | 239 | carriage-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, |
| 257 | characters, Emacs visits all the files that match it. Wildcards | 257 | Emacs visits all the files that match it. Wildcards comprise @samp{?}, |
| 258 | comprise @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 | 259 | information on how to visit a file whose name actually contains wildcard |
| 260 | contains wildcard characters. You can disable the wildcard feature by | 260 | characters. You can disable the wildcard feature by customizing |
| 261 | customizing @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, |
| 264 | Emacs makes the buffer read-only, so that you won't go ahead and make | 264 | Emacs 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}). | |||
| 278 | wrong file name), use the @kbd{C-x C-v} command | 278 | wrong 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 |
| 281 | buffer (after first offering to save it if it is modified). When it | 281 | buffer (after first offering to save it if it is modified). When |
| 282 | reads 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 |
| 283 | the buffer, with point just after the directory part; this is convenient | 283 | default file name in the buffer, with point just after the directory |
| 284 | if you made a slight error in typing the name. | 284 | part; 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} |
| 287 | signals an error. | 287 | signals 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 |
| 490 | Control}), the variable @code{vc-make-backup-files} determines whether | 490 | Control}), the variable @code{vc-make-backup-files} determines whether |
| 491 | to make backup files. By default, it is @code{nil}, since backup files | 491 | to make backup files. By default it is @code{nil}, since backup files |
| 492 | are redundant when you store all the previous versions in a version | 492 | are redundant when you store all the previous versions in a version |
| 493 | control system. @xref{General VC Options}. | 493 | control 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 | |||
| 516 | into a backup file if you save the buffer again. @kbd{C-u C-u C-x C-s} | 516 | into a backup file if you save the buffer again. @kbd{C-u C-u C-x C-s} |
| 517 | saves the buffer, but first makes the previous file contents into a new | 517 | saves the buffer, but first makes the previous file contents into a new |
| 518 | backup file. @kbd{C-u C-u C-u C-x C-s} does both things: it makes a | 518 | backup file. @kbd{C-u C-u C-u C-x C-s} does both things: it makes a |
| 519 | backup from the previous contents, and arranges to make another from the | 519 | backup from the previous contents and arranges to make another from the |
| 520 | newly saved contents, if you save again. | 520 | newly 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, |
| 608 | respectively the number of oldest (lowest-numbered) backups to keep and | 608 | respectively, the number of oldest (lowest-numbered) backups to keep and |
| 609 | the number of newest (highest-numbered) ones to keep, each time a new | 609 | the number of newest (highest-numbered) ones to keep, each time a new |
| 610 | backup is made. Recall that these values are used just after a new | 610 | backup is made. Recall that these values are used just after a new |
| 611 | backup version is made; that newly made backup is included in the count | 611 | backup 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 | |||
| 660 | if you start Emacs as the superuser. The fourth variable, | 660 | if 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 |
| 662 | numeric user-id for which @code{backup-by-copying-when-mismatch} will be | 662 | numeric user-id for which @code{backup-by-copying-when-mismatch} will be |
| 663 | forced on. This is useful when low-numbered user-id are assigned to | 663 | forced on. This is useful when low-numbered user-ids are assigned to |
| 664 | special system users, such as @code{root}, @code{bin}, @code{daemon}, | 664 | special system users, such as @code{root}, @code{bin}, @code{daemon}, |
| 665 | etc., which must maintain ownership of files. | 665 | etc., 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 | ||
| 808 | You can arrange put a time stamp in a file, so that it will be updated | 808 | You can arrange to put a time stamp in a file, so that it will be updated |
| 809 | automatically each time you edit and save the file. The time stamp | 809 | automatically each time you edit and save the file. The time stamp |
| 810 | has to be in the first eight lines of the file, and you should | 810 | has to be in the first eight lines of the file, and you should |
| 811 | insert it like this: | 811 | insert it like this: |
| @@ -1813,9 +1813,9 @@ This is the common way to pick up recent changes from the repository, | |||
| 1813 | regardless of whether you have already changed the file yourself. | 1813 | regardless 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 |
| 1816 | the minibuffer. Then it finds the changes from that branch, or between | 1816 | the minibuffer. Then @kbd{C-x v m} finds the changes from that branch, |
| 1817 | the two versions you specified, and merges them into the current version | 1817 | or between the two versions you specified, and merges them into the |
| 1818 | of the current file. | 1818 | current 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 |
| 1821 | branch 1.3.1. In the meantime, development on the trunk has proceeded | 1821 | branch 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.) | |||
| 1989 | You can do this at any time; it does not matter whether you have | 1989 | You can do this at any time; it does not matter whether you have |
| 1990 | already modified the file with respect to the version in the CVS | 1990 | already modified the file with respect to the version in the CVS |
| 1991 | repository. If possible, VC tries to make the RCS master start with | 1991 | repository. If possible, VC tries to make the RCS master start with |
| 1992 | the unmodified repository version, then checking in any local changes | 1992 | the unmodified repository version, then checks in any local changes |
| 1993 | as a new version. This works if you have not made any changes yet, or | 1993 | as a new version. This works if you have not made any changes yet, or |
| 1994 | if the unmodified repository version exists locally as a version | 1994 | if the unmodified repository version exists locally as a version |
| 1995 | backup (@pxref{Version Backups}). If the unmodified version is not | 1995 | backup (@pxref{Version Backups}). If the unmodified version is not |
| 1996 | available locally, the RCS master starts with the modified version; | 1996 | available locally, the RCS master starts with the modified version; |
| 1997 | the only drawback of this is that you cannot compare your changes | 1997 | the only drawback to this is that you cannot compare your changes |
| 1998 | locally to what is stored in the repository. | 1998 | locally to what is stored in the repository. |
| 1999 | 1999 | ||
| 2000 | The version number of the RCS master is derived from the current CVS | 2000 | The 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 |
| 2139 | retrieval, but it does not solve all problems. For example, some of the | 2139 | retrieval, but it does not solve all problems. For example, some of the |
| 2140 | files in the program probably refer to others by name. At the very | 2140 | files in your program probably refer to others by name. At the very |
| 2141 | least, the makefile probably mentions the file that you renamed. If you | 2141 | least, the makefile probably mentions the file that you renamed. If you |
| 2142 | retrieve an old snapshot, the renamed file is retrieved under its new | 2142 | retrieve an old snapshot, the renamed file is retrieved under its new |
| 2143 | name, which is not the name that the makefile expects. So the program | 2143 | name, 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 |
| 2207 | You can then edit the new change log entry further as you wish. | 2207 | You 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 |
| 2210 | ChangeLog. You will have to remove these duplicates by hand. | 2210 | ChangeLog. 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 |
| 2771 | pointing at @var{target}. The effect is that future attempts to open file | 2771 | points 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 |
| 2773 | time the opening is done, or will get an error if the name @var{target} is | 2773 | time the opening is done, or will get an error if the name @var{target} is |
| 2774 | not in use at that time. This command does not expand the argument | 2774 | not in use at that time. This command does not expand the argument |