Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1429800AbdDYK7n (ORCPT ); Tue, 25 Apr 2017 06:59:43 -0400 Received: from mail-wm0-f66.google.com ([74.125.82.66]:33784 "EHLO mail-wm0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1428917AbdDYK7d (ORCPT ); Tue, 25 Apr 2017 06:59:33 -0400 MIME-Version: 1.0 Reply-To: mtk.manpages@gmail.com In-Reply-To: <20170425080047.GA16770@rapoport-lnx> References: <487b2c79-f99b-6d0f-2412-aa75cde65569@gmail.com> <9af29fc6-dce2-f729-0f07-a0bfcc6c3587@gmail.com> <20170322135423.GB27789@rapoport-lnx> <20170421110714.GC20569@rapoport-lnx> <4c05c2bb-af77-d706-9455-8ceaa5510580@gmail.com> <20170425080047.GA16770@rapoport-lnx> From: "Michael Kerrisk (man-pages)" Date: Tue, 25 Apr 2017 12:59:11 +0200 Message-ID: Subject: Re: Review request: draft ioctl_userfaultfd(2) manual page To: Mike Rapoport Cc: Andrea Arcangeli , lkml , "linux-mm@kvack.org" , linux-man Content-Type: text/plain; charset=UTF-8 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1500 Lines: 48 Hi Mike, On 25 April 2017 at 10:00, Mike Rapoport wrote: > 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 Thanks for doing this! > 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. I'm not averse to the notion of a userfaultfd.7 page, but it's a little hard to advise because I'm not sure of the size and scope of your planned changes. In the meantime, I've merged the userfaultfd pages into master, dropped the "draft" branch, and pushed the updates in master to Git. Can you write your changes as a series of patches, and perhaps first give a brief oultine of the proposed changes before getting too far into the work? Then we could tweak the direction if needed. Cheers, Michael