Issue in man page bcmp.3.

Issue in man page bcmp.3.

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    Who is "it"?
"B<bcmp>()  is identical to B<memcmp>(3); use it instead."

Re: Issue in man page bcmp.3.

[Alejandro Colomar]

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

Hi Helge,

On Wed, Nov 01, 2023 at 02:02:12PM +0000, Helge Kreutzmann wrote:
> Without further ado, the following was found:
> 
> Issue:    Who is "it"?
> "B<bcmp>()  is identical to B<memcmp>(3); use it instead."

Considering that the rest of the page is there just to say this function
is deprecated and even removed from POSIX, I guess a suggestion to use
'it' can only mean use the other one, that is, memcmp(3).

Here's the entire page:

	bcmp(3)                Library Functions Manual                bcmp(3)

	NAME
	     bcmp - compare byte sequences

	LIBRARY
	     Standard C library (libc, -lc)

	SYNOPSIS
	     #include <strings.h>

	     [[deprecated]] int bcmp(const void s1[.n], const void s2[.n], size_t n);

	DESCRIPTION
	     bcmp() is identical to memcmp(3); use it instead.

	STANDARDS
	     None.

	HISTORY
	     4.3BSD.    Marked   as   LEGACY   in   POSIX.1‐2001;  removed  in
	     POSIX.1‐2008.

	SEE ALSO
	     memcmp(3)

	Linux man‐pages (unreleased)    (date)                         bcmp(3)

Cheers,
Alex

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page bcmp.3.

[Stefan Puiu]

Hi Alex,

On Wed, Nov 1, 2023 at 6:25 PM Alejandro Colomar <alx@kernel.org> wrote:
>
> Hi Helge,
>
> On Wed, Nov 01, 2023 at 02:02:12PM +0000, Helge Kreutzmann wrote:
> > Without further ado, the following was found:
> >
> > Issue:    Who is "it"?
> > "B<bcmp>()  is identical to B<memcmp>(3); use it instead."
>
> Considering that the rest of the page is there just to say this function
> is deprecated and even removed from POSIX, I guess a suggestion to use
> 'it' can only mean use the other one, that is, memcmp(3).

Maybe 'use the latter instead' would be clearer?

Thanks,
Stefan.


>
>[..]
> <https://www.alejandro-colomar.es/>

Re: Issue in man page bcmp.3.

[Alejandro Colomar]

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

On Thu, Nov 02, 2023 at 12:06:34PM +0200, Stefan Puiu wrote:
> Hi Alex,
> 
> On Wed, Nov 1, 2023 at 6:25 PM Alejandro Colomar <alx@kernel.org> wrote:
> >
> > Hi Helge,
> >
> > On Wed, Nov 01, 2023 at 02:02:12PM +0000, Helge Kreutzmann wrote:
> > > Without further ado, the following was found:
> > >
> > > Issue:    Who is "it"?
> > > "B<bcmp>()  is identical to B<memcmp>(3); use it instead."
> >
> > Considering that the rest of the page is there just to say this function
> > is deprecated and even removed from POSIX, I guess a suggestion to use
> > 'it' can only mean use the other one, that is, memcmp(3).
> 
> Maybe 'use the latter instead' would be clearer?

Hi Stefan!

Yep, I like that wording.  Thanks!

Alex

> 
> Thanks,
> Stefan.
> 
> 
> >
> >[..]
> > <https://www.alejandro-colomar.es/>

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Issue in man page bcmp.3.

[Alejandro Colomar]

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

On Thu, Nov 02, 2023 at 12:06:34PM +0200, Stefan Puiu wrote:
> Hi Alex,
> 
> On Wed, Nov 1, 2023 at 6:25 PM Alejandro Colomar <alx@kernel.org> wrote:
> >
> > Hi Helge,
> >
> > On Wed, Nov 01, 2023 at 02:02:12PM +0000, Helge Kreutzmann wrote:
> > > Without further ado, the following was found:
> > >
> > > Issue:    Who is "it"?
> > > "B<bcmp>()  is identical to B<memcmp>(3); use it instead."
> >
> > Considering that the rest of the page is there just to say this function
> > is deprecated and even removed from POSIX, I guess a suggestion to use
> > 'it' can only mean use the other one, that is, memcmp(3).
> 
> Maybe 'use the latter instead' would be clearer?

I've applied that fix:

<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=b8584be144ff391354190f89c4db4467ba0f9e53>

Cheers,
Alex

> 
> Thanks,
> Stefan.
> 
> 
> >
> >[..]
> > <https://www.alejandro-colomar.es/>

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Issue in man page bcmp.3

[Helge Kreutzmann]

Without further ado, the following was found:

Issue:    B<…>size_t n → B<…size_t> I<n>

"B<[[deprecated]] int bcmp(>size_t n;\n"
"B<                        const void >I<s1>B<[>I<n>B<], const void >I<s2>B<[>I<n>B<], size_t >I<n>B<);>\n"