zsh-workers
 help / color / mirror / code / Atom feed
From: "Bart Schaefer" <schaefer@candle.brasslantern.com>
To: "Andrej Borsenkow" <Andrej.Borsenkow@mow.siemens.ru>,
	"ZSH workers mailing list" <zsh-workers@sunsite.auc.dk>
Subject: Re: Zsh info index problems
Date: Wed, 5 Apr 2000 15:09:53 +0000	[thread overview]
Message-ID: <1000405150953.ZM14928@candle.brasslantern.com> (raw)
In-Reply-To: <000501bf9ef1$e272e230$21c9ca95@mow.siemens.ru>

On Apr 5,  3:27pm, Andrej Borsenkow wrote:
} Subject: Zsh info index problems
}
} i zcompile
} 
} gives me the first lines of shell builtins (description of autoload,
} where zcompile is mentioned) and _not_ zcompile itself.
} 
} i globbing, qualifiers
} 
} ends here:
} 
}      treated specially the way they usually are in globbing.
}                                                    ^^^^^ this word
} 
} Is it the problem of info or something wrong with our info files?

It's the problem of info.  In the printed index, the page numbers will
be much more accurate.

The way indexing is implemented is by jumping to the referenced node and
then searching for the first word (actually, the string up to the first
comma, or the whole string if there isn't any comma) in the index entry.

E.g. if you look in the Concept Index (m Concept Index RET) at the
"aliases, completion of" entry, you'll see "Description of Options" as
the node reference.  So `i aliases, completion RET' first searches the
index and finds "aliases, completion of"; it grabs the first word (up
to the comma) and the node reference; and then jumps to "Description
of Options" searches forward for "aliases".

In that particular case, that gets it to the right spot.  In the case of
zcompile, it finds the first use rather than the definition.  I generally
follow `i' with a search (in emacs info mode, that's just `C-s C-w C-s'
but in standalone info you have to actually type the word).

There are a few cases where we could force the search to be more accurate
by using less-human-friendly strings in the part up to the comma, but not
very many.

-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com


      reply	other threads:[~2000-04-05 15:10 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2000-04-05 11:27 Andrej Borsenkow
2000-04-05 15:09 ` Bart Schaefer [this message]

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=1000405150953.ZM14928@candle.brasslantern.com \
    --to=schaefer@candle.brasslantern.com \
    --cc=Andrej.Borsenkow@mow.siemens.ru \
    --cc=zsh-workers@sunsite.auc.dk \
    /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.vuxu.org/mirror/zsh/

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 NNTP newsgroup(s).