Duplicated text in getaddrinfo(3)

Duplicated text in getaddrinfo(3)

[Sam Varshavchik]

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

The current version of getaddrinfo(3) seems to have some a small amount of 
duplicative text, possibly a small cut-paste fudge.

Describing the results placed into the returned addrinfo struct:

The members
.IR ai_family ,
.IR ai_socktype ,
and
.I ai_protocol
have the same meaning as the corresponding parameters in the
.BR socket (2)
system call.


Then, two paragraphs later:

.IR ai_family ,
.IR ai_socktype ,
and
.I ai_protocol
specify the socket creation parameters.

Even those the immediately preceding sentence refers to the hints input 
parameter, this sentence seems to refer to the output addrinfo struct again, 
and just restates the description given two paragraphs earlier.

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: Duplicated text in getaddrinfo(3)

[Michael Kerrisk]

Hello Sam,

Sam Varshavchik wrote:
> The current version of getaddrinfo(3) seems to have some a small amount
> of duplicative text, possibly a small cut-paste fudge.

Not sure.  It seems this text goes back to the (your) original version of
the page.  (To begin with, I had wondered if I'd messed up on some edits
that I later made to the page.)

> Describing the results placed into the returned addrinfo struct:
> 
> The members
> .IR ai_family ,
> .IR ai_socktype ,
> and
> .I ai_protocol
> have the same meaning as the corresponding parameters in the
> .BR socket (2)
> system call.
> 
> 
> Then, two paragraphs later:
> 
> .IR ai_family ,
> .IR ai_socktype ,
> and
> .I ai_protocol
> specify the socket creation parameters.
> 
> Even those the immediately preceding sentence refers to the hints input
> parameter, this sentence seems to refer to the output addrinfo struct
> again, and just restates the description given two paragraphs earlier.

Yep -- I've consolidated the duplicated text into a single sentence, and
also removed a bit of duplications elsewhere.  I also rewrote the
discussion of hints==NULL a bit, to provide some more detail.

Chnages will be in 2.79.

thanks!

Michael

-- 
Michael Kerrisk
Maintainer of the Linux man-pages project
http://www.kernel.org/doc/man-pages/
Want to report a man-pages bug?  Look here:
http://www.kernel.org/doc/man-pages/reporting_bugs.html