[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#25461: [Patch #2]: Missing doc strings for "," and ",@".
From: |
Alan Mackenzie |
Subject: |
bug#25461: [Patch #2]: Missing doc strings for "," and ",@". |
Date: |
Tue, 24 Jan 2017 19:39:18 +0000 |
User-agent: |
Mutt/1.7.2 (2016-11-26) |
Hello, Noam.
On Mon, Jan 23, 2017 at 23:01:36 -0500, npostavs@users.sourceforge.net wrote:
> Alan Mackenzie <acm@muc.de> writes:
> > I've hacked all this together. What used to be called a "reader macro"
> > is now a "reader construct".
> I think "read syntax" is better just because the manual already uses
> that term.
I think this is a very fine point. "Read syntax" tends to distract
attention from the semantics, I think.
> > +;; Give `,' and `,@' documentation strings which can be examined by C-h f.
> > +(put '\, 'function-documentation
> > + "See `\\=`' (also `pcase') for the details of `,'.")
> > +(put '\, 'reader-construct t)
> > +
> > +(put '\,@ 'function-documentation
> > + "See `\\=`' or `,' for the details of `,@'.")
> Linking from ",@" to "," seems a bit unhelpful, since "," hardly says
> anything and just links to "`".
Thanks, I actually spotted that and removed it before committing a patch
yesterday.
--
Alan Mackenzie (Nuremberg, Germany).
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., (continued)
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Michael Heerdegen, 2017/01/18
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/19
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Michael Heerdegen, 2017/01/19
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/20
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Michael Heerdegen, 2017/01/20
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/21
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/21
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@"., Michael Heerdegen, 2017/01/23
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/24
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@"., npostavs, 2017/01/23
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@".,
Alan Mackenzie <=
- bug#25461: [Patch #2]: Missing doc strings for "," and ",@"., Noam Postavsky, 2017/01/24
- bug#25461: [Patch]: Missing doc strings for "," and ",@"., Alan Mackenzie, 2017/01/23