Re: [Fetchmail-devel] Should sslcommonname be mentioned in the list of legal user descriptions and options?

[Matthias A. <mat...@gm...>]

Am 24.06.25 um 00:18 schrieb u3...@ne...:
> Hello,
> Referring to
> https://gitlab.com/fetchmail/fetchmail/-/blob/next/fetchmail.man?ref_type=heads :
> Is avoiding to mention the sslcommonname keyword in the list of
> 'legal user descriptions and options', which begins at line #2106, deliberate?

Hi u34,

thanks for asking this. No, that's an oversight, also on legacy_6x (the 
branch for 6.5) and the - unmaintained, so wontfix - legacy_64. There 
might be more.

I created https://gitlab.com/fetchmail/fetchmail/-/issues/72 to track this.

I wonder however if such information should be inlined with the 
remainder of the documentation, because I main the manual page, um, 
manually, and strictly speaking, that information is halfway redundant.  
I might reduce my workload by either removing the tables/lists and 
putting that information in the main section where we have the command 
line option, the rcfile Keyword, the history (when introduced), or I 
would need to mark that up and auto-generate that information somehow.

Regards,
Matthias