Re: CVS commit: src/lib/libc/sys

2017-02-23 Thread Kamil Rytarowski 


On 23.02.2017 12:33, Robert Elz wrote:
> Date:Thu, 23 Feb 2017 13:48:10 +0300
> From:Valery Ushakov 
> Message-ID:  <20170223104810.gw20...@pony.stderr.spb.ru>
> 
>   | > From: Kamil Rytarowski 
>   | > In general we don't put POSIX/standard and nonstandard functions into
>   | > the same manual pages.
>   | 
>   | Where did you get that impression?
> 
> Good question - Kamil, see:
>   man 2 wait
> for a counter example (there are many.)
> 
> kre
> 

I learnt it from this thraed:

List:   netbsd-tech-userlevel
Subject:Re: reallocarr(3) cleanup
From:   David Holland 
Date:   2015-03-18 0:07:45
Message-ID: 20150318000745.GB15136 () netbsd ! org
[Download message RAW]

On Wed, Mar 18, 2015 at 12:00:51AM +0100, Joerg Sonnenberger wrote:
 > On Tue, Mar 17, 2015 at 11:56:35PM +0100, Kamil Rytarowski wrote:
 > > - merge reallocarr.3 to malloc.3 for consistency,
 >
 > No. Don't put standard and non-standard functions in the same man page.

concur

-- 
David A. Holland
dholl...@netbsd.org


https://marc.info/?l=netbsd-tech-userlevel=142663727209791=2



signature.asc
Description: OpenPGP digital signature

Re: CVS commit: src/lib/libc/sys

2017-02-23 Thread Christos Zoulas 
In article <20170223104810.gw20...@pony.stderr.spb.ru>,
Valery Ushakov   wrote:
>On Thu, Feb 23, 2017 at 10:12:25 +0100, Kamil Rytarowski wrote:
>
>> On 08.02.2017 19:01, Maya Rashish wrote:
>> > Module Name:   src
>> > Committed By:  maya
>> > Date:  Wed Feb  8 18:01:24 UTC 2017
>> > 
>> > Modified Files:
>> >src/lib/libc/sys: accept.2
>> > 
>> > Log Message:
>> > Document accept4 in accept(2)
>> 
>> In general we don't put POSIX/standard and nonstandard functions into
>> the same manual pages.
>
>Where did you get that impression?

I think that the current practice (and usefulness) of putting families
of functions together in the same man page far exceeds the value of
having POSIX only man pages.

>> Currently there is no man-page link accept4 -> accept.
>
>Yes, that needs to be fixed with another MLINS+=

I fixed that.

christos

Re: CVS commit: src/lib/libc/sys

2017-02-23 Thread Robert Elz 
Date:Thu, 23 Feb 2017 13:48:10 +0300
From:Valery Ushakov 
Message-ID:  <20170223104810.gw20...@pony.stderr.spb.ru>

  | > From: Kamil Rytarowski 
  | > In general we don't put POSIX/standard and nonstandard functions into
  | > the same manual pages.
  | 
  | Where did you get that impression?

Good question - Kamil, see:
man 2 wait
for a counter example (there are many.)

kre

Re: CVS commit: src/lib/libc/sys

2017-02-23 Thread Valery Ushakov 
On Thu, Feb 23, 2017 at 10:12:25 +0100, Kamil Rytarowski wrote:

> On 08.02.2017 19:01, Maya Rashish wrote:
> > Module Name:src
> > Committed By:   maya
> > Date:   Wed Feb  8 18:01:24 UTC 2017
> > 
> > Modified Files:
> > src/lib/libc/sys: accept.2
> > 
> > Log Message:
> > Document accept4 in accept(2)
> 
> In general we don't put POSIX/standard and nonstandard functions into
> the same manual pages.

Where did you get that impression?


> Currently there is no man-page link accept4 -> accept.

Yes, that needs to be fixed with another MLINS+=

-uwe

Re: CVS commit: src/lib/libc/sys

2017-02-23 Thread Kamil Rytarowski 


On 08.02.2017 19:01, Maya Rashish wrote:
> Module Name:  src
> Committed By: maya
> Date: Wed Feb  8 18:01:24 UTC 2017
> 
> Modified Files:
>   src/lib/libc/sys: accept.2
> 
> Log Message:
> Document accept4 in accept(2)
> 

In general we don't put POSIX/standard and nonstandard functions into
the same manual pages. I think accept(2) should be split with accept4(2)
and paccept(2).

Currently there is no man-page link accept4 -> accept.

Since we are here - are we planning to introduce ppoll(2)? It's very
similar to homegrown pollts(2). Porting of it is the same scenario to
accept4(2).

codesearch.debian.net gives 233 packages for accept4(2) and 191 for ppoll(2)



signature.asc
Description: OpenPGP digital signature