From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5305 invoked by alias); 23 Oct 2013 16:02:07 -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: 31872 Received: (qmail 2320 invoked from network); 23 Oct 2013 16:01:49 -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=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2 From: Bart Schaefer Message-id: <131023090131.ZM9876@torch.brasslantern.com> Date: Wed, 23 Oct 2013 09:01:31 -0700 In-reply-to: <20131023144700.43a7849a@pwslap01u.europe.root.pri> Comments: In reply to Peter Stephenson "Re: Glob problem" (Oct 23, 2:47pm) References: <65DB21EB-86B6-479C-8F25-35B9B832CFD5@gmail.com> <5266BFF6.4050004@oracle.com> <20131023.051117.47078782.ghostrevery@gmail.com> <91F9ED9F-B198-403B-9FE1-FF40DE960C1C@gmail.com> <20131023144700.43a7849a@pwslap01u.europe.root.pri> X-Mailer: OpenZMail Classic (0.9.2 24April2005) To: zsh-workers@zsh.org Subject: Documenting "--" (was Re: Glob problem) MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Redirected to zsh-workers. On Oct 23, 2:47pm, Peter Stephenson wrote: } } Some of the regulars can tell me if the following looks right. Apologies if the following is too nit-picky ... } +Some shell builtin commands take options as given in invidiual entries. Am I correct in understanding "given" here to mean "described"? If so, just say "described". } +Some shell builtin commands also take options that begin with `tt(+)' } +instead of `tt(-)'. These commands are indicated in the list below. The word "indicated" here makes me expect something similar to the and markings in the options list, which obviously isn't what you mean. } +Options must appear in a group before any non-option arguments; "Options (and their individual arguments, if any) ..." ? Also the whole document could probably use a consistency check, because sometimes we use the term "flags" to differentiate command options from setopts, and other times we don't. Maybe it would suffice to point out that "flags" and "options" are the same thing and we use flags when there would be confusion (such as when describing the "-o option" flag of "emulate"). Otherwise this all looks accurate.