Author: jonathan
Date: Thu Mar 18 14:12:25 2010
New Revision: 924790
URL: http://svn.apache.org/viewvc?rev=924790&view=rev
Log:
Now using a Makefile, rather than ant.
Modified:
qpid/trunk/qpid/doc/book/README.txt
Modified: qpid/trunk/qpid/doc/book/README.txt
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/README.txt?rev=924790&r1=924789&r2=924790&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/README.txt (original)
+++ qpid/trunk/qpid/doc/book/README.txt Thu Mar 18 14:12:25 2010
@@ -3,22 +3,31 @@ original content was taken from the Apac
1. Building the Documentation
-To build the documentation, use ant:
+You need the following to build the documentation:
-$ ant
+- Apache FOP, version 0.95 or higher
+- Docbook 4.5
+- Docbook XSL stylesheets - I have tested with xsl-stylesheets-1.75.2
+- xsltproc
+- xmllint
-You need both ant and ant-trax, and xmllint (or another XInclude
-processor - if you do not use xmllint, you must change build.xml). On
-Fedora, you can get them using yum:
+On many Linux machines, these can usually be installed from standard
+repos. For instance, on Fedora they can be installed as follows:
-$ sudo yum install ant ant-trax xmllint
+$ sudo yum install fop docbook-dtds docbook-style-xsl libxslt libxml2
-The other tools that you need are in subdirectories:
+After installing, use make to build the documentation:
+
+$ make
+
+By default, the Makefile builds a PDF. It supports the following
+targets:
+
+pdf Make the PDF
+html Make HTML pages
+all Make both PDF and HTML
+clean Delete the build and output directories
-qpid/doc/book/docbook - Docbook 4.5 DTDs
-qpid/doc/book/docbook-xsl - Docbook XSLT stylesheets
-qpid/doc/book/lib/saxon - Saxon 6.5.3 XSLT processor
-qpid/doc/book/lib/fop-0.95 - Apache FOP
You will see quite a few error messages. Many of these are due to
unresolved links, and these should go away. Many are due to the
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]