Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1176303AbdDYIBH (ORCPT ); Tue, 25 Apr 2017 04:01:07 -0400 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:40156 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S976107AbdDYIA7 (ORCPT ); Tue, 25 Apr 2017 04:00:59 -0400 Date: Tue, 25 Apr 2017 11:00:48 +0300 From: Mike Rapoport To: "Michael Kerrisk (man-pages)" Cc: Andrea Arcangeli , lkml , "linux-mm@kvack.org" , linux-man Subject: Re: Review request: draft ioctl_userfaultfd(2) manual page 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> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4c05c2bb-af77-d706-9455-8ceaa5510580@gmail.com> User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-GCONF: 00 x-cbid: 17042508-0012-0000-0000-00000515BCD8 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17042508-0013-0000-0000-000018314CB4 Message-Id: <20170425080047.GA16770@rapoport-lnx> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-04-25_04:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=0 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1703280000 definitions=main-1704250147 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 885 Lines: 32 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.