Re: [PATCH 4/9] matherr.3: Exclude the example from analysis

[Stephen Kitt <steve@sk2.org>]

[-- Attachment #1: Type: text/plain, Size: 1040 bytes --]

Hi Alex,

On Sat, 8 Jan 2022 02:31:42 +0100, "Alejandro Colomar (man-pages)"
<alx.manpages@gmail.com> 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 #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]