From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 23 Feb 2025 05:23:33 +0000 (+0200)
Subject: ; Fix documentation of recent changes
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=99645690f487ff8a02314077bf92e2258641c52a;p=emacs.git

; 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 29105959ecd..c38aa7cd62d 100644
--- 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