Re: Documentation style for options with optional levels

2019-04-10 Thread Martin Sebor
On 4/10/19 9:46 AM, Sandra Loosemore wrote: On 4/10/19 5:13 AM, Jonathan Wakely wrote: For options that can be used as -foo or -foo=level we have a variety of different styels for documenting what the default level is. See below for several examples. I find this a bit confusing when try to see w

Re: Documentation style for options with optional levels

2019-04-10 Thread Sandra Loosemore
On 4/10/19 5:13 AM, Jonathan Wakely wrote: For options that can be used as -foo or -foo=level we have a variety of different styels for documenting what the default level is. See below for several examples. I find this a bit confusing when try to see what it means to use the option without a leve

Re: Documentation style for options with optional levels

2019-04-10 Thread Jonathan Wakely
On 10/04/19 08:42 -0400, Nathan Sidwell wrote: On 4/10/19 7:13 AM, Jonathan Wakely wrote: For options that can be used as -foo or -foo=level we have a variety of different styels for documenting what the default level is. See below for several examples. I find this a bit confusing when try to se

Re: Documentation style for options with optional levels

2019-04-10 Thread Nathan Sidwell
On 4/10/19 7:13 AM, Jonathan Wakely wrote: For options that can be used as -foo or -foo=level we have a variety of different styels for documenting what the default level is. See below for several examples. I find this a bit confusing when try to see what it means to use the option without a leve