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.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 15242 in the body.
You can then email your comments to 15242 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#15242; Package emacs. (Mon, 02 Sep 2013 04:09:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to Jambunathan K <kjambunathan <at> gmail.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Mon, 02 Sep 2013 04:09:02 GMT) Full text and rfc822 format available.

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'.
Reply sent to Jambunathan K <kjambunathan <at> gmail.com>:
You have taken responsibility. (Fri, 15 Nov 2013 04:34:02 GMT) Full text and rfc822 format available.
Notification sent to Jambunathan K <kjambunathan <at> gmail.com>:
bug acknowledged by developer. (Fri, 15 Nov 2013 04:34:03 GMT) Full text and rfc822 format available.

Message #10 received at 15242-done <at> debbugs.gnu.org (full text, mbox):

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.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Fri, 13 Dec 2013 12:24:14 GMT) Full text and rfc822 format available.
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.