Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755286AbcCWMmR (ORCPT ); Wed, 23 Mar 2016 08:42:17 -0400 Received: from smtpauth02h.mfg.siteprotect.com ([64.26.60.151]:46960 "EHLO smtpauth02.mfg.siteprotect.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753074AbcCWMmK (ORCPT ); Wed, 23 Mar 2016 08:42:10 -0400 Date: Wed, 23 Mar 2016 08:43:45 -0400 (EDT) From: Vince Weaver X-X-Sender: vince@pianoman.cluster.toy To: "Wangnan (F)" cc: Peter Zijlstra , mingo@redhat.com, linux-kernel@vger.kernel.org, He Kuang , Alexei Starovoitov , Arnaldo Carvalho de Melo , Brendan Gregg , Jiri Olsa , Masami Hiramatsu , Namhyung Kim , Zefan Li , pi3orama@163.com, "Michael Kerrisk (man-pages)" Subject: Re: [PATCH 1/5] perf core: Introduce new ioctl options to pause and resume ring buffer In-Reply-To: <56F26301.3010100@huawei.com> Message-ID: References: <1457949585-191064-1-git-send-email-wangnan0@huawei.com> <1457949585-191064-2-git-send-email-wangnan0@huawei.com> <20160323091654.GV6344@twins.programming.kicks-ass.net> <56F26301.3010100@huawei.com> User-Agent: Alpine 2.11 (DEB 23 2013-08-11) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-CTCH-Spam: Unknown X-CTCH-RefID: str=0001.0A020204.56F28F21.034B,ss=1,re=0.000,recu=0.000,reip=0.000,cl=1,cld=1,fgs=0 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1121 Lines: 33 On Wed, 23 Mar 2016, Wangnan (F) wrote: > > > Can you also do a patch to the man-pages? > > > > http://man7.org/linux/man-pages/man2/perf_event_open.2.html > > Sure. > > I think I need to provide a patch for: > > http://git.kernel.org/cgit/docs/man-pages/man-pages.git > > But which one should be the first? Shall we update man pages before > this patch be merged by upstream? Or Michael and Vince will consider > this problem? It is good to see a rough draft of the manpage changes for an ABI addition like this before the patch gets merged just so we can catch anything odd about the interface. Also include (as a comment) the git commit id that introduces the change. In general manpage patches do not get committed until after the change hits a full released kernel (as things have been known to get reverted from -rc kernels in the past). If you send a rough patch I can fix it up and queue it up with other manpage patches I have (I'm a bit backlogged but working on catching up). I'm never quite sure that I get all of the various Signed-off- lines right for contributed patches though. Vince