Re: Manual toc depth
=- Kyle Wheeler wrote on Wed 3.Sep'08 at 15:44:15 -0500 -=
> On Wednesday, September 3 at 09:31 PM, quoth Rocco Rutte:
>> I'd like to commit a change which makes the manual contain only
>> chapters and sections in the manual to trim the table of
>> contents, mainly to remove hundreds of sections for config
>> options.
>>
>> Due to Brendan recalling objections I'd like to know what these are.
>>
>> The change (already backed out) would be identical to
>> http://dev.mutt.org/hg/mutt/rev/e5610347fb3f.
>>
>> Are there any objections?
>
> {...} Isn't the real problem that config options shouldn't define
> level-2 manual sections, rather than that level-2 manual sections
> shouldn't be in the ToC?
>
> In the "Configuration Commands" section of the manual, the various
> commands don't each get their own subsection, they're just part of
> a list (and thus don't show up in the ToC). It seems to me that if
> this is appropriate for the long list of config *commands*, the
> same would be appropriate for config *options*.
>
> At least, that makes sense in my head. :)
In mine, too.
Please cut it down sanely. :)
--
© Rado S. -- You must provide YOUR effort for your goal!
EVERY effort counts: at least to show your attitude.
You're responsible for ALL you do: you get what you give.