From: Mauro Carvalho Chehab <mchehab@s-opensource.com>
To: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: linux-media@vger.kernel.org,
Hans Verkuil <hans.verkuil@cisco.com>,
Sakari Ailus <sakari.ailus@iki.fi>
Subject: Re: [RFC] Remove row numbers from tables in V4L2 documentation
Date: Thu, 22 Sep 2016 07:05:08 -0300 [thread overview]
Message-ID: <20160922070508.6cc6e249@vento.lan> (raw)
In-Reply-To: <7698306.QJLkYlHSte@avalon>
Em Wed, 21 Sep 2016 11:48:22 +0300
Laurent Pinchart <laurent.pinchart@ideasonboard.com> escreveu:
> Hello,
>
> While documenting the metadata API I got annoyed by how tables were converted
> from DocBook to ReST.
>
> The table format currently used by the documentation is as follows:
>
> - .. row 1
> - row 1, entry 1
> - row 1, entry 2
> - .. row 2
> - row 2, entry 1
> - row 2, entry 2
>
> The comments that include row numbers are not only useless, but make row
> insertion or deletion painful.
>
> I propose switching to the following format instead:
>
> * - row 1, entry 1
> - row 1, entry 2
> * - row 2, entry 1
> - row 2, entry 2
>
> I've pushed two patches that perform the conversion to
>
> git://linuxtv.org/pinchartl/media.git v4l2/doc
Applied. Thanks!
Thanks,
Mauro
prev parent reply other threads:[~2016-09-22 10:05 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-09-21 8:48 [RFC] Remove row numbers from tables in V4L2 documentation Laurent Pinchart
2016-09-21 9:24 ` Markus Heiser
2016-09-21 10:45 ` Laurent Pinchart
2016-09-22 10:05 ` Mauro Carvalho Chehab [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20160922070508.6cc6e249@vento.lan \
--to=mchehab@s-opensource.com \
--cc=hans.verkuil@cisco.com \
--cc=laurent.pinchart@ideasonboard.com \
--cc=linux-media@vger.kernel.org \
--cc=sakari.ailus@iki.fi \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.