From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S934344AbbIVSsm (ORCPT ); Tue, 22 Sep 2015 14:48:42 -0400 Received: from mx1.redhat.com ([209.132.183.28]:40423 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933787AbbIVSsf (ORCPT ); Tue, 22 Sep 2015 14:48:35 -0400 Date: Tue, 22 Sep 2015 20:48:33 +0200 From: Martin Kletzander To: Rasmus Villemoes Cc: Andy Shevchenko , linux-doc@vger.kernel.org, Jonathan Corbet , Andrew Morton , Geert Uytterhoeven , Tetsuo Handa , Stephen Boyd , Tejun Heo , linux-kernel@vger.kernel.org Subject: Re: [PATCH] lib: Documentation: Synchronize %p formatting documentation Message-ID: <20150922184833.GB11508@wheatley> References: <32a3a9cbcdd7ffe76ad84b8f318eefe3392e97e0.1442826483.git.mkletzan@redhat.com> <1442827087.8361.117.camel@linux.intel.com> <87si66qovw.fsf@rasmusvillemoes.dk> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="JYK4vJDZwFMowpUq" Content-Disposition: inline In-Reply-To: <87si66qovw.fsf@rasmusvillemoes.dk> User-Agent: Mutt/1.5.23.1 (2014-03-12) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org --JYK4vJDZwFMowpUq Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline On Tue, Sep 22, 2015 at 08:40:03PM +0200, Rasmus Villemoes wrote: >On Mon, Sep 21 2015, Andy Shevchenko 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... > And the second copy (in the code) will be way shorter, simply serving as a hint as opposed to the full blown documentation. I just need to go through each modifier to make sure all of them are mentioned in both places. I'll try to find some spare time tomorrow. >Rasmus --JYK4vJDZwFMowpUq Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJWAaKAAAoJEAgfwp8kF4bdEcoP/RQtwEpx7aPGk3UF6+9xjj2R 2OuiyIfqZeXqDiKMCxD9EwHVV1eFLgqEukx484G7aulJZ/XrLUgsUc95guDgYMLh nVTK69gVEox/kPPyJZDA5ZTlgyhi7cWDLfiSIygBy24JdLupKMc34KP/0owBZe4S 2k5wjvaqdVCYN+9FIzTuU20FipJ91kgtsoru2xaHrYqL7fdIITFHeuemC9irThQd Su9cKQVOHyBJGPkM0qHhPeRolmWRCrXukB1RFm8fru3iyCdFVSuMQvUlGbIemQ1W boD3l1hEvZkDfSjzkWGLahrfWYGx2psIQwuHCy8nTi2W4O3od/dXXvgtDTGue+4R jYM2a7z7+3smkeHhiCNF0CdKTKqlzAGiAfzL85YPz1aQGkiccTjFJepFN5RGwRae RMKL8Cd+YWTNs1YQbzojpLlMt7bfHx9H8Aziap6QO6sWfPPIt1uw6IZBTvlD7QCA vIEiP1wl27m1ZJl1JrOekc67IXjRL27M8BQ6uKgLvNScIl+LLB0/R3bK+gx3/2E4 0HSAt+hG95LCVX9LrmqUiZCcL0c/qhBTwW2H9RMx7PBTTKLR3h0IN9FIu2uVukjO rb5A4nXUgVA6EOJjtlbszPCImV23XgX1NeRzHT1LwEWRHLORBUQVHQc1VLV43xeM 9eeWFP/159NSd0p1gtPG =+wRs -----END PGP SIGNATURE----- --JYK4vJDZwFMowpUq--