On Mon, Jun 8, 2015 at 11:36 AM, Nicolas Pitre nicolas.pitre@linaro.org wrote:
Unless I'm missing something obvious, I can't find any section where all options are documented together. There is the "Invoking" section but it contains very few options and only the most generic ones. All the others are documented here and there in the manual with a reference to them added to the index as I did.
I only saw one documentation hunk in your patch, and that was in the middle of the .section pseudo-op description. An option should be mentioned in the overview section, and then for target independent options a longer description in the invoking section if necessary. Target dependent options get documented in the target dependent parts of the manual. Putting longer descriptions elsewhere may be appropriate, and your docs in the .section psuedo-op section seemed OK, but not also without a mention in the overview which I didn't see.
Jim