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@xxxxxxxxxxx> 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. -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
