LLVM Command Guide not complete

[tlattner]

Bugzilla Link	314
Resolution	FIXED
Resolved on	Mar 06, 2010 14:00
Version	unspecified
OS	All

Extended Description

The command guide appears to be missing options for some of the tools. For
example, llc has a ton of options that you can get if you use --help-hidden. I'm
sure the same is for other tools. I think all of these should be listed on the
website.

[lattner]

I don't think that it really makes sense to put all options in the command guide
for every tool, but you're right... we should at least point out that there are
hidden options and mention how to get them.

I updated the text at the top of the commandguide page:
http://llvm.cs.uiuc.edu/docs/CommandGuide/

Does this look reasonable? If so I think this bug should be closed, because we
don't really want to mention every little debugging option (which might change
in the future). If there are major options, like -o, that are not documented,
that's clearly a bug though and should be fixed :)

-Chris

[tlattner]

Whats wrong with having these pages auto generated?

[lattner]

That's not an unreasonable idea at all, but would be tricky to get "right". If
you wanted to add an entry to the open projects page I think that would be fine.
However, I think the bug is "satisfied", do you agree?

-Chris

[tlattner]

Thats fine.

[llvmbot]

Tanya, what do you mean by "having these pages autogenerated"? Do you mean you
want the .pod files auto-generated, or is the current .pod -> .html conversion
satisfactory?