diff options
author | Michael Albinus <michael.albinus@gmx.de> | 2018-03-15 10:56:08 +0100 |
---|---|---|
committer | Michael Albinus <michael.albinus@gmx.de> | 2018-03-15 10:56:08 +0100 |
commit | 2b8507fbdce8228ccdbcbc31fe545a50330ddd51 (patch) | |
tree | 5cbbd0a4da7e8b48727a4eecfe015db28525fbf7 /doc/emacs | |
parent | 2616cd94f13edaf6db9ef600d9a79fa1be4807c5 (diff) | |
download | emacs-2b8507fbdce8228ccdbcbc31fe545a50330ddd51.tar.gz emacs-2b8507fbdce8228ccdbcbc31fe545a50330ddd51.tar.bz2 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.
Diffstat (limited to 'doc/emacs')
-rw-r--r-- | doc/emacs/msdos.texi | 45 | ||||
-rw-r--r-- | doc/emacs/mule.texi | 42 | ||||
-rw-r--r-- | doc/emacs/screen.texi | 4 |
3 files changed, 46 insertions, 45 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}. convention used on GNU, Unix, and other POSIX-compliant systems. @cindex end-of-line conversion on MS-DOS/MS-Windows - By contrast, MS-DOS and MS-Windows normally use carriage-return linefeed, -a two-character sequence, to separate text lines. (Linefeed is the same -character as newline.) Therefore, convenient editing of typical files -with Emacs requires conversion of these end-of-line (EOL) sequences. -And that is what Emacs normally does: it converts carriage-return -linefeed into newline when reading files, and converts newline into -carriage-return linefeed when writing files. The same mechanism that -handles conversion of international character codes does this conversion -also (@pxref{Coding Systems}). + By contrast, MS-DOS and MS-Windows normally use carriage return +followed by linefeed, a two-character sequence, to separate text +lines. (Linefeed is the same character as newline.) Therefore, +convenient editing of typical files with Emacs requires conversion of +these end-of-line (EOL) sequences. And that is what Emacs normally +does: it converts carriage return followed by linefeed into newline +when reading files, and converts newline into carriage return followed +by linefeed when writing files. The same mechanism that handles +conversion of international character codes does this conversion also +(@pxref{Coding Systems}). @cindex cursor location, on MS-DOS @cindex point location, on MS-DOS @@ -169,11 +170,11 @@ that character positions as reported by Emacs (@pxref{Position Info}) do not agree with the file size information known to the operating system. In addition, if Emacs recognizes from a file's contents that it uses -newline rather than carriage-return linefeed as its line separator, it -does not perform EOL conversion when reading or writing that file. -Thus, you can read and edit files from GNU and Unix systems on MS-DOS -with no special effort, and they will retain their Unix-style -end-of-line convention after you edit them. +newline rather than carriage return followed by linefeed as its line +separator, it does not perform EOL conversion when reading or writing +that file. Thus, you can read and edit files from GNU and Unix +systems on MS-DOS with no special effort, and they will retain their +Unix-style end-of-line convention after you edit them. The mode line indicates whether end-of-line translation was used for 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 the coding system mnemonic near the beginning of the mode line (@pxref{Mode Line}). If no EOL translation was performed, the string @samp{(Unix)} is displayed instead of the backslash, to alert you that the -file's EOL format is not the usual carriage-return linefeed. +file's EOL format is not the usual carriage return followed by linefeed. @cindex DOS-to-Unix conversion of files To visit a file and specify whether it uses DOS-style or Unix-style end-of-line, specify a coding system (@pxref{Text Coding}). For example, @kbd{C-x @key{RET} c unix @key{RET} C-x C-f foobar.txt} visits the file @file{foobar.txt} without converting the EOLs; if some -line ends with a carriage-return linefeed pair, Emacs will display -@samp{^M} at the end of that line. Similarly, you can direct Emacs to -save a buffer in a specified EOL format with the @kbd{C-x @key{RET} f} -command. For example, to save a buffer with Unix EOL format, type -@kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you visit a file -with DOS EOL conversion, then save it with Unix EOL format, that -effectively converts the file to Unix EOL style, like the +line ends with a carriage return followed by linefeed pair, Emacs will +display @samp{^M} at the end of that line. Similarly, you can direct +Emacs to save a buffer in a specified EOL format with the @kbd{C-x +@key{RET} f} command. For example, to save a buffer with Unix EOL +format, type @kbd{C-x @key{RET} f unix @key{RET} C-x C-s}. If you +visit a file with DOS EOL conversion, then save it with Unix EOL +format, that effectively converts the file to Unix EOL style, like the @code{dos2unix} program. @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 In addition to converting various representations of non-@acronym{ASCII} characters, a coding system can perform end-of-line conversion. Emacs handles three different conventions for how to separate lines in a file: -newline (Unix), carriage-return linefeed (DOS), and just -carriage-return (Mac). +newline (Unix), carriage return followed by linefeed (DOS), and just +carriage return (Mac). @table @kbd @item C-h C @var{coding} @key{RET} @@ -728,8 +728,8 @@ system, including the letter that stands for it in the mode line @code{no-conversion}, which means no conversion of any kind---specifies how and whether to convert printing characters, but leaves the choice of end-of-line conversion to be decided based on the contents of each file. -For example, if the file appears to use the sequence carriage-return -linefeed to separate lines, DOS end-of-line conversion will be used. +For example, if the file appears to use the sequence carriage return +and linefeed to separate lines, DOS end-of-line conversion will be used. Each of the listed coding systems has three variants, which specify exactly what to do for end-of-line conversion: @@ -741,15 +741,15 @@ newline to separate lines. (This is the convention normally used on Unix and GNU systems, and macOS.) @item @dots{}-dos -Assume the file uses carriage-return linefeed to separate lines, and do -the appropriate conversion. (This is the convention normally used on -Microsoft systems.@footnote{It is also specified for MIME @samp{text/*} -bodies and in other network transport contexts. It is different -from the SGML reference syntax record-start/record-end format, which -Emacs doesn't support directly.}) +Assume the file uses carriage return followed by linefeed to separate +lines, and do the appropriate conversion. (This is the convention +normally used on Microsoft systems.@footnote{It is also specified for +MIME @samp{text/*} bodies and in other network transport contexts. It +is different from the SGML reference syntax record-start/record-end +format, which Emacs doesn't support directly.}) @item @dots{}-mac -Assume the file uses carriage-return to separate lines, and do the +Assume the file uses carriage return to separate lines, and do the appropriate conversion. (This was the convention used in Classic Mac OS.) @end table @@ -859,15 +859,15 @@ the third argument says which coding system to use for these files. @vindex inhibit-eol-conversion @cindex DOS-style end-of-line display Emacs recognizes which kind of end-of-line conversion to use based on -the contents of the file: if it sees only carriage-returns, or only -carriage-return linefeed sequences, then it chooses the end-of-line -conversion accordingly. You can inhibit the automatic use of -end-of-line conversion by setting the variable @code{inhibit-eol-conversion} -to non-@code{nil}. If you do that, DOS-style files will be displayed -with the @samp{^M} characters visible in the buffer; some people -prefer this to the more subtle @samp{(DOS)} end-of-line type -indication near the left edge of the mode line (@pxref{Mode Line, -eol-mnemonic}). +the contents of the file: if it sees only carriage returns, or only +carriage return followed by linefeed sequences, then it chooses the +end-of-line conversion accordingly. You can inhibit the automatic use +of end-of-line conversion by setting the variable +@code{inhibit-eol-conversion} to non-@code{nil}. If you do that, +DOS-style files will be displayed with the @samp{^M} characters +visible in the buffer; some people prefer this to the more subtle +@samp{(DOS)} end-of-line type indication near the left edge of the +mode line (@pxref{Mode Line, eol-mnemonic}). @vindex inhibit-iso-escape-detection @cindex escape sequences in files @@ -1041,7 +1041,7 @@ buffer (@pxref{Output Coding}). (@pxref{Coding Systems, end-of-line conversion}) for encoding the current buffer. For example, @kbd{C-x @key{RET} f dos @key{RET}} will cause Emacs to save the current buffer's text with DOS-style -carriage-return linefeed line endings. +carriage return followed by linefeed line endings. @kindex C-x RET c @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, string is displayed, that indicates a nontrivial end-of-line convention for encoding a file. Usually, lines of text are separated by @dfn{newline characters} in a file, but two other conventions are -sometimes used. The MS-DOS convention uses a carriage-return +sometimes used. The MS-DOS convention uses a carriage return character followed by a linefeed character; when editing such files, the colon changes to either a backslash (@samp{\}) or @samp{(DOS)}, depending on the operating system. Another convention, -employed by older Macintosh systems, uses a carriage-return +employed by older Macintosh systems, uses a carriage return character instead of a newline; when editing such files, the colon changes to either a forward slash (@samp{/}) or @samp{(Mac)}. On some systems, Emacs displays @samp{(Unix)} instead of the colon for files |