[darcs-users] short options and long names (VOTE!)
Jonathan Wright
Jonathan.Wright at orionhealth.com
Tue Jun 1 05:00:29 UTC 2004
With regards to long names for the email options, would it make sense to
use the same names as in Mime?
--from=jonathan.wright at orion.co.nz
--to="Kenneth Knowles <kknowles at berkeley.edu>"
--cc=darcs-users at abridgegame.org
--bcc=someone at example.com
The only real change would be changing "--author" to "--from". I'm not
sure if it's a good idea... I can see it both ways. If you are trying to
send an email, then the "--from" option is better. But if you already
know about authors then "--author" makes way more sense.
Anyone else care to comment?
Jonathan.
-----Original Message-----
From: darcs-users-admin at abridgegame.org
[mailto:darcs-users-admin at abridgegame.org] On Behalf Of Kenneth Knowles
Sent: Tuesday, 1 June 2004 4:42 p.m.
To: darcs-users at abridgegame.org
Subject: Re: [darcs-users] short options and long names (VOTE!)
My votes:
On Sat, May 29, 2004 at 06:19:47AM -0400, David Roundy wrote:
> --summary summarize changes
I use this all the time, so a short option would be cool... I see -s is
taken by
--sign, but I'd rather use it for summary (I'm quite biased, having
never used
send)
> -A EMAIL --author=EMAIL specify author id
> -T EMAIL --to=EMAIL specify destination email
> -V PUBRING --verify=PUBRING verify that the patch was
signed by a key in PUBRING
> -c EMAIL --cc=EMAIL specify email address to cc
> -s --sign sign the patch with your gpg
key
Most of the email control options don't seem like they need short
options to me.
A main rationale being that only options that are either used
constantly, or
similar to other unix programs are likely to be used (if you have to
look at -h
output as a reminder, you probably don't mind using the long option).
Also,
when configuring it via your email client then I'd tend to use long
options to
make the script self-explanatory.
> -a --all answer yes to all patches
> -g --gui use graphical interface
> -h --help shows brief description of command and its
arguments
> -m PATCHNAME --patch-name=PATCHNAME name of patch
> -o FILE --output=FILE specify output filename
> -r --recursive add contents of subdirectories
> -t TAGNAME --tag-name=TAGNAME name of version to pull
> -u pass -u option to diff
> -u --unified output patch in format similar
to diff -u
> -v --verbose give verbose output
In case anyone votes to remove any of these, I'll pre-emptively
counter-vote
that these are really good short options.
Kenn
_______________________________________________
darcs-users mailing list
darcs-users at abridgegame.org
http://www.abridgegame.org/mailman/listinfo/darcs-users
More information about the darcs-users
mailing list