From: Eli Zaretskii Date: Tue, 11 Jun 2019 16:55:14 +0000 (+0300) Subject: Consistently use @minus{} for negative arguments X-Git-Tag: emacs-26.2.90~5 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7be50cda56ae0d2a31b8e2ae918409feeddaf6ca;p=emacs.git Consistently use @minus{} for negative arguments * doc/emacs/mark.texi (Marking Objects): * doc/misc/gnus.texi (Selecting a Group): * doc/emacs/programs.texi (Comment Commands): * doc/emacs/killing.texi (Deletion): * doc/emacs/display.texi (Recentering): * doc/lispref/display.texi (Face Attributes): * doc/lispref/searching.texi (String Search, Regexp Search): Make the markup of "-N" use @minus{} uniformly. (Bug#35885) --- diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index 70b88dc92d0..435c21fe738 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi @@ -202,7 +202,7 @@ screen lines between point and the top or bottom of the window argument, @kbd{C-u C-l}, simply recenters the line showing point. A positive argument @var{n} moves line showing point @var{n} lines down from the top of the window. An argument of zero moves point's line to -the top of the window. A negative argument @var{-n} moves point's +the top of the window. A negative argument @minus{}@var{n} moves point's line @var{n} lines from the bottom of the window. When given an argument, @kbd{C-l} does not clear the screen or cycle through different screen positions. diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi index 2d56f1d26e1..9b9c890331e 100644 --- a/doc/emacs/killing.texi +++ b/doc/emacs/killing.texi @@ -124,7 +124,7 @@ point, regardless of the number of spaces that existed previously (even if there were none before). With a numeric argument @var{n}, it leaves @var{n} spaces before point if @var{n} is positive; if @var{n} is negative, it deletes newlines in addition to spaces and tabs, -leaving @var{-n} spaces before point. The command @code{cycle-spacing} +leaving @minus{}@var{n} spaces before point. The command @code{cycle-spacing} acts like a more flexible version of @code{just-one-space}. It does different things if you call it repeatedly in succession. The first call acts like @code{just-one-space}, the next removes diff --git a/doc/emacs/mark.texi b/doc/emacs/mark.texi index 8ad5fc7c9e4..bbeb4cb039e 100644 --- a/doc/emacs/mark.texi +++ b/doc/emacs/mark.texi @@ -193,8 +193,8 @@ located before point, @kbd{M-@@} moves the mark backwards from its current position one word at a time. This command also accepts a numeric argument @var{n}, which tells it -to advance the mark by @var{n} words. A negative argument moves the -mark back by @var{n} words. +to advance the mark by @var{n} words. A negative argument +@minus{}@var{n} moves the mark back by @var{n} words. @kindex C-M-@@ @findex mark-sexp diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index df14fd8a05a..1d6f3e0459a 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -1003,7 +1003,7 @@ delimiters to enclose the text in the region. If you supply a prefix argument to @kbd{M-;} when a region is active, that specifies the number of comment delimiters to add or delete. A positive argument @var{n} adds @var{n} delimiters, while a -negative argument @var{-n} removes @var{n} delimiters. +negative argument @minus{}@var{n} removes @var{n} delimiters. If the region is not active, and there is no existing comment on the current line, @kbd{M-;} adds a new comment to the current line. If @@ -1034,10 +1034,11 @@ lines. When a region is active (@pxref{Mark}), @kbd{C-x C-;} either comments or uncomments the lines in the region. If the region is not active, this command comments or uncomments the line point is on. With a positive prefix argument @var{n}, it operates on @var{n} lines -starting with the current one; with a negative @var{n}, it affects -@var{n} preceding lines. After invoking this command with a negative -argument, successive invocations with a positive argument will operate -on preceding lines as if the argument were negated. +starting with the current one; with a negative argument +@minus{}@var{n}, it affects @var{n} preceding lines. After invoking +this command with a negative argument, successive invocations with a +positive argument will operate on preceding lines as if the argument +were negated. @findex comment-kill @kindex C-u M-; diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 2ff73b08bdb..b6fda1cd807 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2369,7 +2369,7 @@ Draw a box with lines of width 1, in color @var{color}. @item @code{(:line-width @var{width} :color @var{color} :style @var{style})} This way you can explicitly specify all aspects of the box. The value @var{width} specifies the width of the lines to draw; it defaults to -1. A negative width @var{-n} means to draw a line of width @var{n} +1. A negative width @minus{}@var{n} means to draw a line of width @var{n} whose top and bottom parts occupy the space of the underlying text, thus avoiding any increase in the character height. diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index 0cf527b6ac7..2e951d0d5d7 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -101,7 +101,7 @@ previous match. If all these successive searches succeed, the function call succeeds, moving point and returning its new value. Otherwise the function call fails, with results depending on the value of @var{noerror}, as described above. If @var{count} is a negative -number -@var{n}, the search is done @var{n} times in the opposite +number @minus{}@var{n}, the search is done @var{n} times in the opposite (backward) direction. @end deffn @@ -1091,7 +1091,7 @@ previous match. If all these successive searches succeed, the function call succeeds, moving point and returning its new value. Otherwise the function call fails, with results depending on the value of @var{noerror}, as described above. If @var{count} is a negative -number -@var{n}, the search is done @var{n} times in the opposite +number @minus{}@var{n}, the search is done @var{n} times in the opposite (backward) direction. In the following example, point is initially before the @samp{T}. diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 0d4cf970848..ee504f5d351 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -2128,7 +2128,7 @@ considered big. The default value is 200. If the group has more (unread and/or ticked) articles than this, Gnus will query the user before entering the group. The user can then specify how many articles should be fetched from the server. If the user specifies a -negative number (@var{-n}), the @var{n} oldest articles will be +negative number (@minus{}@var{n}), the @var{n} oldest articles will be fetched. If it is positive, the @var{n} articles that have arrived most recently will be fetched.