From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.bugs Subject: bug#23746: 25.0.95; Doc fixes (grammar, typos, clarification) Date: Sat, 11 Jun 2016 17:54:04 +0200 Message-ID: <87h9czoh5v.fsf@gmx.net> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1465660527 16350 80.91.229.3 (11 Jun 2016 15:55:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 11 Jun 2016 15:55:27 +0000 (UTC) To: 23746@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 11 17:55:14 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bBlFi-0000y8-9H for geb-bug-gnu-emacs@m.gmane.org; Sat, 11 Jun 2016 17:55:14 +0200 Original-Received: from localhost ([::1]:47519 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlFh-0002Wb-5i for geb-bug-gnu-emacs@m.gmane.org; Sat, 11 Jun 2016 11:55:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36829) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlFa-0002TF-5C for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:55:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bBlFW-0005Ge-0D for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:55:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53237) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlFV-0005Ga-SG for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:55:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bBlFV-0006lS-Ny for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:55:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stephen Berman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 11 Jun 2016 15:55:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 23746 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.146566046425947 (code B ref -1); Sat, 11 Jun 2016 15:55:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Jun 2016 15:54:24 +0000 Original-Received: from localhost ([127.0.0.1]:37341 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bBlEt-0006kR-S7 for submit@debbugs.gnu.org; Sat, 11 Jun 2016 11:54:24 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:45745) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bBlEs-0006kF-RP for submit@debbugs.gnu.org; Sat, 11 Jun 2016 11:54:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bBlEl-0005CV-Qf for submit@debbugs.gnu.org; Sat, 11 Jun 2016 11:54:17 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:43692) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlEl-0005CO-NI for submit@debbugs.gnu.org; Sat, 11 Jun 2016 11:54:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36709) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlEi-0002R4-KA for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:54:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bBlEe-0005Bk-Ds for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:54:11 -0400 Original-Received: from mout.gmx.net ([212.227.15.19]:54413) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBlEe-0005Be-2p for bug-gnu-emacs@gnu.org; Sat, 11 Jun 2016 11:54:08 -0400 Original-Received: from rosalinde ([89.245.73.202]) by mail.gmx.com (mrgmx003) with ESMTPSA (Nemesis) id 0McVns-1auENp1f6m-00Hgfk for ; Sat, 11 Jun 2016 17:54:05 +0200 User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.95 (gnu/linux) X-Provags-ID: V03:K0:PB9W0g47PS63/c7h/1sRbetckGxre3uwoCFPrLxQije68nbqmqY eibsRWITsQ2i+D9fZOn5TR3GqzhqiKq9aKr6spQ7enFZWx3jSh/gRdvm+DPcQDhhdeGw4QM aDSlpW3lh2j+Jz74/ijC0TJFv2DqsT1DNToldMR91pxYRXxXyk8dXB85oVMAn55ptFZXzkq +M9/xdMcCXFwchYYRZf8Q== X-UI-Out-Filterresults: notjunk:1;V01:K0:ZKhZ1EMu4ps=:RuEEg7fXw4yyd0+pWBxjM2 wKDh7etRGPAjPdPNSuZpfXrfG9XZBHELqsHZnuHktnj7wwVNY95ZbEK+BYLV166/AsyoWysNV 4eR9I4+cDMSH4zsMw7mvkS2WGYe2sqTYXHnFUff6f0Ma0lbLXshcYr4imdCILTuh8AEFFct4R CS77/z1wLZI6u1dU4zrJdEzn//cABA1LbufPCJnChmjgrxrWcQHIYwZ+8bIYxsaZDPoTdV/Wb x0FNrh5qbsX6afd+spipMMyBeWzfCF4RozLr4WwcE+bJcyHX2BES+Rl5gXTMVgbwNVlKcG+84 Xd9BnM4aGE/NkKNHXPMfHZPo3DXHKFlM2oLzpoU+Qi9BXCciADAj3Y0hMGOx4fLzln7mTYFqy q3QdfVMxrxmLYrpBzXPQrzqvtUbMsOODaeEHh2BjV4EVaptYepV97o9jEl/DNtRogMa7W81r2 41pI+LAvwUYDXtSdisK1E5kRuldhX3bz08SexQBe+44WegFr9Hx3cRXFSWqAei3tPeBJjfA+A forBQZF8cxAioAVN5p6os+4K2WZH9202O1RmJkiynYWKLFqI7tnzaBhPNVa23jNEwZc/bXm2g 4GlNscSONY4DC5QJOrE88cHWDa8Yj8Lq3kyxk3FCZYoRhXJXa8zThG9KCQB57fUXvWw+Hv74J ooabOavl7i6yRcTB3J/pTOb8sU6Cz8a/KWZv2JX+gc2WrUJPi18/SXi5MXxNQTXsjcRBAArFC MYuy2TAXu+QZIRouXpHM9oGHim2pIzDPSP1RGy75NoOG1/OxWGBAdU/HrKHGbO/l6JjUnV8n X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:119424 Archived-At: In GNU Emacs 25.0.95.1 (x86_64-suse-linux-gnu, GTK+ Version 3.14.15) of 2016-06-11 built on rosalinde Repository revision: 6921f4a5961fb53f8fb24d1a5a3f94266f990f6e diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 3bbb3cd..fc46ef7 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -701,7 +701,7 @@ Customize Save 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 a7e709f..7e60062 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1011,7 +1011,7 @@ Window Dividers 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 497a4ab..853b978 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi @@ -1885,7 +1885,7 @@ Printing @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 c943a6a..f6cd022 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -438,7 +438,7 @@ Compiler Errors 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/control.texi b/doc/lispref/control.texi index 0cdb035..6179500 100644 --- a/doc/lispref/control.texi +++ b/doc/lispref/control.texi @@ -289,11 +289,11 @@ Conditionals @end example @menu -* Pattern matching case statement:: +* Pattern Matching Case Statement:: @end menu -@node Pattern matching case statement -@subsection Pattern matching case statement +@node Pattern Matching Case Statement +@subsection Pattern Matching Case Statement @cindex pcase @cindex pattern matching diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index a3bff0b..f9f155e 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -469,7 +469,7 @@ Top Conditionals -* Pattern matching case statement:: How to use @code{pcase}. +* Pattern Matching Case Statement:: How to use @code{pcase}. Nonlocal Exits diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index 61ac80c..f5d3811 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -1368,7 +1368,7 @@ Changing Key Bindings 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 d2d38d7..81a1922 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -848,8 +848,8 @@ Named Features 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 1c90466..1b4d74f 100644 --- a/doc/lispref/markers.texi +++ b/doc/lispref/markers.texi @@ -340,10 +340,10 @@ Marker Insertion Types 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 ae79128..4c96e63 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi @@ -899,7 +899,7 @@ Mode Hooks 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 @@ Tabulated List Mode @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/processes.texi b/doc/lispref/processes.texi index 03ae1f0..4977d2c 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -506,7 +506,7 @@ Synchronous Processes @defun call-process-shell-command command &optional infile destination display This function executes the shell command @var{command} synchronously. The arguments are handled as in @code{call-process}. An old calling -convention allowed to pass any number of additional arguments after +convention allowed passing any number of additional arguments after @var{display}, which were concatenated to @var{command}; this is still supported, but strongly discouraged. @end defun @@ -515,7 +515,7 @@ Synchronous Processes This function is like @code{call-process-shell-command}, but uses @code{process-file} internally. Depending on @code{default-directory}, @var{command} can be executed also on remote hosts. An old calling -convention allowed to pass any number of additional arguments after +convention allowed passing any number of additional arguments after @var{display}, which were concatenated to @var{command}; this is still supported, but strongly discouraged. @end defun @@ -1382,12 +1382,13 @@ Process Buffers @end defun If the process's buffer is displayed in a window, your Lisp program -may wish telling the process the dimensions of that window, so that -the process could adapt its output to those dimensions, much as it -adapts to the screen dimensions. The following functions allow to -communicate this kind of information to processes; however, not all -systems support the underlying functionality, so it is best to provide -fallbacks, e.g., via command-line arguments or environment variables. +may wish to tell the process the dimensions of that window, so that +the process can adapt its output to those dimensions, much as it +adapts to the screen dimensions. The following functions allow your +program to communicate this kind of information to processes; however, +not all systems support the underlying functionality, so it is best to +provide fallbacks, e.g., via command-line arguments or environment +variables. @defun set-process-window-size process height width Tell @var{process} that its logical window size has dimensions diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 96f109b..7791c26 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -1376,10 +1376,10 @@ Undo 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 c1bd258..f514fcb 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 88f5f34..5077cb2 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