I noticed that the bash shell can suggest command line switches for your command.
Just type your command, a dash (-) and type tab. The shell will show you available switches.
For example, try:
andy@andyx:~$ java -
and press tab - Surprise!
The question is:
How do I interface with this feature. I.e., if I write a program that is to be run from the console, what's the API to tell the shell what switches are available?