From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 9026 invoked from network); 19 Sep 2006 10:14:38 -0000 X-Spam-Checker-Version: SpamAssassin 3.1.5 (2006-08-29) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-2.5 required=5.0 tests=BAYES_00,FORGED_RCVD_HELO autolearn=ham version=3.1.5 Received: from news.dotsrc.org (HELO a.mx.sunsite.dk) (130.225.247.88) by ns1.primenet.com.au with SMTP; 19 Sep 2006 10:14:38 -0000 Received-SPF: none (ns1.primenet.com.au: domain at sunsite.dk does not designate permitted sender hosts) Received: (qmail 60879 invoked from network); 19 Sep 2006 10:14:32 -0000 Received: from sunsite.dk (130.225.247.90) by a.mx.sunsite.dk with SMTP; 19 Sep 2006 10:14:32 -0000 Received: (qmail 1707 invoked by alias); 19 Sep 2006 10:14:21 -0000 Mailing-List: contact zsh-users-help@sunsite.dk; run by ezmlm Precedence: bulk X-No-Archive: yes X-Seq: 10741 Received: (qmail 1695 invoked from network); 19 Sep 2006 10:14:20 -0000 Received: from news.dotsrc.org (HELO a.mx.sunsite.dk) (130.225.247.88) by sunsite.dk with SMTP; 19 Sep 2006 10:14:20 -0000 Received: (qmail 59602 invoked from network); 19 Sep 2006 10:14:20 -0000 Received: from fw.sigpipe.cz (HELO isis.sigpipe.cz) (62.245.70.224) by a.mx.sunsite.dk with SMTP; 19 Sep 2006 10:14:18 -0000 Received: from dagan.sigpipe.cz (dagan.sigpipe.cz [10.9.8.90]) by isis.sigpipe.cz (Postfix) with ESMTP id A36771F87BF2; Tue, 19 Sep 2006 12:14:16 +0200 (CEST) Received: by dagan.sigpipe.cz (Postfix, from userid 1001) id 5AE922C90ED; Tue, 19 Sep 2006 12:14:47 +0000 (UTC) Date: Tue, 19 Sep 2006 12:14:47 +0000 From: Roman Neuhauser To: Peter Stephenson Cc: zsh users Subject: Re: comments toward completion system docs Message-ID: <20060919121447.GA39612@dagan.sigpipe.cz> Mail-Followup-To: Peter Stephenson , zsh users References: <20060919000634.GA29030@dagan.sigpipe.cz> <25694.1158658045@csr.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <25694.1158658045@csr.com> User-Agent: Mutt/1.5.11 # pws@csr.com / 2006-09-19 10:27:25 +0100: > Thanks for the comments, I'll try and fold them in when I get a chance. > Detailed comments like the ones you sent are much more likely to > help than vague ones like "I didn't understand this bit", since > unfortunately no one has time to rewrite things from scratch without > some idea of where they're going. Sure, that's basic common sense, and also the reason I agonized over the introduction sketch for a few days. I wanted to offer more than a "wtf?" when I was going to ask. So I kept reading, and got in a kind of loop: didn't understand, and wanted to offer more than a "wtf?"... etc. Really, as I'm reading the manual again and again looking up what I think /might/ be the right API, or just useful for what I want to do, I run into various bits of the introductory information hidden at different places. It's all there, only in a suboptimal form, so pulling it up should be quite doable. > You might notice in 4.3 there's now a "roadmap" manual page to try > to introduce various of the more interesting parts of the manual. I'm looking forward to reading it when 4.3 comes out. > By the way, you should have seen the documentation for _arguments > before I massaged it. At that point, *I* could hardly understand it. I appreciate the hard work that's been put into both books. Documentation is hard. -- How many Vietnam vets does it take to screw in a light bulb? You don't know, man. You don't KNOW. Cause you weren't THERE. http://bash.org/?255991