tag release 1.7
[trollop:mainline.git] / FAQ.txt
1 Trollop FAQ
2 -----------
3
4 Q: Whither Trollop?
5 A: There are more than a few pre-existing commandline argument
6    processing libraries for Ruby. I was never too happy with any of
7    them. They all seemed to want me to type way too much for what I
8    wanted to get done. I just wanted to parse some options and be
9    done with it.
10
11 Q: Whither "Trollop"?
12 A: No reason. Just thought it sounded funny.
13
14 Q: Why does Trollop disallow numeric short argument names, like '-1'
15    and '-9'?
16 A: Because it's ambiguous whether these are arguments or negative
17    integer or floating-point parameters to arguments. E.g., what
18    about "-f -3". Is that a negative three parameter to -f, or two
19    separate parameters? 
20
21    I could be very clever and detect when there are no arguments
22    that require floating-point parameters, and allow such short option
23    names in those cases, but opted for simplicity and consistency.
24
25 Q: Why does Trollop disallow options appearing multiple times, despite
26    the POSIX standard allowing it?
27 A: Because basically I think it's confusing, and more often than
28    not, a symptom of you making a mistake (e.g. getting lost in a long
29    command line and accidentally setting the same thing twice.) 
30    I also don't see that much advantage to "-vvvvv" over "-v 5", so
31    Trollop will produce an error if you try to use the same argument
32    multiple times.
33