From: karl@freefriends.org (Karl Berry)
Subject: Re: Indices in Info.
Date: Tue, 24 Jun 2003 09:26:14 -0400 [thread overview]
Message-ID: <200306241326.h5ODQEc27294@f7.net> (raw)
> * $Id:: GNU Sample Texts.
I removed the :'s from these index entries in texinfo.txi.
"Emacs should be able to handle this correctly"
Yes it should. Regardless of the (newline) example (see below),
consider this index entry:
@cindex (dir) as Up node of Top node
Here, the parentheses are meaningful and correct. I could also imagine
wanting to index ( in a programming language manual. I'm sure there are
other index entries that start with ( out there as well, since it's
always been allowed.
or "starting an index entry with a parenthetical remark makes no sense"?
In this particular instance, it definitely would
seem more logical to have entries named "newline", "space" and "tab",
This is in the command index. The manual is not talking about a command
@newline. It's talking about @<the-newline-character>. That's why I
put the parentheses in. I suppose angle brackets instead of parentheses
might be slightly better. I changed it.
But that's irrelevant to the question of whether index entries can start
with (. They should be able to. And the leading parentheses work in
Emacs 21.3, at least they do for me. So perhaps this got broken in the
current source code ...
IMHO, these tricky cases should be solved by a change in the Info file
format
Yes, I agree, as we've discussed before. We shouldn't make complicated
rules about when colons are acceptable and when they're not, according
to the regexp du jour. Instead, we should just support everything.
Until that glorious day arrives, I'm not worried about discrepancies
between emacs-info and standalone-info in this regard. I don't see any
need to document exactly which cases work and which don't in which
reader, since it all changes from version to version anyway.
Thanks,
karl
next reply other threads:[~2003-06-24 13:26 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2003-06-24 13:26 Karl Berry [this message]
2003-06-24 14:04 ` Indices in Info Andreas Schwab
2003-06-25 1:35 ` Luc Teirlinck
2003-06-25 1:55 ` Luc Teirlinck
2003-06-25 3:26 ` Luc Teirlinck
2003-06-25 17:50 ` Stefan Monnier
2003-06-25 19:53 ` Richard Stallman
-- strict thread matches above, loose matches on Subject: below --
2003-06-24 14:08 Karl Berry
2003-06-24 3:42 Luc Teirlinck
2003-06-24 4:17 ` Eli Zaretskii
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=200306241326.h5ODQEc27294@f7.net \
--to=karl@freefriends.org \
/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).