all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Noam Postavsky <npostavs@gmail.com>
To: Drew Adams <drew.adams@oracle.com>
Cc: 31623@debbugs.gnu.org
Subject: bug#31623: 27.0; Elisp manual, index entry "; in comment"
Date: Tue, 29 May 2018 21:58:10 -0400	[thread overview]
Message-ID: <871sdtdhvx.fsf@gmail.com> (raw)
In-Reply-To: <4fc08e13-4c43-4f4b-a9ad-0ce221b9d4ea@default> (Drew Adams's message of "Tue, 29 May 2018 17:38:49 -0700 (PDT)")

Drew Adams <drew.adams@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.





  reply	other threads:[~2018-05-30  1:58 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-05-28 14:35 bug#31623: 27.0; Elisp manual, index entry "; in comment" Drew Adams
2018-05-29 23:32 ` Noam Postavsky
2018-05-29 23:47   ` Drew Adams
2018-05-30  0:14     ` Noam Postavsky
2018-05-30  0:38       ` Drew Adams
2018-05-30  1:58         ` Noam Postavsky [this message]
2018-05-30  2:23           ` Drew Adams
2018-06-20 12:48           ` Noam Postavsky

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=871sdtdhvx.fsf@gmail.com \
    --to=npostavs@gmail.com \
    --cc=31623@debbugs.gnu.org \
    --cc=drew.adams@oracle.com \
    /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.