GNU bug report logs - #31623
27.0; Elisp manual, index entry "; in comment"

Previous Next

Full log

Message #20 received at 31623 <at> debbugs.gnu.org (full text, mbox):

From: Noam Postavsky <npostavs <at> gmail.com>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 31623 <at> debbugs.gnu.org
Subject: Re: bug#31623: 27.0; Elisp manual, index entry "; in comment"
Date: Tue, 29 May 2018 21:58:10 -0400

Drew Adams <drew.adams <at> oracle.com> writes:

>> > If that's the intention then I think it might be clearer
>> > if the index entry were "; outside a comment" or maybe
>> > "; not in a comment".

> But certainly the `;' that starts a comment is part of the
> comment itself.  No one would doubt that, I think.

I'm a bit puzzled then.  How would "; outside a comment" make sense for
a page which talks about comments?  That seems to be the opposite of
what it's about.

> The entry should indicate something about the subject
> indexed.  "; in comment" does not do that, for me, at
> least.

What do you think about the "(...) in lists" entry?

> Or perhaps you have a suggestion.

I don't really see a problem with the current one, but I guess "; for
commenting" (in the same vein as "' for quoting") could be okay.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.