On Wed, Jul 06, 2016 at 01:40:25PM -0700, Darren Hart wrote: > On Mon, Jul 04, 2016 at 12:40:35PM +0200, Lukas Wunner wrote: > > Convert asciidoc-formatted docs to rst in accordance with Jonathan's and > > Jani's effort to use sphinx for kernel-doc rendering in 4.8. > > Somebody help me out here. How do I verify this works and using sphinx? > to build the docs? (1) git remote add l1k https://github.com/l1k/linux.git git fetch l1k git checkout l1k/sphinx-docs (Alternatively: git cherry-pick v4.7-rc6..l1k/sphinx-docs ) (2) sudo apt-get install python-sphinx python-sphinx-rtd-theme (3) make xmldocs make htmldocs (4) open Documentation/output/html/index.html click on "VGA Switcheroo", then click on "Handlers" in the navigation pane on the left The apple-gmux docs are currently asciidoc-formatted. Support for markdown/asciidoc in kerneldoc was an Intel-sponsored effort last year led by Daniel, but never got upstreamed. After some deliberation the decision was made to use rst instead. Support for it is in docs-next, i.e. will be in 4.8. Jani has converted the gpu docs to rst and deleted the gpu.tmpl, this is on the drm-intel/for-linux-next branch but not yet in drm-next. Jani and Daniel are both on vacation. Daniel has indicated that he considers sending another drm-intel-next pull when he returns next week, then the rst-formatted gpu docs would land in drm-next: https://lists.freedesktop.org/archives/intel-gfx/2016-June/099114.html > Should I be merging this directly, or is it dependent on something Jon > is working on and therefore to be merged by him? It is not dependent on someone else. You can either merge it directly through your tree or alternatively ack it and have it merged through drm-intel trees by Daniel (+ cc:) next week. Unfortunately there is currently no branch which contains all the rst patches in docs-next *and* the rst-formatted gpu docs in drm-intel. (Some patches in docs-next are missing from drm-intel/for-linux-next.) That's why I pushed the above-mentioned branch to my GitHub repo, it contains everything needed: https://github.com/l1k/linux/commits/sphinx-docs Thanks, Lukas -- To unsubscribe from this list: send the line "unsubscribe platform-driver-x86" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
