From: Stephen Berman Date: Mon, 13 Jun 2016 16:08:22 +0000 (+0200) Subject: Doc fixes for grammar and typos (bug#23746) X-Git-Tag: emacs-25.1-rc1~92 X-Git-Url: https://code.delx.au/gnu-emacs/commitdiff_plain/20de6679b0b56b4e37fa7e145a3ed33010f3f6d4 Doc fixes for grammar and typos (bug#23746) * doc/emacs/files.texi (Customize Save): * doc/emacs/frames.texi (Window Dividers): * doc/emacs/misc.texi (Printing): * doc/lispref/compile.texi (Compiler Errors): * doc/lispref/keymaps.texi (Changing Key Bindings): * doc/lispref/loading.texi (Named Features): * doc/lispref/markers.texi (Marker Insertion Types): * doc/lispref/modes.texi (Mode Hooks): * doc/lispref/text.texi (Undo): * src/floatfns.c (Fldexp): * src/xfaces.c (syms_of_xfaces): Minor doc fixes for grammar and typos (bug#23746). --- diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 3bbb3cddb3..fc46ef7879 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -701,7 +701,7 @@ after it visits the file. (This marks the buffer as modified, and you can undo it.) If the value is @code{visit-save}, Emacs adds such newlines both on visiting and on saving. If the value is @code{nil}, Emacs leaves the end of the file unchanged; any other non-@code{nil} -value means to asks you whether to add a newline. The default is +value means Emacs asks you whether to add a newline. The default is @code{nil}. @vindex mode-require-final-newline diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index a7e709f922..7e6006262c 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1011,7 +1011,7 @@ scroll bar height, change the @code{scroll-bar-height} frame parameter On graphical displays, you can use @dfn{window dividers} in order to separate windows visually. Window dividers are bars that can be dragged -with the mouse, thus allowing to easily resize adjacent windows. +with the mouse, thus allowing you to easily resize adjacent windows. @findex window-divider-mode To toggle the display of window dividers, use the command @kbd{M-x diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index 497a4abd71..853b978492 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi @@ -1885,7 +1885,7 @@ Like @code{lpr-buffer} but print only the current region. @findex lpr-region @vindex lpr-switches @vindex lpr-commands - On most operating system, the above hardcopy commands submit files + On most operating systems, the above hardcopy commands submit files for printing by calling the @command{lpr} program. To change the printer program, customize the variable @code{lpr-command}. To specify extra switches to give the printer program, customize the list diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index c943a6a29c..f6cd0229c4 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -438,7 +438,7 @@ Emacs commands for operating on compiler output can be used on these messages. When an error is due to invalid syntax in the program, the byte -compiler might get confused about the errors' exact location. One way +compiler might get confused about the error's exact location. One way to investigate is to switch to the buffer @w{@file{ *Compiler Input*}}. (This buffer name starts with a space, so it does not show up in the Buffer Menu.) This buffer contains the program being diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index 61ac80c589..f5d3811fae 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -1368,7 +1368,7 @@ default global map. The function @code{substitute-key-definition} scans a keymap for keys that have a certain binding and rebinds them with a different binding. Another feature which is cleaner and can often produce the -same results to remap one command into another (@pxref{Remapping +same results is to remap one command into another (@pxref{Remapping Commands}). @defun substitute-key-definition olddef newdef keymap &optional oldmap diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index d2d38d7fb5..81a1922d71 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -848,8 +848,8 @@ loaded, into the current Emacs session. This means that the facilities associated with @var{feature} are or will be available for other Lisp programs. -The direct effect of calling @code{provide} is if not already in -@var{features} then to add @var{feature} to the front of that list and +The direct effect of calling @code{provide} is to add @var{feature} to +the front of @code{features} if it is not already in that list and call any @code{eval-after-load} code waiting for it (@pxref{Hooks for Loading}). The argument @var{feature} must be a symbol. @code{provide} returns @var{feature}. diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi index 1c904666cb..1b4d74fb25 100644 --- a/doc/lispref/markers.texi +++ b/doc/lispref/markers.texi @@ -340,10 +340,10 @@ text is inserted at its position. If @var{type} is @code{nil}, This function reports the current insertion type of @var{marker}. @end defun -Most functions that create markers, without an argument allowing to -specify the insertion type, create them with insertion type -@code{nil}. Also, the mark has, by default, insertion type -@code{nil}. +All functions that create markers without accepting an argument that +specifies the insertion type, create them with insertion type +@code{nil} (@pxref{Creating Markers}). Also, the mark has, by +default, insertion type @code{nil}. @node Moving Markers @section Moving Marker Positions diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi index ae79128f84..4c96e63bd7 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi @@ -899,7 +899,7 @@ follow these conventions: they may run the parent's mode hook too early, or fail to run @code{after-change-major-mode-hook}. If you encounter such a major mode, please correct it to follow these conventions. - When you defined a major mode using @code{define-derived-mode}, it + When you define a major mode using @code{define-derived-mode}, it automatically makes sure these conventions are followed. If you define a major mode ``by hand'', not using @code{define-derived-mode}, use the following functions to handle these conventions automatically. @@ -1048,7 +1048,7 @@ to invert the sort order. @defun tabulated-list-init-header This function computes and sets @code{header-line-format} for the Tabulated List buffer (@pxref{Header Lines}), and assigns a keymap to -the header line to allow sort entries by clicking on column headers. +the header line to allow sorting entries by clicking on column headers. Modes derived from Tabulated List mode should call this after setting the above variables (in particular, only after setting diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 96f109b756..7791c261e3 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -1376,10 +1376,10 @@ before executing each key sequence, so that each undo normally undoes the effects of one command. A few exceptional commands are @dfn{amalgamating}: these commands generally cause small changes to buffers, so with these a boundary is inserted only every 20th command, -allowing to undo them as a group. By default, commands +allowing the changes to be undone as a group. By default, the commands @code{self-insert-command}, which produces self-inserting input -characters (@pxref{Commands for Insertion}), and @code{delete-char} -which deletes characters (@pxref{Deletion}) are amalgamating. +characters (@pxref{Commands for Insertion}), and @code{delete-char}, +which deletes characters (@pxref{Deletion}), are amalgamating. Where a command affects the contents of several buffers, as may happen, for example, when a function on the @code{post-command-hook} affects a buffer other than the @code{current-buffer}, then @code{undo-boundary} diff --git a/src/floatfns.c b/src/floatfns.c index c1bd25877e..f514fcbea8 100644 --- a/src/floatfns.c +++ b/src/floatfns.c @@ -185,8 +185,8 @@ If X is zero, both parts (SGNFCAND and EXP) are zero. */) } DEFUN ("ldexp", Fldexp, Sldexp, 2, 2, 0, - doc: /* Return X * 2**EXP, as a floating point number. -EXP must be an integer. */) + doc: /* Return SGNFCAND * 2**EXPONENT, as a floating point number. +EXPONENT must be an integer. */) (Lisp_Object sgnfcand, Lisp_Object exponent) { CHECK_NUMBER (exponent); diff --git a/src/xfaces.c b/src/xfaces.c index 88f5f3415b..5077cb2d94 100644 --- a/src/xfaces.c +++ b/src/xfaces.c @@ -6503,8 +6503,8 @@ REPLACEMENT is a face specification, i.e. one of the following: (3) a list in which each element has the form of (1) or (2). List values for REPLACEMENT are merged to form the final face -specification, with earlier entries taking precedence, in the same as -as in the `face' text property. +specification, with earlier entries taking precedence, in the same way +as with the `face' text property. Face-name remapping cycles are suppressed; recursive references use the underlying face instead of the remapped face. So a remapping of