man: convert to reStructuredText

Graphics / Mesa 3D Graphics Library / libdrm - Simon Ser [emersion.fr] - 10 December 2020 09:17 UTC

DocBook makes it hard to write and maintain docs. Hopefully reStructuredText can make this less painful.

The man pages were converted from DocBook to reStructuredText via Pandoc:

pandoc -s -f docbook -t rst -o man/drm.7.rst man/drm.xml

And then manual editing to fixup e.g. references to other man pages. To compare the result with the DocBook version, this command was used:

rst2man man/drm-kms.7.rst | man -l -

05b0a955 man: convert to reStructuredText
.gitlab-ci.yml | 5 +-
.gitlab-ci/debian-install.sh | 5 +-
man/drm-kms.7.rst | 229 ++++++++++++++++++++++
man/drm-kms.xml | 341 ---------------------------------
man/drm-memory.7.rst | 322 +++++++++++++++++++++++++++++++
man/drm-memory.xml | 429 ------------------------------------------
man/drm.7.rst | 91 +++++++++
man/drm.xml | 136 -------------
man/drmAvailable.3.rst | 41 ++++
man/drmAvailable.xml | 74 --------
man/drmHandleEvent.3.rst | 62 ++++++
man/drmHandleEvent.xml | 101 ----------
man/drmModeGetResources.3.rst | 92 +++++++++
man/drmModeGetResources.xml | 138 --------------
man/meson.build | 57 ++----
meson.build | 14 +-
16 files changed, 858 insertions(+), 1279 deletions(-)

Upstream: cgit.freedesktop.org


  • Share