Hi Alex, On Sat, 8 Jan 2022 02:31:42 +0100, "Alejandro Colomar (man-pages)" <alx.manpages@xxxxxxxxx> wrote: > On 1/7/22 17:46, Stephen Kitt wrote: > > The example program is obsolete, as indicate in the text, and > > shouldn't be analysed. Changing the introductory heading to "Obsolete > > program source" excludes it from automated analysis and makes it > > hopefully clearer to readers that it is obsolete. > > In this case, the first paragraph of the DESCRIPTION already notes that > the whole page is obsolete (and even removed from glibc). On top of > that, I plan to add the [[deprecated]] attribute to the function > prototype in the SYNOPSIS (when Michael comes back). > > Do you think it's still necessary to mark the example program obsolete? > For a human reader, I'd say no. > For the automated analysis, I'd first decide on which format we want to > standardize to mark code begin and code end, and after that fix this if > it needs to be fixed. I agree, let’s wait. Regards, Stephen
Attachment:
pgpG5NoJNFDi4.pgp
Description: OpenPGP digital signature
