; Fix documentation of recent changes

* etc/NEWS:
* doc/lispref/numbers.texi (Arithmetic Operations): Fix wording
and markup.

(cherry picked from commit 4abeb75a51634641185f80a747f9d8b3debcedd2)

diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi
index 29105959ecda1c5c3b08aa1972fa7254b3f12246..c38aa7cd62d11711c3fd95b9498f661ab598bd11 100644 (file)
--- a/doc/lispref/numbers.texi
+++ b/doc/lispref/numbers.texi
@@ -683,17 +683,17 @@ This function returns @var{number-or-marker} minus 1.
 
 @defmac incf place &optional delta
 This macro increments the number stored in @var{place} by one, or
-by @var{delta} if specified.  The incremented value is returned.
+by @var{delta} if specified.  It returns the incremented value.
 
-@var{place} can be a symbol or a generalized variable, @xref{Generalized
-Variables}.  For example, @code{(incf i)} is equivalent to
-@code{(setq i (1+ i))}, and @code{(incf (car x) 2)} is equivalent to
-@code{(setcar x (+ (car x) 2))}.
+@var{place} can be a symbol or a generalized variable,
+@pxref{Generalized Variables}.  For example, @w{@samp{(incf i)}} is
+equivalent to @w{@samp{(setq i (1+ i))}}, and @w{@samp{(incf (car x)
+2)}} is equivalent to @w{@samp{(setcar x (+ (car x) 2))}}.
 @end defmac
 
 @defmac decf place &optional delta
 This macro decrements the number stored in @var{place} by one, or
-by @var{delta} if specified.  The decremented value is returned.
+by @var{delta} if specified.  It returns the decremented value.
 @end defmac
 
 @defun + &rest numbers-or-markers