Mount API manual pages

Mount API manual pages

[Michael Kerrisk (man-pages)]

Hello David,

In October last year you sent some draft manual pages[1] for the new
mount API (fsconfig(), fsmount(), fsopen(), fspick(), move_mount(),
open_tree()).

I noted at the time that the mails were a bit confusing since several
of the pages were sent twice, and to different lists. You said [2]
that you'd resend in a more orderly fashion following any feedback
that you got to those drafts. However, things stalled at that point.

I'd like to restart this process, so that we actually get the pages
into the man-pages set. (This is in part triggered by the
mount_settr() manual page that Christian recently sent.)

Would you be willing to do the following please:

1. Review the pages that you already wrote to see what needs to be
updated. (I did take a look at some of those pages a while back, and
some pieces--I don't recall the details--were out of sync with the
implementation.)

2. Resend the pages, one patch per page.

3. Please CC linux-man@, linux-api@, linux-kernel@, and the folk in CC
on this message.

Cheers,

Michael

[1]
https://lore.kernel.org/linux-man/15449.1531263162@warthog.procyon.org.uk/
[MANPAGE PATCH] Add manpages for move_mount(2) and open_tree(2)

https://lore.kernel.org/linux-man/15519.1531263314@warthog.procyon.org.uk/
[MANPAGE PATCH] Add manpage for fsinfo(2)

https://lore.kernel.org/linux-man/15488.1531263249@warthog.procyon.org.uk/
[MANPAGE PATCH] Add manpage for fsopen(2), fspick(2) and fsmount(2)

etc.

[2] https://lore.kernel.org/lkml/27446.1570738938@warthog.procyon.org.uk/
-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Re: Mount API manual pages

[David Howells]

Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:

> Would you be willing to do the following please:
> 
> 1. Review the pages that you already wrote to see what needs to be
> updated. (I did take a look at some of those pages a while back, and
> some pieces--I don't recall the details--were out of sync with the
> implementation.)
> 
> 2. Resend the pages, one patch per page.
> 
> 3. Please CC linux-man@, linux-api@, linux-kernel@, and the folk in CC
> on this message.

For this week and next, I have an online language course taking up 8-10 hours
a day.  I'll pick it up in August, if that's okay with you.

David

Re: Mount API manual pages

[Michael Kerrisk (man-pages)]

On Fri, 24 Jul 2020 at 12:45, David Howells <dhowells@redhat.com> wrote:
>
> Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:
>
> > Would you be willing to do the following please:
> >
> > 1. Review the pages that you already wrote to see what needs to be
> > updated. (I did take a look at some of those pages a while back, and
> > some pieces--I don't recall the details--were out of sync with the
> > implementation.)
> >
> > 2. Resend the pages, one patch per page.
> >
> > 3. Please CC linux-man@, linux-api@, linux-kernel@, and the folk in CC
> > on this message.
>
> For this week and next, I have an online language course taking up 8-10 hours
> a day.  I'll pick it up in August, if that's okay with you.

Okay -- enjoy the course!  I'll ping again in a couple of weeks.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Re: Mount API manual pages

[Michael Kerrisk (man-pages)]

On Fri, 24 Jul 2020 at 12:45, David Howells <dhowells@redhat.com> wrote:
>
> Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:
>
> > Would you be willing to do the following please:
> >
> > 1. Review the pages that you already wrote to see what needs to be
> > updated. (I did take a look at some of those pages a while back, and
> > some pieces--I don't recall the details--were out of sync with the
> > implementation.)
> >
> > 2. Resend the pages, one patch per page.
> >
> > 3. Please CC linux-man@, linux-api@, linux-kernel@, and the folk in CC
> > on this message.
>
> For this week and next, I have an online language course taking up 8-10 hours
> a day.  I'll pick it up in August, if that's okay with you.

Hi David,

This is just a reminder mail :-).

Cheers,

Michael



--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

Re: Mount API manual pages

[David Howells]

Michael Kerrisk (man-pages) <mtk.manpages@gmail.com> wrote:

> This is just a reminder mail :-).

Yep - I haven't forgotten.  Spent a chunk of time arguing with reinventors and
arguing with a failing dishwasher.  I have some other manpages that I'm
sprucing up too for the notifications stuff.

David