Re: Revisit: the 'details' option to show more descriptions
Lorenzo Bettini <[email protected]>
| Newsgroups | gmane.comp.gnu.gengetopt.general |
|---|---|
| Message-ID | <[email protected]> |
- Tong - wrote: > Hi Lorenzo, > hi Tong! good to hear from you :-) > A while back ago, I posted here a request entitled > "Wish: An option to show more descriptions", > http://thread.gmane.org/gmane.comp.gnu.gengetopt.general/216/focus=262 > yes, I remember that > I'd like to revisit the subject again, but since it has been a while, and I > bubbled my request with many irrelevant or outdated requests, I'm going to > re-summarize them below in one post. Note that the text prefixed with '> ' > was your replies. > > Background: > ----------- > > When programming in Perl, I use the Pod::Usage package to show the online > help. What's interesting in the Pod::Usage package is that it gives me > three level of details. One of them is to show the help for parameters > in details. > > In gengetopt, we've already have two level of details: > > 1. with the option --long-help > 2. with the option --help/--show-full-help > actually, the generated parser provides 1. --help (usually) 2. --help/--full-help (in case of hidden options) > But sometimes the one-line explanation from --help might not be enough > to explain things in details. However, if we put too much info in it, > the total --help would be too long, thus we'll loose our audience. > > Request: > -------- > > So I wish that gengetopt can have another option to show help for parameters > in details (say, --show-detailed-help). > OK, so I should add the details="..." part in the .ggo file, and in that case provide --detailed-help (does any of you know whether there's a standard option for this? is --show-detailed-help standard?) right? hope to hear from you soon! cheers Lorenzo -- Lorenzo Bettini, PhD in Computer Science, DSI, Univ. di Firenze ICQ# lbetto, 16080134 (GNU/Linux User # 158233) HOME: http://www.lorenzobettini.it MUSIC: http://www.purplesucker.com http://www.myspace.com/supertrouperabba BLOGS: http://tronprog.blogspot.com http://longlivemusic.blogspot.com http://www.gnu.org/software/src-highlite http://www.gnu.org/software/gengetopt http://www.gnu.org/software/gengen http://doublecpp.sourceforge.net