summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorStefan Sauer <ensonic@users.sf.net>2017-11-01 20:56:06 +0100
committerStefan Sauer <ensonic@users.sf.net>2017-11-01 20:57:09 +0100
commit5e6c8034adacdf08da4f46770a9000e79b182841 (patch)
tree501a2e78236ed227e01734a463ae90cd1f432aef /doc
parent8ad03e164f3091df68a9fed5492b54cd61d0ac51 (diff)
downloadgtk-doc-5e6c8034adacdf08da4f46770a9000e79b182841.tar.gz
design: add more details for the xml transition
Diffstat (limited to 'doc')
-rw-r--r--doc/design-2.x.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/design-2.x.txt b/doc/design-2.x.txt
index fbbd46c..6eb5fb8 100644
--- a/doc/design-2.x.txt
+++ b/doc/design-2.x.txt
@@ -94,3 +94,13 @@ We can enable such a toolchain via the configure flavors option.
TODO:
- markdown does not define a way to aggregate fragments into a large book
- we can only concat all the files in a stable order
+
+As a first step we need to make sure we only render the html files with docbook.
+Right now we also produce the devhelp files using xslt (see devhelp2.xsl). We
+should be able to produce the devhelp files from gtkdoc-mkdb directly. We can
+generate this file outside of the html dir (and adjust the make install target).
+The tricky part is that we might need to scan the static content files to be
+able to generate the same toc.
+A nice extra benefit would be that this should already make things faster.
+
+