diff options
| author | Jani Nikula <jani.nikula@intel.com> | 2018-04-26 17:55:18 +0300 |
|---|---|---|
| committer | Jani Nikula <jani.nikula@intel.com> | 2018-04-26 18:42:59 +0300 |
| commit | 91a6c4c459fcdc33cdc40c5bbf02199e5efee16d (patch) | |
| tree | 94c6dfd217c3020164996922fa1d622c3f599913 | |
| parent | bf433359a5ed06446cea6f4182a8dffb86517045 (diff) | |
build: drop rst2html documentation build
We've long since moved on to Sphinx for everything except the 'dim help'
and 'qf help' commands that spawn rst2html to display the man pages.
Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Jani Nikula <jani.nikula@intel.com>
| -rw-r--r-- | Makefile | 28 |
1 files changed, 11 insertions, 17 deletions
@@ -1,8 +1,11 @@ -# This depends on rst2html and graphviz, and the resulting html uses -# http://wavedrom.com/ online for rendering the timeline. The offline wavedrom -# conversion seems a bit tricky to install, but is possible if needed. To edit -# the wavedrom json, copy-pasting to and from http://wavedrom.com/editor.html is -# handy as it shows the result live. +# The documentation build depends on Sphinx and graphviz, and the resulting html +# uses http://wavedrom.com/ online for rendering the timeline. The offline +# wavedrom conversion seems a bit tricky to install, but is possible if +# needed. To edit the wavedrom json, copy-pasting to and from +# http://wavedrom.com/editor.html is handy as it shows the result live. +# +# The man pages and mancheck depend on rst2html, but the rest of the pages don't +# need to be limited to rst2html. # You can set these variables from the command line. SPHINXOPTS = @@ -20,23 +23,14 @@ I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . CFLAGS = -O2 -g -Wextra .PHONY: all -all: drm-intel.html dim.html drm-misc.html remap-log +all: remap-log %.svg: %.dot dot -T svg -o $@ $< -%.html: %.rst - rst2html $< > $@ - remap-log: remap-log.c $(CC) $(CFLAGS) -o $@ $< -drm-intel.html: drm-intel.rst drm-intel-flow.svg drm-intel-timeline.rst drm-intel-timeline.json - -drm-misc.html: drm-misc.rst drm-misc-timeline.rst drm-misc-timeline.json drm-misc-commit-flow.svg - -dim.html: dim.rst - SC_EXCLUDE := \ -e SC2001 \ -e SC2034 \ @@ -63,11 +57,11 @@ mancheck: rst2man --strict --no-raw dim.rst >/dev/null rst2man --strict --no-raw qf.rst >/dev/null -check: shellcheck mancheck all +check: shellcheck mancheck .PHONY: clean clean: - rm -rf drm-intel.html drm-intel-flow.svg drm-misc-commit-flow.svg dim.html drm-misc.html $(BUILDDIR) + rm -rf drm-intel-flow.svg drm-misc-commit-flow.svg $(BUILDDIR) .PHONY: help help: |