Return-Path: Delivered-To: apmail-geronimo-dev-archive@www.apache.org Received: (qmail 64131 invoked from network); 2 Dec 2005 03:30:17 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 2 Dec 2005 03:30:17 -0000 Received: (qmail 4979 invoked by uid 500); 2 Dec 2005 03:30:13 -0000 Delivered-To: apmail-geronimo-dev-archive@geronimo.apache.org Received: (qmail 4819 invoked by uid 500); 2 Dec 2005 03:30:13 -0000 Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@geronimo.apache.org List-Id: Delivered-To: mailing list dev@geronimo.apache.org Received: (qmail 4808 invoked by uid 99); 2 Dec 2005 03:30:12 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Dec 2005 19:30:12 -0800 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: domain of ammulder@gmail.com designates 64.233.162.194 as permitted sender) Received: from [64.233.162.194] (HELO zproxy.gmail.com) (64.233.162.194) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Dec 2005 19:31:39 -0800 Received: by zproxy.gmail.com with SMTP id 9so201522nzo for ; Thu, 01 Dec 2005 19:29:49 -0800 (PST) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:sender:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=p9wQtvKtjopxqIkIySHih/pHnQ/F+SrQDxv6pATeZIwDW4YFrphBU9f98uuG3DbBctbLdLGbOSkzwHmZAYo8JgLpG51/cpVt3rrq98OiRv+pu4LIuMLCWQSQ43U8JA3AuYWFJUUzkCwwI9OywkBPWcX5lqlmUzMeqTmf+kyK5kQ= Received: by 10.36.224.26 with SMTP id w26mr2191176nzg; Thu, 01 Dec 2005 19:29:49 -0800 (PST) Received: by 10.37.13.69 with HTTP; Thu, 1 Dec 2005 19:29:49 -0800 (PST) Message-ID: <74e15baa0512011929r5bca6415j18c54fe00b20fc2@mail.gmail.com> Date: Thu, 1 Dec 2005 22:29:49 -0500 From: Aaron Mulder Sender: ammulder@gmail.com To: dev@geronimo.apache.org Subject: Re: [LONG] Daemon command line option conventions - need to agree before 1.0 In-Reply-To: <438FB28A.40602@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline References: <438F8689.3040901@gmail.com> <74e15baa0512011801q33146be6lb37900e4827f8248@mail.gmail.com> <438FB28A.40602@gmail.com> X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N I like that more. Thanks, Aaron On 12/1/05, John Sisson wrote: > OK, I now believe it was a mistake suggesting we should have a short > form of *each* option. I agree that I wouldn't run the options together > like you can with tar. > > I just want to make sure we have thought this through as now is our last > chance to change it before introducing migration issues for supported > releases. > > Considering the depoy tool uses "--" for its options so we should try to > be consistent, here is my final attempt, trying to follow the short (-) > and long (--) convention. I actually have a habit of using the long > form of options when coding commands in scripts for > readability/supportability. > > --quiet ** changed from -quiet ** > -v --verbose > -vv --veryverbose > --override ** changed from -override ** > -h --help > --long ** new option to change startup to use long p= rogress format ** > > And we would support (but not actually document): > > -help > /? > > John > > Aaron Mulder wrote: > > >On 12/1/05, David Blevins wrote: > > > > > >>I didn't really mean that each option *has* to have a short version-- > >>there are only so many letters and numbers. But something like this... > >> > >> > > > >I know that many tools have established a convention. I just don't > >like it for this case. I surely run tar -xzpvf and appreciate not > >having to type long names for all the separate flags. But I don't use > >Geronimo with 5 flags that way. No one will combine help with > >anything, many of the remaining flags covering the startup are at > >least to some degree mutually exclusive, I *want* it to be harder to > >type the override flag because no one should ever use it, ... I can't > >put my finger on a single specific thing, I just don't like the idea > >as a whole. Sorry! :) > > > >Aaron > > > > > > > >>Here are the options for some common/powerful command line tools: > >> > >> wget http://people.apache.org/~dblevins/cli/wget-options.txt > >> tar http://people.apache.org/~dblevins/cli/tar-options.txt > >> rsync http://people.apache.org/~dblevins/cli/rsync-options.txt > >> patch http://people.apache.org/~dblevins/cli/patch-options.txt > >> grep http://people.apache.org/~dblevins/cli/grep-options.txt > >> diff http://people.apache.org/~dblevins/cli/diff-options.txt > >> > >> > >>-D --David > >> > >> > >> > >> > > > > > > > >