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/emacs/glossary.texi | |
parent | c051487fcf379febf4ce5b38de7017609c84a106 (diff) | |
download | emacs-ef7dbdf5873bf0a1f3f0e64e5d019e74d5b15b9e.tar.gz emacs-ef7dbdf5873bf0a1f3f0e64e5d019e74d5b15b9e.tar.bz2 emacs-ef7dbdf5873bf0a1f3f0e64e5d019e74d5b15b9e.zip |
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/emacs/glossary.texi')
-rw-r--r-- | doc/emacs/glossary.texi | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi index 9101f1c1331..ef186723d6b 100644 --- a/doc/emacs/glossary.texi +++ b/doc/emacs/glossary.texi @@ -100,7 +100,7 @@ A base buffer is a buffer whose text is shared by an indirect buffer Some human languages, such as English, are written from left to right. Others, such as Arabic, are written from right to left. Emacs supports both of these forms, as well as any mixture of them---this -is ``bidirectional text''. @xref{Bidirectional Editing}. +is bidirectional text. @xref{Bidirectional Editing}. @item Bind To bind a key sequence means to give it a binding (q.v.). @@ -135,7 +135,7 @@ X}). Borders are not the same as fringes (q.v.). @item Buffer The buffer is the basic editing unit; one buffer corresponds to one text being edited. You normally have several buffers, but at any time you are -editing only one, the ``current buffer'', though several can be visible +editing only one, the current buffer, though several can be visible when you are using multiple windows or frames (q.v.). Most buffers are visiting (q.v.@:) some file. @xref{Buffers}. @@ -265,7 +265,7 @@ normally (but see @ref{Glossary---Truncation}) takes up more than one screen line when displayed. We say that the text line is continued, and all screen lines used for it after the first are called continuation lines. @xref{Continuation Lines}. A related Emacs feature is -``filling'' (q.v.). +filling (q.v.). @item Control Character A control character is a character that you type by holding down the @@ -285,7 +285,7 @@ The particular form of copyleft used by the GNU project is called the GNU General Public License. @xref{Copying}. @item @key{Ctrl} -The @key{Ctrl} or ``control'' key is what you hold down +The @key{Ctrl} or control key is what you hold down in order to enter a control character (q.v.). @xref{Glossary---C-}. @item Current Buffer @@ -367,8 +367,8 @@ Deletion means erasing text without copying it into the kill ring @anchor{Glossary---Deletion of Files} @item Deletion of Files Deleting a file means erasing it from the file system. -(Note that some systems use the concept of a ``trash can'', or ``recycle -bin'', to allow you to ``undelete'' files.) +(Note that some systems use the concept of a trash can, or recycle +bin, to allow you to undelete files.) @xref{Misc File Ops,Misc File Ops,Miscellaneous File Operations}. @item Deletion of Messages @@ -396,7 +396,7 @@ Variables}. @item Dired Dired is the Emacs facility that displays the contents of a file -directory and allows you to ``edit the directory'', performing +directory and allows you to edit the directory, performing operations on the files in the directory. @xref{Dired}. @item Disabled Command @@ -580,7 +580,7 @@ For more information, see @uref{http://fsf.org/, the FSF website}. @item Fringe On a graphical display (q.v.), there's a narrow portion of the frame (q.v.@:) between the text area and the window's border. These -``fringes'' are used to display symbols that provide information about +fringes are used to display symbols that provide information about the buffer text (@pxref{Fringes}). Emacs displays the fringe using a special face (q.v.@:) called @code{fringe}. @xref{Faces,fringe}. @@ -1076,7 +1076,7 @@ command, using @kbd{C-g} (or @kbd{C-@key{BREAK}} on MS-DOS). @xref{Quitting}. Quoting means depriving a character of its usual special significance. The most common kind of quoting in Emacs is with @kbd{C-q}. What constitutes special significance depends on the context and on -convention. For example, an ``ordinary'' character as an Emacs command +convention. For example, an ordinary character as an Emacs command inserts itself; so in this context, a special character is any character that does not normally insert itself (such as @key{DEL}, for example), and quoting it makes it insert itself as if it were not special. Not @@ -1121,7 +1121,7 @@ Many commands operate on the text of the region. @xref{Mark,Region}. @item Register Registers are named slots in which text, buffer positions, or rectangles can be saved for later use. @xref{Registers}. A related -Emacs feature is ``bookmarks'' (q.v.). +Emacs feature is bookmarks (q.v.). @anchor{Glossary---Regular Expression} @item Regular Expression |