Re: Review request: draft ioctl_userfaultfd(2) manual page

From: Mike Rapoport
Date: Tue Apr 25 2017 - 04:01:09 EST


Hello Michael,

On Fri, Apr 21, 2017 at 01:41:18PM +0200, Michael Kerrisk (man-pages) wrote:
> Hi Mike,
>

[...]

> >
> > Yes.
> > Just the future is only a week or two from today as we are at 4.11-rc7 :)
>
> Yes, I understand :-). So of course there's a *lot* more
> new stuff to document, right?

I've started to add the description of the new functionality to both
userfaultfd.2 and ioctl_userfaultfd.2 and it's somewhat difficult for me to
decide how it would be better to split the information between these two
pages and what should be the pages internal structure.

I even thought about possibility of adding relatively comprehensive
description of userfaultfd as man7/userfaultfd.7 and then keeping the pages
in man2 relatively small, just with brief description of APIs and SEE ALSO
pointing to man7.

Any advise is highly appreciated.

> [...]

--
Sincerely yours,
Mike.