Subject: Mount API manual 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/[email protected]/
[MANPAGE PATCH] Add manpages for move_mount(2) and open_tree(2)

https://lore.kernel.org/linux-man/[email protected]/
[MANPAGE PATCH] Add manpage for fsinfo(2)

https://lore.kernel.org/linux-man/[email protected]/
[MANPAGE PATCH] Add manpage for fsopen(2), fspick(2) and fsmount(2)

etc.

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


2020-07-24 10:46:42

by David Howells

[permalink] [raw]
Subject: Re: Mount API manual pages

Michael Kerrisk (man-pages) <[email protected]> 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

Subject: Re: Mount API manual pages

On Fri, 24 Jul 2020 at 12:45, David Howells <[email protected]> wrote:
>
> Michael Kerrisk (man-pages) <[email protected]> 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/

Subject: Re: Mount API manual pages

On Fri, 24 Jul 2020 at 12:45, David Howells <[email protected]> wrote:
>
> Michael Kerrisk (man-pages) <[email protected]> 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/

2020-08-05 17:21:53

by David Howells

[permalink] [raw]
Subject: Re: Mount API manual pages

Michael Kerrisk (man-pages) <[email protected]> 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