summaryrefslogtreecommitdiff
path: root/TODO
diff options
context:
space:
mode:
authorStefan Sauer <ensonic@users.sf.net>2012-11-06 09:59:33 +0100
committerStefan Sauer <ensonic@users.sf.net>2012-11-06 09:59:49 +0100
commit686ee86897823830f2e74a938d9161ec1350323f (patch)
tree32a1f22061f1d241ff10e186662c4ca6614efecf /TODO
parent995df4d73e852caa9685ae0acc2d675b0cf894a5 (diff)
downloadgtk-doc-686ee86897823830f2e74a938d9161ec1350323f.tar.gz
TODO: planning update
Diffstat (limited to 'TODO')
-rw-r--r--TODO11
1 files changed, 9 insertions, 2 deletions
diff --git a/TODO b/TODO
index 7f160d1..51c0d28 100644
--- a/TODO
+++ b/TODO
@@ -54,10 +54,12 @@ diff -u --exclude="Makefile*" docs docs-tmpl | diffstat
= Running =
-gtk-doc is using a makefile with several targets to get from sources to docs.
+gtk-doc is using a makefile with several targets to get from sources to docs. It
+uses makefile variables for configuration.
It might be easier to have a gtk-doc tool that can run the other gtk-doc tools
in the right order (ev. by importing them as modules). This could handle a few
-things nicer that the makefiles don't do well.
+things nicer that the makefiles don't do well. This would also make it easy to
+run it manually or integrate into other build systems.
= Issues =
* gtkdoc-fixxref makefile targets use $HTML_DIR
@@ -68,6 +70,11 @@ things nicer that the makefiles don't do well.
* the Makefile uses $(DESTDIR)$(TARGET_DIR)
where TARGET_DIR = $(HTML_DIR)/$(DOC_MODULE)
http://www.gnu.org/software/libtool/manual/automake/DESTDIR.html
+* gtkdoc does not know about module versions
+ * this is causing troubles when multiple library versions are installed
+ (gtk+-{2,3}, gstreamer-{0.8,0.10,1.0}
+ * right now gtk-doc is xreffing against any <module>/index.sgml found
+ * just using the one with a higher number won't work
= Extensibility =