Re: [PATCH v2 2/2] doc: Use @code rather than @var for options

2020-01-28 Thread Peter Maydell
On Tue, 28 Jan 2020 at 07:39, David Edmondson wrote: > > Eric Blake writes: > > > On 1/24/20 4:34 AM, David Edmondson wrote: > >> Texinfo defines @var for metasyntactic variables and such terms are > >> shown in upper-case or italics in the output of makeinfo. When > >> considering an option to a

Re: [PATCH v2 2/2] doc: Use @code rather than @var for options

2020-01-27 Thread David Edmondson
Eric Blake writes: > On 1/24/20 4:34 AM, David Edmondson wrote: >> Texinfo defines @var for metasyntactic variables and such terms are >> shown in upper-case or italics in the output of makeinfo. When >> considering an option to a command, such as "-n", upper-casing is >> undesirable as it may co

Re: [PATCH v2 2/2] doc: Use @code rather than @var for options

2020-01-27 Thread Eric Blake
On 1/24/20 4:34 AM, David Edmondson wrote: Texinfo defines @var for metasyntactic variables and such terms are shown in upper-case or italics in the output of makeinfo. When considering an option to a command, such as "-n", upper-casing is undesirable as it may confuse the reader or be in conflic