From: Keiron Liddle <keiron@apache.org>
Date: Tue, 3 Dec 2002 10:06:10 +0000 (+0000)
Subject: readme for generating docs
X-Git-Tag: Alt-Design-integration-base~267
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=83df33e174673318afb5b71c417c93b53e8156a5;p=xmlgraphics-fop.git

readme for generating docs


git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@195729 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/src/documentation/README b/src/documentation/README
new file mode 100644
index 000000000..1c75ce169
--- /dev/null
+++ b/src/documentation/README
@@ -0,0 +1,24 @@
+To update the docs:
+
+The documentation is generated using forrest (http://xml.apache.org/forrest/).
+
+The current procedure is:
+
+- checkout xml-forrest module
+- run: build.sh(bat) dist
+- follow instructions to set FORREST_HOME and path
+- go to xml-fop directory
+- run forrest(.bat)
+
+The documents will then be placed in build/site/
+
+NOTE: the compliance.html currently does not work, it can be fixed by
+adding the dtd ref to: build/tmp/context/resources/schema/catalog
+and placing the dtd in: build/tmp/context/resources/schema/dtd/
+
+To update website
+- put the generated docs into the xml-site module targets/fop/
+  this could be done by simlinking the destination to the targets/fop
+- commit the documents
+
+