Re: manual all on one HTML page

[Dave Yost <Dave@xxxxxxxx>]

At 07:13 AM +0100 2007-04-30, Stephane Chazelas wrote:
>On Sun, Apr 29, 2007 at 05:49:07PM -0700, Dave Yost wrote:
>> Hi.
>>
>> There really should be an all-on-one-page HTML manual.
>>
>> I tried to look for the exec command using the current divided-up
>> HTML and couldn't find it.
>[...]
>
>That's the biggest problem with the HTML format.

The one-page format makes simple searches easy using the browser.

Also: the broken-up HTML is nicely searchable with a Google using the "site:" feature, like this:
  foo site:zsh.org/doc/one-page.html

Dave

>That's why
>there exist more advanced formats like the "info" formats. The
>info format is inspired from books. There is a table of content
>and an index, both searchable with completion, and the whole
>document can be searched as well.
>
>See the "g", "i", "m", "s" keys in info.
>
>Typically:
>
>info zsh
>iexec<Tab>
>
>--
>Stéphane