all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: karl@freefriends.org (Karl Berry)
Subject: reliably determining if an Info node is an index
Date: Thu, 19 Feb 2004 12:07:01 -0500	[thread overview]
Message-ID: <200402191707.i1JH71u10764@f7.net> (raw)

[-- Attachment #1: message body text --]
[-- Type: text/plain, Size: 1194 bytes --]

Back in June 2003, we discussed methods for reliably determining if an
Info node is an index node.  This is to make the ][ commands work
better, among other reasons.  See this message from Luc and the
containing thread for background:
http://mail.gnu.org/archive/html/emacs-devel/2003-06/msg00657.html

Our conclusion was that the best approach would be for makeinfo to write
a magic cookie indicating "this is an index" into index nodes.

We are now approaching the next Texinfo release.  Here is my question:
is the collective wisdom that I should write this cookie now, before an
Emacs release has been made that supports it?  Or should I wait?

If  a user reads an Info file with the cookie when Emacs doesn't support
it, it will be displayed, thus:
^@^H[index^@^H]
(except with real control characters).  This does no harm, but I can see
users being confused or thinking it is a bug if they see it.

It doesn't matter to me.

I'll attach an example info file with the cookie.  It also shows the
(line NNN) feature for precisely locating index entries that we
discussed in another thread.  I hope someone will be able to work on
using the line numbers in the Emacs Info reader.

Thanks,
k


[-- Attachment #2: indexcookie.info --]
[-- Type: application/octet-stream, Size: 540 bytes --]

[-- Attachment #3: Type: text/plain, Size: 141 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

             reply	other threads:[~2004-02-19 17:07 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2004-02-19 17:07 Karl Berry [this message]
2004-02-21 14:55 ` reliably determining if an Info node is an index Richard Stallman
2004-02-23 18:05   ` Karl Berry
2004-02-25 13:24     ` Richard Stallman
2004-02-25 15:43       ` Emacs release numbering 21.4 vs. 22.1 Kim F. Storm
2004-02-25 16:23         ` David Kastrup
2004-02-25 17:39           ` Stefan Monnier
2004-02-25 18:07             ` David Kastrup

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=200402191707.i1JH71u10764@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 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.