GNU bug report logs - #15242
(info "(cl) Structures"): setf should be prominent

Previous Next

Package: emacs;

Reported by: Jambunathan K <kjambunathan <at> gmail.com>

Date: Mon, 2 Sep 2013 04:09:01 UTC

Severity: minor

Done: Jambunathan K <kjambunathan <at> gmail.com>

Bug is archived. No further changes may be made.

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Jambunathan K <kjambunathan <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: (info "(cl) Structures"): setf should be prominent
Date: Mon, 02 Sep 2013 09:39:54 +0530

In the Info node below, 

    ,---- (info "(cl) Structures")
    |  You can also change these slots by using `setf' on any of these
    |  place forms, for example:
    | 
    |           (cl-incf (person-age birthday-boy))
    `----

the use of `cl-incf' as an example for `setf' is a bit....unhelpful
(considering the context).

I suggest that the "set accessor" be made prominent, by introducing it
NOT as a sentence but as a paragraph in it's own right.  The example
SHOULD illustrate `setf' and NOT `incf'.
This bug report was last modified 11 years and 194 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.