Zsh Mailing List Archive
Messages sorted by:
Re: Better Help Docs Searching?
- X-seq: zsh-users 26829
- From: Stephane Chazelas <stephane@xxxxxxxxxxxx>
- To: Mikael Magnusson <mikachu@xxxxxxxxx>
- Cc: Zach Riggle <zachriggle@xxxxxxxxx>, Zsh Users <zsh-users@xxxxxxx>
- Subject: Re: Better Help Docs Searching?
- Date: Sun, 1 Aug 2021 17:33:14 +0100
- Archived-at: <https://zsh.org/users/26829>
- In-reply-to: <CAHYJk3RSxeUAgmAGUgHa+TRnzm8Dnb9_a49iYOzi4BWsKfPQbw@mail.gmail.com>
- List-id: <zsh-users.zsh.org>
- Mail-followup-to: Mikael Magnusson <mikachu@xxxxxxxxx>, Zach Riggle <zachriggle@xxxxxxxxx>, Zsh Users <zsh-users@xxxxxxx>
- References: <CAMP9c5m=oOwSvEaqVF62GF0=BjjMnS8fBEmbcWz9ydxqx=tvZQ@mail.gmail.com> <CAHYJk3RSxeUAgmAGUgHa+TRnzm8Dnb9_a49iYOzi4BWsKfPQbw@mail.gmail.com>
2021-08-01 18:21:14 +0200, Mikael Magnusson:
> You can also find these in the pdf version of the documentation (not
> sure if we provide this anywhere but you can build it yourself). The
> info version also probably has them, but I'm not sure if anyone knows
> how to navigate an info document.
I only use "info" for reading the zsh manual (or any manual
larger than a few pages and that has an info manual, there's a
good reason we talk of man pages, and not man books, man is
really not adequate for a manual the size of zsh's).
In info, the "i" and "I" commands are your friends. They search
the index and have completion. There's also "g" to search the
nodes (the table of contents).
In zsh, the index is very good.
info zsh read
Will bring you to the section about the read builtin.
Within "info zsh", press "I" (Shift+i) and enter "read", and
you'll see all the index entries that contain "read".
IIRC, zsh completion also used to work properly with "info", but
as seen in the other thread I started in zsh-workers, it's
a bit broken currently. No big deal as info's own completion is
Press "h" within "info" to get started with it.
It's really astonishing that so few people know about it after
so many decades it's been around.
Messages sorted by: