Finally - found the problem with the page generation (XMLPUBFUN not
* doc/html/*.html: Finally - found the problem with the
page generation (XMLPUBFUN not recognized by gtkdoc).
Re-created the pages using a temporary version of
include/libxml/*.h.
* testOOMlib.c,include/libxml/encoding.h,
include/libxml/schemasInternals.h,include/libxml/valid.h,
include/libxml/xlink.h,include/libxml/xmlwin32version.h,
include/libxml/xmlwin32version.h.in,
include/libxml/xpathInternals.h: minor edit of comments
to help automatic documentation generation
* doc/docdescr.doc: small elaboration
* doc/examples/test1.c,doc/examples/Makefile.am: re-commit
(messed up on last try)
* xmlreader.c: minor change to clear warning.
diff --git a/doc/docdescr.doc b/doc/docdescr.doc
index 46ea014..c375f2c 100644
--- a/doc/docdescr.doc
+++ b/doc/docdescr.doc
@@ -54,6 +54,7 @@
Steps 7 and 8 are performed with the command "make web"
1) Generate libxml-decl.txt, libxml-decl-list.txt and libxml-sections.txt:
+ make scan, or,
gtkdoc-scan --module=libxml --source-dir=../ \
--ignore-headers="acconfig.h config.h win32config.h trio.h triostr.h
triop.h config-m ac.h XMLTestPrefix2.h XMLTestPrefix.h
@@ -63,9 +64,11 @@
These three files are used by the gdk-doc routines in the following steps.
2) Generate the sgml documentation in the subdirectory "tmpl":
+ make templates, or,
gtkdoc-mktmpl --module=libxml
3) Generate the xml documentation in the subdirectory "xml":
+ make xml, or,
gtkdoc-mkdb --module=libxml --source-dir=../ --output-format=xml \
--main-sgml-file=gnome-xml.xml
@@ -75,6 +78,7 @@
titles.
4) Generate the main html documentation in the subdirectory "html":
+ make html, or,
cd html
gtkdoc-mkhtml libxml ../gnome-xml.xml
cd ../
@@ -101,7 +105,7 @@
information on the api's in the file "libxml2-api.xml", but that step is
now being done by a separate script.
-7) Generate the site's main page:
+7) Generate the site's main pages:
xsltproc --nonet --html --output index.html site.xsl xml.html
All of the "top-level" pages (except xmlreader.html and guidelines.html)
@@ -114,6 +118,7 @@
xsltproc --nonet --output ../NEWS news.xsl news.html
10)Generate the XML Software Autoupdate file libxml2.xsa:
+ make libxml2.xsa, or,
xsltproc --nonet --output libxml2.xsa xsa.xsl news.html
11)Manually generate xmlcatalog.1 and xmllint.1 using manpages/docbook.xsl