lkml.org 
[lkml]   [2016]   [Dec]   [14]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
SubjectRe: [PATCH 0/2] Add maintainers to the admin guide
From
Date
On Tue, 2016-12-13 at 07:38 -0200, Mauro Carvalho Chehab wrote:
> Em Mon, 12 Dec 2016 12:56:50 -0800
> Joe Perches <joe@perches.com> 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?

I suspect the table formatting just isn't necessary
and it could be paragraphed instead.

\
 
 \ /
  Last update: 2016-12-14 17:15    [W:0.081 / U:0.136 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site