From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from euclid.skiles.gatech.edu (list@euclid.skiles.gatech.edu [130.207.146.50]) by melb.werple.net.au (8.7.5/8.7.3/2) with ESMTP id CAA28789 for ; Fri, 14 Jun 1996 02:07:35 +1000 (EST) Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id LAA22765; Thu, 13 Jun 1996 11:57:22 -0400 (EDT) Resent-Date: Thu, 13 Jun 1996 11:57:22 -0400 (EDT) From: "Bart Schaefer" Message-Id: <960613083033.ZM32367@candle.brasslantern.com> Date: Thu, 13 Jun 1996 08:30:29 -0700 In-Reply-To: Clive Messer "Re: zsh.texi" (Jun 13, 2:49pm) References: Reply-To: schaefer@nbn.com X-Mailer: Z-Mail (4.0b.607 07jun96) To: Clive Messer Subject: Re: zsh.texi Cc: Mark Borges , zsh-workers@math.gatech.edu MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Resent-Message-ID: <"nHmhz2.0.aZ5.Xf3mn"@euclid> Resent-From: zsh-workers@math.gatech.edu X-Mailing-List: archive/latest/1348 X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu On Jun 13, 2:49pm, Clive Messer wrote: } Subject: Re: zsh.texi } } > -C controls completion when there is no current command, in other words } > when the command word itself is being completed. Without this command, } } This is a direct copy of zshcompctl.man. } Perhaps it needs to be clarified in the man page. } } > If the + flag is alone and followed immediately by the command list, the } } Again, this is a direct copy of the man page. } } > As a general remark, this sort of documentation should avoid talking } > about how a given operation is accomplished (e.g., above, dump the "by } > deleting the command from the list ... handled specially") and just } > state what the end result is. Only discuss how something works if } > that's important for using the feature correctly; and even then, *first* } > concisely describe the end result, and *then* elaborate how it comes to } > pass. } } I did not set out to re-write the man pages, just port them to texinfo. Aha. I haven't read through all the new man pages. Well, then, whoever is maintaining the manual pages should consider the above as commentary on those, and it should get fixed in *both* places. ;-> -- Bart Schaefer Brass Lantern Enterprises http://www.well.com/user/barts http://www.nbn.com/people/lantern New male in /home/schaefer: >N 2 Justin William Schaefer Sat May 11 03:43 53/4040 "Happy Birthday"