diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2015-09-15 08:46:48 -0700 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2015-09-15 08:48:44 -0700 |
commit | ef7dbdf5873bf0a1f3f0e64e5d019e74d5b15b9e (patch) | |
tree | 5b1d35e609ce4481816662709ac677db1468495b /doc/lispref/compile.texi | |
parent | c051487fcf379febf4ce5b38de7017609c84a106 (diff) | |
download | emacs-ef7dbdf5873bf0a1f3f0e64e5d019e74d5b15b9e.tar.gz |
Quote less in manuals
The manuals often used quotes ``...'' when it is better to use @dfn or
@code or capitalized words or no quoting at all. For example, there is
no need for the `` and '' in “if a variable has one effect for
@code{nil} values and another effect for ``non-@code{nil}'' values”.
Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate
unnecessary quoting like this, and to use @dfn etc. instead when called
for (Bug#21472).
Diffstat (limited to 'doc/lispref/compile.texi')
-rw-r--r-- | doc/lispref/compile.texi | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 4a246dd6b92..8c23086e8d1 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -140,7 +140,7 @@ definition of @var{symbol} (@pxref{Byte-Code Objects}). If @var{symbol}'s definition is a byte-code function object, @code{byte-compile} does nothing and returns @code{nil}. It does not -``compile the symbol's definition again'', since the original +compile the symbol's definition again, since the original (non-compiled) code has already been replaced in the symbol's function cell by the byte-compiled code. @@ -242,7 +242,7 @@ $ emacs -batch -f batch-byte-compile *.el When Emacs loads functions and variables from a byte-compiled file, it normally does not load their documentation strings into memory. -Each documentation string is ``dynamically'' loaded from the +Each documentation string is dynamically loaded from the byte-compiled file only when needed. This saves memory, and speeds up loading by skipping the processing of the documentation strings. @@ -280,7 +280,7 @@ Internally, the dynamic loading of documentation strings is accomplished by writing compiled files with a special Lisp reader construct, @samp{#@@@var{count}}. This construct skips the next @var{count} characters. It also uses the @samp{#$} construct, which -stands for ``the name of this file, as a string''. Do not use these +stands for the name of this file, as a string. Do not use these constructs in Lisp source files; they are not designed to be clear to humans reading the file. |