From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5174 invoked by alias); 10 Feb 2011 15:04:58 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 28728 Received: (qmail 8261 invoked from network); 10 Feb 2011 15:04:57 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received-SPF: none (ns1.primenet.com.au: domain at closedmail.com does not designate permitted sender hosts) From: Bart Schaefer Message-id: <110210070431.ZM30121@torch.brasslantern.com> Date: Thu, 10 Feb 2011 07:04:31 -0800 In-reply-to: Comments: In reply to cheer_xiao "Re: Bug in user guide" (Feb 10, 9:42am) References: <87ei7h2z52.fsf@ft.bewatermyfriend.org> X-Mailer: OpenZMail Classic (0.9.2 24April2005) To: zsh-workers@zsh.org Subject: Re: Bug in user guide MIME-version: 1.0 Content-type: text/plain; charset=us-ascii On Feb 10, 9:42am, cheer_xiao wrote: } Subject: Re: Bug in user guide } } Some more thoughts about the user guide. The guide is, overall, well } written. But I found two features missing in the user guide: } 1) Mark the terms appearing for the first time in *bold*, } 2) A comprehensive index. } Does that sound fine to you all? If so, I'll take some time to improve } the guide and post my improve version to the mailing list. Just to be sure ... you're talking about http://zsh.sourceforge.net/Guide/zshguide.html ?? We'd certainly welcome any help with the guide (or any other docs, for that matter) so do jump in and send us suggested improvements. As for (1) in particular ... although the guide can be read linearly it's really more intended to to be navigated as hypertext, so adding more cross-references to places where terms are explained would probably be more useful than merely highlighting the "first" place they are used. Which ought to be possible if you're constructing an index anyway. Based on SourceForge's progress so far we might have our CVS back by sometime on Friday.