Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
MIME-Version: 1.0
Reply-To: mtk.manpages@gmail.com
From:   "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>
Date:   Tue, 21 Jul 2020 12:42:50 +0200
Message-ID: <CAKgNAkjyXcXZkEczRz2yvJRFBy2zAwTaNfyiSmskAFWN_3uY1g@mail.gmail.com>
Subject: Mount API manual pages
To:     David Howells <dhowells@redhat.com>
Cc:     Petr Vorel <pvorel@suse.cz>,
        "linux-fsdevel@vger.kernel.org" <linux-fsdevel@vger.kernel.org>,
        linux-man <linux-man@vger.kernel.org>,
        Christian Brauner <christian.brauner@ubuntu.com>,
        lkml <linux-kernel@vger.kernel.org>
Content-Type: text/plain; charset="UTF-8"
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

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/