I was talking to @etcwilde earlier today, and one of the problems he pointed out was the
build-script's help text can be a bit overwhelming.
At this point, I've gotten used to it, so it's a bit hard for me to judge, but I figured, if this is a problem for some folks, we should consider changing it. In my discussion with Evan, the following ideas came up:
- We can have common options be shown through
--helpand uncommon options shown through (strawman)
- Maybe we can group the options in a more useful way.
- Maybe providing more examples helps?
There's also the separate issue where certain flags like
--reconfigure are opaque to people in what they do (this includes me; I only have a fuzzy understanding of what it does).
Do people have thoughts on this topic? Anyone have objections to separating out options into commonly used options and less commonly used options? Certainly, it's possible that one person's "wait this option exists??" can be another person's "I use that all the time!", especially if the two people work on different parts of the project, but I think for many flags, it is relatively clear if it is used frequently or not...