unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Yuri Khan <yuri.v.khan@gmail.com>
To: John Wiegley <johnw@gnu.org>, Eli Zaretskii <eliz@gnu.org>,
	 Michael Heerdegen <michael_heerdegen@web.de>,
	Emacs developers <emacs-devel@gnu.org>
Subject: Re: emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get'.
Date: Wed, 20 Jan 2016 13:31:08 +0600	[thread overview]
Message-ID: <CAP_d_8WxCDSYi3d=AYTmTcCZjpmCfH6s9sxmwXuH750AFY+ohA@mail.gmail.com> (raw)
In-Reply-To: <m2mvs1mow4.fsf@newartisans.com>

On Tue, Jan 19, 2016 at 11:59 PM, John Wiegley <jwiegley@gmail.com> wrote:

> We could start adding something like this at the bottom of such functions:
>
>   Invocations of this function may be used as a place expression to `setf'.
>
> That is, if we wish to encourage `setf' use. The other possibility is to add
> documentation to the Elisp manual where it describes `setf', and list all the
> functions that may be used by it. I have a feeling that would reach your
> intended audience better than extending the docstring for `alist-get'.

Good documentation advertises relationships between separately
documented entities at both ends.



  reply	other threads:[~2016-01-20  7:31 UTC|newest]

Thread overview: 39+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <20160116143238.27391.97533@vcs.savannah.gnu.org>
     [not found] ` <E1aKRuA-00078P-4T@vcs.savannah.gnu.org>
2016-01-19  9:53   ` emacs-25 2460cfa: * doc/lispref/lists.texi (Association Lists): Document 'alist-get' Michael Heerdegen
2016-01-19 17:45     ` Eli Zaretskii
2016-01-19 17:59       ` John Wiegley
2016-01-20  7:31         ` Yuri Khan [this message]
2016-01-20  7:40           ` John Wiegley
2016-01-20  9:33           ` Eli Zaretskii
2016-01-19 18:01       ` Michael Heerdegen
2016-01-19 18:32         ` Eli Zaretskii
2016-01-19 18:42           ` John Wiegley
2016-01-19 19:06             ` Eli Zaretskii
2016-01-19 19:25             ` Michael Heerdegen
2016-01-19 19:33             ` Stefan Monnier
2016-01-19 18:52           ` Michael Heerdegen
2016-01-19 19:17             ` Eli Zaretskii
2016-01-19 19:34               ` Michael Heerdegen
2016-01-19 19:46                 ` Eli Zaretskii
2016-01-19 20:09                   ` John Wiegley
2016-01-20 12:14                     ` Michael Heerdegen
2016-01-20 14:11                       ` Stefan Monnier
2016-01-20 17:37                         ` Michael Heerdegen
2016-01-20 22:08                           ` Stefan Monnier
2016-01-21 17:44                             ` Michael Heerdegen
2016-01-21 18:00                               ` Eli Zaretskii
2016-01-21 18:26                                 ` Eli Zaretskii
2016-01-21 18:41                                   ` Michael Heerdegen
2016-01-22  0:56                                   ` John Wiegley
2016-01-22  7:07                                     ` Eli Zaretskii
2016-01-22  7:39                                       ` John Wiegley
2016-01-22 12:01                                         ` Michael Heerdegen
2016-01-22 17:50                                           ` John Wiegley
2016-01-22 19:07                                             ` Michael Heerdegen
2016-01-22 19:15                                               ` Michael Heerdegen
2016-01-22 19:52                                                 ` John Wiegley
2016-03-07 14:38                                             ` John Wiegley
2016-03-08  5:04                                               ` Stefan Monnier
2016-03-08 17:17                                                 ` John Wiegley
2016-01-22 20:07                                           ` Richard Stallman
2016-01-22 11:58                                     ` Michael Heerdegen
2016-01-19 20:17                 ` Drew Adams

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CAP_d_8WxCDSYi3d=AYTmTcCZjpmCfH6s9sxmwXuH750AFY+ohA@mail.gmail.com' \
    --to=yuri.v.khan@gmail.com \
    --cc=eliz@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=johnw@gnu.org \
    --cc=michael_heerdegen@web.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).