Re: doc: Capitalize parameter of -[x]type.

[Bernhard Voelker]

On 2/7/22 19:04, Andreas Metzler wrote:
> On 2022-02-07 Nikolaos Chatzikonstantinou <nchatz314@gmail.com> wrote:
>> From f3f0b85cb343fa882987beac4fff3bf57a1039bc Mon Sep 17 00:00:00 2001
>> From: Nikolaos Chatzikonstantinou <nchatz314@gmail.com>
>> Date: Mon, 7 Feb 2022 18:11:03 +0900
>> Subject: [PATCH] doc: Capitalize parameter of -[x]type.

Thanks for the patch.

>> The parameter of -type and -xtype was lowercase 'c', and is now capital
>> 'C' which matches the text description below.
> 
> [...]
>> -@deffn Test -type c
>> +@deffn Test -type C
>>  True if the file is of type @var{c}:
> [...]
> 
> Hello,
> 
> I had a hard time understanding the point of the patch until I found
> that e.g. tkinfo seems to render @var{c} as a capital C. However e.g.
> the generated html does not, the @var{c} is rendered in italics. So it
> is not the proper fix. Does
> -@deffn Test -type c
> +@deffn Test -type @var{c}
> work?

Hmm, and this is in the same boat as a whole bunch of other option arguments
like that for -uid, -gid, -used, -atime, -ctime, etc.

I think we should fix them all to @var{...}.

Have a nice day,
Berny