Bug 99 – CommandLine::Parse --help option is way too verbose

Bug 99 - CommandLine::Parse --help option is way too verbose


Summary:	CommandLine::Parse --help option is way too verbose

Status:	RESOLVED FIXED

Product:	ns-3
Classification:	Unclassified
Component:	core
Version:	pre-release
Hardware:	All All

Importance:	P3 normal
Assigned To:	ns-bugs

URL:
Keywords:

Depends on:
Blocks:
	Show dependency tree / graph

Reported:	2007-10-31 09:36 UTC by Mathieu Lacage
Modified:	2008-07-01 13:32 UTC (History)
CC List:	0 users

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

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.