From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id S1753766AbbIWIwl (ORCPT <rfc822;w@1wt.eu>);
	Wed, 23 Sep 2015 04:52:41 -0400
Received: from mga14.intel.com ([192.55.52.115]:4665 "EHLO mga14.intel.com"
	rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP
	id S1753309AbbIWIwh (ORCPT <rfc822;linux-kernel@vger.kernel.org>);
	Wed, 23 Sep 2015 04:52:37 -0400
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.17,577,1437462000"; 
   d="scan'208";a="795430100"
Message-ID: <1442998351.8361.162.camel@linux.intel.com>
Subject: Re: [PATCH] lib: Documentation: Synchronize %p formatting
 documentation
From: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
To: Rasmus Villemoes <linux@rasmusvillemoes.dk>
Cc: Martin Kletzander <mkletzan@redhat.com>, linux-doc@vger.kernel.org,
        Jonathan Corbet <corbet@lwn.net>,
        Andrew Morton <akpm@linux-foundation.org>,
        Geert Uytterhoeven <geert+renesas@glider.be>,
        Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>,
        Stephen Boyd <sboyd@codeaurora.org>, Tejun Heo <tj@kernel.org>,
        linux-kernel@vger.kernel.org
Date: Wed, 23 Sep 2015 11:52:31 +0300
In-Reply-To: <87si66qovw.fsf@rasmusvillemoes.dk>
References: <32a3a9cbcdd7ffe76ad84b8f318eefe3392e97e0.1442826483.git.mkletzan@redhat.com>
	 <1442827087.8361.117.camel@linux.intel.com>
	 <87si66qovw.fsf@rasmusvillemoes.dk>
Organization: Intel Finland Oy
Content-Type: text/plain; charset="UTF-8"
X-Mailer: Evolution 3.16.3-1 
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Tue, 2015-09-22 at 20:40 +0200, Rasmus Villemoes wrote:
> On Mon, Sep 21 2015, Andy Shevchenko <
> andriy.shevchenko@linux.intel.com> wrote:
> 
> > On Mon, 2015-09-21 at 11:13 +0200, Martin Kletzander wrote:
> > 
> > > Move all pointer-formatting documentation to one place instead of
> > > keeping it in three places with different level of completeness.
> 
> I've had a patch titled "vsnprintf: collect documentation in one 
> place"
> lying in a misc_printf branch for a while now, so I certainly like 
> this.
> 
> > I think we still need at least one in the code. I, for example, 
> > often
> > read it from the actual c-file, not from documentation.
> 
> I'd really prefer actually collecting it in that single place, under
> Documentation/, but I guess eliminating one redundant copy is better
> than nothing...

Agree.

-- 
Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Intel Finland Oy