From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29334 invoked by alias); 23 Jan 2015 18:26:46 -0000 Mailing-List: contact zsh-users-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Users List List-Post: List-Help: X-Seq: 19774 Received: (qmail 6854 invoked from network); 23 Jan 2015 18:26:43 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 X-Authority-Analysis: v=2.1 cv=T/C1EZ6Q c=1 sm=1 tr=0 a=tPm6Y7HGW7GiZU4U+kPbzg==:117 a=tPm6Y7HGW7GiZU4U+kPbzg==:17 a=Hpgzp-inWqAA:10 a=N659UExz7-8A:10 a=MOOd648mkdnRcqJxQcsA:9 a=pILNOxqGKmIA:10 Message-id: <54C28B55.9030004@eastlink.ca> Date: Fri, 23 Jan 2015 09:56:37 -0800 From: Ray Andrews User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Icedove/31.3.0 MIME-version: 1.0 To: zsh-users@zsh.org Subject: Re: zparseopts help References: <150123091511.ZM1667@torch.brasslantern.com> In-reply-to: <150123091511.ZM1667@torch.brasslantern.com> Content-type: text/plain; charset=windows-1252; format=flowed Content-transfer-encoding: 7bit On 01/23/2015 09:15 AM, Bart Schaefer wrote: > On Jan 23, 10:39am, TJ Luoma wrote: > } > } I took a look through the `man` entry, but I don't know what it is about > } my brain, but I can read and re-read man pages and still fail to understand > } what it is saying. I do much better with examples. > > Not uncommon ... if we could find some volunteers to write more examples > for the manual, that would be nice. I'm glad to hear that it would even be welcomed. When I've ranted against the general helpfulness of docs (not just here, and not just zsh docs, but throughout the Linux world), I'm usually met with a stout defense of the status quo. Zsh docs are written very much in the standard style of Linux docs in general, that dust dry, list-of-facts that does anything but help you learn. I'd be very interested in working on docs, but so far my preliminary efforts have been rebuffed without comment.