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


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Jambunathan K <kjambunathan <at> gmail.com>
Subject: bug#15242: closed (Re: bug#15242: (info "(cl) Structures"): setf
 should be prominent)
Date: Fri, 15 Nov 2013 04:34:03 +0000
[Message part 1 (text/plain, inline)]
Your bug report

#15242: (info "(cl) Structures"): setf should be prominent

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 15242 <at> debbugs.gnu.org.

-- 
15242: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=15242
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Jambunathan K <kjambunathan <at> gmail.com>
To: 15242-done <at> debbugs.gnu.org
Subject: Re: bug#15242: (info "(cl) Structures"): setf should be prominent
Date: Fri, 15 Nov 2013 10:03:09 +0530
OP here.  Closing it.


[Message part 3 (message/rfc822, inline)]
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.