Bug 99

Summary: CommandLine::Parse --help option is way too verbose
Product: ns-3 Reporter: Mathieu Lacage <mathieu.lacage>
Component: coreAssignee: ns-bugs <ns-bugs>
Status: RESOLVED FIXED    
Severity: normal    
Priority: P3    
Version: pre-release   
Hardware: All   
OS: All   

Description Mathieu Lacage 2007-10-31 09:36:38 UTC
We really need to add some grouping support to that thing. I would like to propose the following strategy:

1) make --help not output anything about all the registered defaultvalues. Output help only for the user-registered values.

2) introduce a set of macros:
DEFAULT_VALUE_GROUP_DEFINE ("Wifi");
DEFAULT_VALUE_GROUP_ADD ("Wifi", "WifiRtsCtsThreshold");
DEFAULT_VALUE_GROUP_ADD ("Wifi", "WifiFragmentationThreshold");
...

this would create a --help-Wifi option which would be displayed by default and the --help-Wifi option would further display all the options registered in the 'Wifi' group.

I have not given much thinking to the implementation and I am sure that other APIs could be used. But I suspect that this would go a long way towards making the CommandLine thing useful. It would also be nice to use it to classify the options in the introspected output I have implemented in the ns-3-wifi branch.
Comment 1 Mathieu Lacage 2008-04-15 11:43:56 UTC
This in the latest tree.