Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756149AbcLNQnv (ORCPT ); Wed, 14 Dec 2016 11:43:51 -0500 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:32803 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753141AbcLNQnu (ORCPT ); Wed, 14 Dec 2016 11:43:50 -0500 Date: Wed, 14 Dec 2016 14:43:41 -0200 From: Mauro Carvalho Chehab To: Joe Perches Cc: Jonathan Corbet , Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Markus Heiser , "David S. Miller" , Andrew Morton , Greg Kroah-Hartman , Mauro Carvalho Chehab , Geert Uytterhoeven Subject: Re: [PATCH 0/2] Add maintainers to the admin guide Message-ID: <20161214144341.0d679d75@vento.lan> In-Reply-To: <1481732084.29291.54.camel@perches.com> References: <20161212110045.0cd6b16c@lwn.net> <1481576210.1764.41.camel@perches.com> <20161213073719.0223f2eb@vento.lan> <1481732084.29291.54.camel@perches.com> Organization: Samsung X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2724 Lines: 73 Em Wed, 14 Dec 2016 08:14:44 -0800 Joe Perches escreveu: > On Tue, 2016-12-13 at 07:38 -0200, Mauro Carvalho Chehab wrote: > > Em Mon, 12 Dec 2016 12:56:50 -0800 > > Joe Perches escreveu: > > > Does the boxing with the ======= blocks align properly? > > > It it really useful? Is there another/better way? > > > > Do you mean those? > > > > =============================== ================================ > > ``F:`` ``drivers/net/`` all files in and below > > ``drivers/net`` > > ``F:`` ``drivers/net/*`` all files in ``drivers/net``, > > but not below > > ``F:`` ``*/net/*`` all files in "any top level > > directory" ``/net`` > > =============================== ================================ > > Yes. > > > This is a table. We might instead use a literal block, like: > > > > :: > > > > ``F:`` ``drivers/net/`` all files in and below > > ``drivers/net`` > > ``F:`` ``drivers/net/*`` all files in ``drivers/net``, > > but not below > > ``F:`` ``*/net/*`` all files in "any top level > > directory" ``/net`` > > > > But the result looks uglier when generating LaTeX or HTML, as it won't > > unwrap the continuation lines of the field descriptions. > > > > Another alternative would be to use ascii artwork, like: > > > > +------------------------------------+----------------------------------+ > > | ``F:`` ``drivers/net/`` | all files in and below | > > | | ``drivers/net`` | > > +------------------------------------+----------------------------------+ > > | ``F:`` ``drivers/net/*`` | all files in ``drivers/net``, | > > | | but not below | > > +------------------------------------+----------------------------------+ > > | ``F:`` ``*/net/*`` | all files in "any top level | > > | | directory" ``/net`` | > > +------------------------------------+----------------------------------+ > > Isn't the ascii art is going to get odd looking > output after the sphinx conversion because of the > doubled quotes being converted to bold? Doubled quotes should be converted to monospaced fonts, and not to bold. We might remove the double quotes, but the end result would be worse, as we would need to escape the asterisks. > I suspect the table formatting just isn't necessary > and it could be paragraphed instead. We could use indented paragraphs instead, like: * ``F:`` ``drivers/net/`` all files in and below ``drivers/net`` * ``F:`` ``*/net/*`` all files in "any top level directory" ``/net`` But, IMHO, it would look worse than tables on both ASCII and on formatted outputs. Thanks, Mauro