From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 18707 invoked from network); 30 Apr 2007 08:01:36 -0000 X-Spam-Checker-Version: SpamAssassin 3.1.8 (2007-02-13) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=AWL,BAYES_00,FORGED_RCVD_HELO autolearn=ham version=3.1.8 Received: from news.dotsrc.org (HELO a.mx.sunsite.dk) (130.225.247.88) by ns1.primenet.com.au with SMTP; 30 Apr 2007 08:01:36 -0000 Received-SPF: none (ns1.primenet.com.au: domain at sunsite.dk does not designate permitted sender hosts) Received: (qmail 36130 invoked from network); 30 Apr 2007 08:01:30 -0000 Received: from sunsite.dk (130.225.247.90) by a.mx.sunsite.dk with SMTP; 30 Apr 2007 08:01:30 -0000 Received: (qmail 21608 invoked by alias); 30 Apr 2007 08:01:26 -0000 Mailing-List: contact zsh-workers-help@sunsite.dk; run by ezmlm Precedence: bulk X-No-Archive: yes X-Seq: 23360 Received: (qmail 21597 invoked from network); 30 Apr 2007 08:01:24 -0000 Received: from news.dotsrc.org (HELO a.mx.sunsite.dk) (130.225.247.88) by sunsite.dk with SMTP; 30 Apr 2007 08:01:24 -0000 Received: (qmail 35801 invoked from network); 30 Apr 2007 08:01:24 -0000 Received: from smtpout0152.sc1.he.tucows.com (HELO n064.sc1.he.tucows.com) (64.97.136.152) by a.mx.sunsite.dk with SMTP; 30 Apr 2007 08:01:21 -0000 Received: from sc.homeunix.net (82.26.169.33) by n064.sc1.he.tucows.com (7.2.069.1) id 4630CEFC0004AFCE; Mon, 30 Apr 2007 08:01:19 +0000 Received: from chazelas by sc.homeunix.net with local (Exim 4.67) (envelope-from ) id 1HiQou-0001kS-47; Mon, 30 Apr 2007 09:01:16 +0100 Date: Mon, 30 Apr 2007 09:01:16 +0100 From: Stephane Chazelas To: Dave Yost Cc: zsh-workers@sunsite.dk Subject: Re: manual all on one HTML page Message-ID: <20070430080116.GB4961@sc.homeunix.net> Mail-Followup-To: Dave Yost , zsh-workers@sunsite.dk References: <20070430061326.GA4961@sc.homeunix.net> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.5.6i On Mon, Apr 30, 2007 at 12:24:41AM -0700, Dave Yost wrote: > 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. Yes, but makes the browsing (reaching the section you're interested in) difficult. > 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 Yes, we agree that's the problem, you need some external tool to index your pages, as HTML has not such thing built in. The index and search are built in "info". I'd agree the "info" client command is not the best that one could have come up to, but at least the "info" format makes it very easy and direct to reach the information you're looking for. And zsh has completion support (to some extent) for info. -- Stéphane