[PATCH 0/6] Documentation: convert DocBook gpu.tmpl to reStructuredText

Jani Nikula jani.nikula at intel.com
Mon Jun 20 15:07:07 UTC 2016


Hi all, this series converts the DocBook gpu.tmpl to reStructuredText,
now that we have Sphinx support merged to docs-next and drm-next.

I haven't really touched the content, this is just a fairly mechanical
conversion and split up of the document. I'm sure there are small issues
here and there, but I think it would be more beneficial to spread the
load of fixing things up instead of me tweaking it in a corner by myself
ad infinitum.

Moreover, I think it's a good time to look at the documentation from a
broader perspective (and IMO it's actually easier to grasp that when
it's in RST and built with Sphinx), so perhaps it would be better to
tweak the remaining formatting issues while improving the documentation
as a whole.

Cc: Jon and linux-doc as FYI, but I think we'd like to merge this via
drm-next.

Comments welcome.


BR,
Jani.


Jani Nikula (6):
  Documentation/gpu: add new gpu.rst converted from DocBook gpu.tmpl
  Documentation/gpu: split up the gpu documentation
  MAINTAINERS: add Documentation/gpu and Documentation/gpu/i915.rst
  Documentation/gpu: use recommended order of heading markers
  Documentation/gpu: convert the KMS properties table to CSV
  Documentation/DocBook: remove gpu.tmpl

 Documentation/DocBook/Makefile                |    2 +-
 Documentation/DocBook/gpu.tmpl                | 3528 -------------------------
 Documentation/gpu/drm-internals.rst           | 1745 ++++++++++++
 Documentation/gpu/drm-userland-interfaces.rst |   92 +
 Documentation/gpu/i915.rst                    |  347 +++
 Documentation/gpu/index.rst                   |   11 +
 Documentation/gpu/introduction.rst            |   51 +
 Documentation/gpu/kms-properties.csv          |  128 +
 Documentation/gpu/vga-switcheroo.rst          |  102 +
 Documentation/index.rst                       |    1 +
 MAINTAINERS                                   |    3 +-
 11 files changed, 2480 insertions(+), 3530 deletions(-)
 delete mode 100644 Documentation/DocBook/gpu.tmpl
 create mode 100644 Documentation/gpu/drm-internals.rst
 create mode 100644 Documentation/gpu/drm-userland-interfaces.rst
 create mode 100644 Documentation/gpu/i915.rst
 create mode 100644 Documentation/gpu/index.rst
 create mode 100644 Documentation/gpu/introduction.rst
 create mode 100644 Documentation/gpu/kms-properties.csv
 create mode 100644 Documentation/gpu/vga-switcheroo.rst

-- 
2.1.4



More information about the dri-devel mailing list