doc-rst: flat-table directive - initial implementation
authorMarkus Heiser <markus.heiser@darmarIT.de>
Thu, 30 Jun 2016 12:00:22 +0000 (14:00 +0200)
committerJonathan Corbet <corbet@lwn.net>
Thu, 30 Jun 2016 18:58:33 +0000 (12:58 -0600)
commit0249a764485744b3f5babb02ced0fe6c199d89f7
treead2dfeccdf3854119df6e00692190e4d698bb1cf
parent17defc282fe6e6ac93edbad8873ce89ef86b2490
doc-rst: flat-table directive - initial implementation

Implements the reST flat-table directive.

The ``flat-table`` is a double-stage list similar to the ``list-table`` with
some additional features:

* column-span: with the role ``cspan`` a cell can be extended through
  additional columns

* row-span: with the role ``rspan`` a cell can be extended through
  additional rows

* auto span rightmost cell of a table row over the missing cells on the right
  side of that table-row.  With Option ``:fill-cells:`` this behavior can
  changed from *auto span* to *auto fill*, which automaticly inserts (empty)

list tables

  The *list tables* formats are double stage lists. Compared to the
  ASCII-art they migth be less comfortable for readers of the
  text-files. Their advantage is, that they are easy to create/modify
  and that the diff of a modification is much more meaningfull, because
  it is limited to the modified content.

The initial implementation was taken from the sphkerneldoc project [1]

[1] https://github.com/return42/sphkerneldoc/commits/master/scripts/site-python/linuxdoc/rstFlatTable.py

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
[jc: fixed typos and misspellings in the docs]
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py
Documentation/kernel-documentation.rst
Documentation/sphinx/rstFlatTable.py [new file with mode: 0644]