diff options
| author | Michael Albinus | 2018-03-15 10:56:08 +0100 |
|---|---|---|
| committer | Michael Albinus | 2018-03-15 10:56:08 +0100 |
| commit | 2b8507fbdce8228ccdbcbc31fe545a50330ddd51 (patch) | |
| tree | 5cbbd0a4da7e8b48727a4eecfe015db28525fbf7 | |
| parent | 2616cd94f13edaf6db9ef600d9a79fa1be4807c5 (diff) | |
| download | emacs-2b8507fbdce8228ccdbcbc31fe545a50330ddd51.tar.gz emacs-2b8507fbdce8228ccdbcbc31fe545a50330ddd51.zip | |
Replace "carriage-return" by "carriage return" in manuals
* doc/emacs/msdos.texi:
* doc/emacs/mule.texi:
* doc/emacs/screen.texi:
* doc/lispref/nonascii.texi:
* doc/misc/calc.texi: Replace "carriage-return" by "carriage
return". Suggested by Richard Stallman <rms@gnu.org> in
emacs-manual-bugs@gnu.org.
| -rw-r--r-- | doc/emacs/msdos.texi | 45 | ||||
| -rw-r--r-- | doc/emacs/mule.texi | 42 | ||||
| -rw-r--r-- | doc/emacs/screen.texi | 4 | ||||
| -rw-r--r-- | doc/lispref/nonascii.texi | 4 | ||||
| -rw-r--r-- | doc/misc/calc.texi | 2 |
5 files changed, 49 insertions, 48 deletions
diff --git a/doc/emacs/msdos.texi b/doc/emacs/msdos.texi index 95969540f5b..90f0389a0e0 100644 --- a/doc/emacs/msdos.texi +++ b/doc/emacs/msdos.texi | |||
| @@ -152,15 +152,16 @@ window. @xref{emacsclient Options}. | |||
| 152 | convention used on GNU, Unix, and other POSIX-compliant systems. | 152 | convention used on GNU, Unix, and other POSIX-compliant systems. |
| 153 | 153 | ||
| 154 | @cindex end-of-line conversion on MS-DOS/MS-Windows | 154 | @cindex end-of-line conversion on MS-DOS/MS-Windows |
| 155 | By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, | 155 | By contrast, MS-DOS and MS-Windows normally use carriage return |
| 156 | a two-character sequence, to separate text lines. (Linefeed is the same | 156 | followed by linefeed, a two-character sequence, to separate text |
| 157 | character as newline.) Therefore, convenient editing of typical files | 157 | lines. (Linefeed is the same character as newline.) Therefore, |
| 158 | with Emacs requires conversion of these end-of-line (EOL) sequences. | 158 | convenient editing of typical files with Emacs requires conversion of |
| 159 | And that is what Emacs normally does: it converts carriage-return | 159 | these end-of-line (EOL) sequences. And that is what Emacs normally |
| 160 | linefeed into newline when reading files, and converts newline into | 160 | does: it converts carriage return followed by linefeed into newline |
| 161 | carriage-return linefeed when writing files. The same mechanism that | 161 | when reading files, and converts newline into carriage return followed |
| 162 | handles conversion of international character codes does this conversion | 162 | by linefeed when writing files. The same mechanism that handles |
| 163 | also (@pxref{Coding Systems}). | 163 | conversion of international character codes does this conversion also |
| 164 | (@pxref{Coding Systems}). | ||
| 164 | 165 | ||
| 165 | @cindex cursor location, on MS-DOS | 166 | @cindex cursor location, on MS-DOS |
| 166 | @cindex point location, on MS-DOS | 167 | @cindex point location, on MS-DOS |
| @@ -169,11 +170,11 @@ that character positions as reported by Emacs (@pxref{Position Info}) do | |||
| 169 | not agree with the file size information known to the operating system. | 170 | not agree with the file size information known to the operating system. |
| 170 | 171 | ||
| 171 | In addition, if Emacs recognizes from a file's contents that it uses | 172 | In addition, if Emacs recognizes from a file's contents that it uses |
| 172 | newline rather than carriage-return linefeed as its line separator, it | 173 | newline rather than carriage return followed by linefeed as its line |
| 173 | does not perform EOL conversion when reading or writing that file. | 174 | separator, it does not perform EOL conversion when reading or writing |
| 174 | Thus, you can read and edit files from GNU and Unix systems on MS-DOS | 175 | that file. Thus, you can read and edit files from GNU and Unix |
| 175 | with no special effort, and they will retain their Unix-style | 176 | systems on MS-DOS with no special effort, and they will retain their |
| 176 | end-of-line convention after you edit them. | 177 | Unix-style end-of-line convention after you edit them. |
| 177 | 178 | ||
| 178 | The mode line indicates whether end-of-line translation was used for | 179 | The mode line indicates whether end-of-line translation was used for |
| 179 | the current buffer. If MS-DOS end-of-line translation is in use for the | 180 | the current buffer. If MS-DOS end-of-line translation is in use for the |
| @@ -181,20 +182,20 @@ buffer, the MS-Windows build of Emacs displays a backslash @samp{\} after | |||
| 181 | the coding system mnemonic near the beginning of the mode line | 182 | the coding system mnemonic near the beginning of the mode line |
| 182 | (@pxref{Mode Line}). If no EOL translation was performed, the string | 183 | (@pxref{Mode Line}). If no EOL translation was performed, the string |
| 183 | @samp{(Unix)} is displayed instead of the backslash, to alert you that the | 184 | @samp{(Unix)} is displayed instead of the backslash, to alert you that the |
| 184 | file's EOL format is not the usual carriage-return linefeed. | 185 | file's EOL format is not the usual carriage return followed by linefeed. |
| 185 | 186 | ||
| 186 | @cindex DOS-to-Unix conversion of files | 187 | @cindex DOS-to-Unix conversion of files |
| 187 | To visit a file and specify whether it uses DOS-style or Unix-style | 188 | To visit a file and specify whether it uses DOS-style or Unix-style |
| 188 | end-of-line, specify a coding system (@pxref{Text Coding}). For | 189 | end-of-line, specify a coding system (@pxref{Text Coding}). For |
| 189 | example, @kbd{C-x @key{RET} c unix @key{RET} C-x C-f foobar.txt} | 190 | example, @kbd{C-x @key{RET} c unix @key{RET} C-x C-f foobar.txt} |
| 190 | visits the file @file{foobar.txt} without converting the EOLs; if some | 191 | visits the file @file{foobar.txt} without converting the EOLs; if some |
| 191 | line ends with a carriage-return linefeed pair, Emacs will display | 192 | line ends with a carriage return followed by linefeed pair, Emacs will |
| 192 | @samp{^M} at the end of that line. Similarly, you can direct Emacs to | 193 | display @samp{^M} at the end of that line. Similarly, you can direct |
| 193 | save a buffer in a specified EOL format with the @kbd{C-x @key{RET} f} | 194 | Emacs to save a buffer in a specified EOL format with the @kbd{C-x |
| 194 | command. For example, to save a buffer with Unix EOL format, type | 195 | @key{RET} f} command. For example, to save a buffer with Unix EOL |
| 195 | @kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you visit a file | 196 | format, type @kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you |
| 196 | with DOS EOL conversion, then save it with Unix EOL format, that | 197 | visit a file with DOS EOL conversion, then save it with Unix EOL |
| 197 | effectively converts the file to Unix EOL style, like the | 198 | format, that effectively converts the file to Unix EOL style, like the |
| 198 | @code{dos2unix} program. | 199 | @code{dos2unix} program. |
| 199 | 200 | ||
| 200 | @cindex untranslated file system | 201 | @cindex untranslated file system |
diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index f9dbeffcb12..401c83dd49a 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi | |||
| @@ -690,8 +690,8 @@ system; for example, to visit a file encoded in codepage 850, type | |||
| 690 | In addition to converting various representations of non-@acronym{ASCII} | 690 | In addition to converting various representations of non-@acronym{ASCII} |
| 691 | characters, a coding system can perform end-of-line conversion. Emacs | 691 | characters, a coding system can perform end-of-line conversion. Emacs |
| 692 | handles three different conventions for how to separate lines in a file: | 692 | handles three different conventions for how to separate lines in a file: |
| 693 | newline (Unix), carriage-return linefeed (DOS), and just | 693 | newline (Unix), carriage return followed by linefeed (DOS), and just |
| 694 | carriage-return (Mac). | 694 | carriage return (Mac). |
| 695 | 695 | ||
| 696 | @table @kbd | 696 | @table @kbd |
| 697 | @item C-h C @var{coding} @key{RET} | 697 | @item C-h C @var{coding} @key{RET} |
| @@ -728,8 +728,8 @@ system, including the letter that stands for it in the mode line | |||
| 728 | @code{no-conversion}, which means no conversion of any kind---specifies | 728 | @code{no-conversion}, which means no conversion of any kind---specifies |
| 729 | how and whether to convert printing characters, but leaves the choice of | 729 | how and whether to convert printing characters, but leaves the choice of |
| 730 | end-of-line conversion to be decided based on the contents of each file. | 730 | end-of-line conversion to be decided based on the contents of each file. |
| 731 | For example, if the file appears to use the sequence carriage-return | 731 | For example, if the file appears to use the sequence carriage return |
| 732 | linefeed to separate lines, DOS end-of-line conversion will be used. | 732 | and linefeed to separate lines, DOS end-of-line conversion will be used. |
| 733 | 733 | ||
| 734 | Each of the listed coding systems has three variants, which specify | 734 | Each of the listed coding systems has three variants, which specify |
| 735 | exactly what to do for end-of-line conversion: | 735 | exactly what to do for end-of-line conversion: |
| @@ -741,15 +741,15 @@ newline to separate lines. (This is the convention normally used | |||
| 741 | on Unix and GNU systems, and macOS.) | 741 | on Unix and GNU systems, and macOS.) |
| 742 | 742 | ||
| 743 | @item @dots{}-dos | 743 | @item @dots{}-dos |
| 744 | Assume the file uses carriage-return linefeed to separate lines, and do | 744 | Assume the file uses carriage return followed by linefeed to separate |
| 745 | the appropriate conversion. (This is the convention normally used on | 745 | lines, and do the appropriate conversion. (This is the convention |
| 746 | Microsoft systems.@footnote{It is also specified for MIME @samp{text/*} | 746 | normally used on Microsoft systems.@footnote{It is also specified for |
| 747 | bodies and in other network transport contexts. It is different | 747 | MIME @samp{text/*} bodies and in other network transport contexts. It |
| 748 | from the SGML reference syntax record-start/record-end format, which | 748 | is different from the SGML reference syntax record-start/record-end |
| 749 | Emacs doesn't support directly.}) | 749 | format, which Emacs doesn't support directly.}) |
| 750 | 750 | ||
| 751 | @item @dots{}-mac | 751 | @item @dots{}-mac |
| 752 | Assume the file uses carriage-return to separate lines, and do the | 752 | Assume the file uses carriage return to separate lines, and do the |
| 753 | appropriate conversion. (This was the convention used in Classic Mac | 753 | appropriate conversion. (This was the convention used in Classic Mac |
| 754 | OS.) | 754 | OS.) |
| 755 | @end table | 755 | @end table |
| @@ -859,15 +859,15 @@ the third argument says which coding system to use for these files. | |||
| 859 | @vindex inhibit-eol-conversion | 859 | @vindex inhibit-eol-conversion |
| 860 | @cindex DOS-style end-of-line display | 860 | @cindex DOS-style end-of-line display |
| 861 | Emacs recognizes which kind of end-of-line conversion to use based on | 861 | Emacs recognizes which kind of end-of-line conversion to use based on |
| 862 | the contents of the file: if it sees only carriage-returns, or only | 862 | the contents of the file: if it sees only carriage returns, or only |
| 863 | carriage-return linefeed sequences, then it chooses the end-of-line | 863 | carriage return followed by linefeed sequences, then it chooses the |
| 864 | conversion accordingly. You can inhibit the automatic use of | 864 | end-of-line conversion accordingly. You can inhibit the automatic use |
| 865 | end-of-line conversion by setting the variable @code{inhibit-eol-conversion} | 865 | of end-of-line conversion by setting the variable |
| 866 | to non-@code{nil}. If you do that, DOS-style files will be displayed | 866 | @code{inhibit-eol-conversion} to non-@code{nil}. If you do that, |
| 867 | with the @samp{^M} characters visible in the buffer; some people | 867 | DOS-style files will be displayed with the @samp{^M} characters |
| 868 | prefer this to the more subtle @samp{(DOS)} end-of-line type | 868 | visible in the buffer; some people prefer this to the more subtle |
| 869 | indication near the left edge of the mode line (@pxref{Mode Line, | 869 | @samp{(DOS)} end-of-line type indication near the left edge of the |
| 870 | eol-mnemonic}). | 870 | mode line (@pxref{Mode Line, eol-mnemonic}). |
| 871 | 871 | ||
| 872 | @vindex inhibit-iso-escape-detection | 872 | @vindex inhibit-iso-escape-detection |
| 873 | @cindex escape sequences in files | 873 | @cindex escape sequences in files |
| @@ -1041,7 +1041,7 @@ buffer (@pxref{Output Coding}). | |||
| 1041 | (@pxref{Coding Systems, end-of-line conversion}) for encoding the | 1041 | (@pxref{Coding Systems, end-of-line conversion}) for encoding the |
| 1042 | current buffer. For example, @kbd{C-x @key{RET} f dos @key{RET}} will | 1042 | current buffer. For example, @kbd{C-x @key{RET} f dos @key{RET}} will |
| 1043 | cause Emacs to save the current buffer's text with DOS-style | 1043 | cause Emacs to save the current buffer's text with DOS-style |
| 1044 | carriage-return linefeed line endings. | 1044 | carriage return followed by linefeed line endings. |
| 1045 | 1045 | ||
| 1046 | @kindex C-x RET c | 1046 | @kindex C-x RET c |
| 1047 | @findex universal-coding-system-argument | 1047 | @findex universal-coding-system-argument |
diff --git a/doc/emacs/screen.texi b/doc/emacs/screen.texi index 19a4a9e4b6c..8f2be4b9a7e 100644 --- a/doc/emacs/screen.texi +++ b/doc/emacs/screen.texi | |||
| @@ -205,11 +205,11 @@ terminal output. Furthermore, if you are using an input method, | |||
| 205 | string is displayed, that indicates a nontrivial end-of-line | 205 | string is displayed, that indicates a nontrivial end-of-line |
| 206 | convention for encoding a file. Usually, lines of text are separated | 206 | convention for encoding a file. Usually, lines of text are separated |
| 207 | by @dfn{newline characters} in a file, but two other conventions are | 207 | by @dfn{newline characters} in a file, but two other conventions are |
| 208 | sometimes used. The MS-DOS convention uses a carriage-return | 208 | sometimes used. The MS-DOS convention uses a carriage return |
| 209 | character followed by a linefeed character; when editing such | 209 | character followed by a linefeed character; when editing such |
| 210 | files, the colon changes to either a backslash (@samp{\}) or | 210 | files, the colon changes to either a backslash (@samp{\}) or |
| 211 | @samp{(DOS)}, depending on the operating system. Another convention, | 211 | @samp{(DOS)}, depending on the operating system. Another convention, |
| 212 | employed by older Macintosh systems, uses a carriage-return | 212 | employed by older Macintosh systems, uses a carriage return |
| 213 | character instead of a newline; when editing such files, the colon | 213 | character instead of a newline; when editing such files, the colon |
| 214 | changes to either a forward slash (@samp{/}) or @samp{(Mac)}. On some | 214 | changes to either a forward slash (@samp{/}) or @samp{(Mac)}. On some |
| 215 | systems, Emacs displays @samp{(Unix)} instead of the colon for files | 215 | systems, Emacs displays @samp{(Unix)} instead of the colon for files |
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index 8bc7e209894..70df555d877 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi | |||
| @@ -1074,9 +1074,9 @@ that result from encoding unsupported characters. | |||
| 1074 | used on various systems for representing end of line in files. The | 1074 | used on various systems for representing end of line in files. The |
| 1075 | Unix convention, used on GNU and Unix systems, is to use the linefeed | 1075 | Unix convention, used on GNU and Unix systems, is to use the linefeed |
| 1076 | character (also called newline). The DOS convention, used on | 1076 | character (also called newline). The DOS convention, used on |
| 1077 | MS-Windows and MS-DOS systems, is to use a carriage-return and a | 1077 | MS-Windows and MS-DOS systems, is to use a carriage return and a |
| 1078 | linefeed at the end of a line. The Mac convention is to use just | 1078 | linefeed at the end of a line. The Mac convention is to use just |
| 1079 | carriage-return. (This was the convention used in Classic Mac OS.) | 1079 | carriage return. (This was the convention used in Classic Mac OS.) |
| 1080 | 1080 | ||
| 1081 | @cindex base coding system | 1081 | @cindex base coding system |
| 1082 | @cindex variant coding system | 1082 | @cindex variant coding system |
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index be78a53ed66..0c8c2db4932 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi | |||
| @@ -33164,7 +33164,7 @@ This switches into the Calc buffer for the duration of the macro. | |||
| 33164 | For example, @samp{(calc-eval "vx5\rVR+" 'macro)} pushes the | 33164 | For example, @samp{(calc-eval "vx5\rVR+" 'macro)} pushes the |
| 33165 | vector @samp{[1,2,3,4,5]} on the stack and then replaces it | 33165 | vector @samp{[1,2,3,4,5]} on the stack and then replaces it |
| 33166 | with the sum of those numbers. Note that @samp{\r} is the Lisp | 33166 | with the sum of those numbers. Note that @samp{\r} is the Lisp |
| 33167 | notation for the carriage-return, @key{RET}, character. | 33167 | notation for the carriage return, @key{RET}, character. |
| 33168 | 33168 | ||
| 33169 | If your keyboard macro wishes to pop the stack, @samp{\C-d} is | 33169 | If your keyboard macro wishes to pop the stack, @samp{\C-d} is |
| 33170 | safer than @samp{\177} (the @key{DEL} character) because some | 33170 | safer than @samp{\177} (the @key{DEL} character) because some |