all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Alan Mackenzie <acm@muc.de>
To: Nicolas Richard <nrichard@ulb.ac.be>
Cc: 22192-done@debbugs.gnu.org
Subject: bug#22192: Doc string of macroexp-let2 is obscure.
Date: Thu, 17 Dec 2015 13:14:26 +0000	[thread overview]
Message-ID: <20151217131426.GB2988@acm.fritz.box> (raw)
In-Reply-To: <87r3il45sf.fsf@ulb.ac.be>

Hello, Nicolas.

On Thu, Dec 17, 2015 at 01:29:36PM +0100, Nicolas Richard wrote:
> Alan Mackenzie <acm@muc.de> writes:
> >     "Bind VAR to a copyable expression that returns the value of EXP.
> >     This is like `(let ((v ,EXP)) ,EXPS) except that `v' is a new generated
> >     symbol which EXPS can find in VAR.
> >     TEST should be the name of a predicate on EXP checking whether the `let' can
> >     be skipped; if nil, as is usual, `macroexp-const-p' is used."

> > This macro is widely used (over 50 times) in Emacs, and is not
> > documented in the Elisp manual.  The doc string is difficult to
> > understand.

> I agree that the docstring was pretty obscure, but it was modified
> in commit 5e3fde03b45877d3e30f859a14c10043e637aa63 

Yes, I was looking at the 24.5 version.  Thanks for the reply, and sorry
for wasting your time.  I will close the bug.

> It now is :

[ .... ]

That looks fine!

> -- 
> Nicolas

-- 
Alan Mackenzie (Nuremberg, Germany).





      reply	other threads:[~2015-12-17 13:14 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-12-17 10:09 bug#22192: Doc string of macroexp-let2 is obscure Alan Mackenzie
2015-12-17 12:29 ` Nicolas Richard
2015-12-17 13:14   ` Alan Mackenzie [this message]

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

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

  git send-email \
    --in-reply-to=20151217131426.GB2988@acm.fritz.box \
    --to=acm@muc.de \
    --cc=22192-done@debbugs.gnu.org \
    --cc=nrichard@ulb.ac.be \
    /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 external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.