diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/design/README | 6 | ||||
| -rw-r--r-- | docs/design/areas.xml | 5 | ||||
| -rw-r--r-- | docs/design/build.sh | 8 | ||||
| -rw-r--r-- | docs/design/build.xml | 6 | ||||
| -rw-r--r-- | docs/design/fop.xml | 2 | ||||
| -rw-r--r-- | docs/design/optimise.xml | 4 | ||||
| -rw-r--r-- | docs/design/useragent.xml | 6 |
7 files changed, 27 insertions, 10 deletions
diff --git a/docs/design/README b/docs/design/README index b419caf2a..8d7b4e995 100644 --- a/docs/design/README +++ b/docs/design/README @@ -2,10 +2,14 @@ These documents are written for docbook http://sourceforge.net/projects/docbook To convert to pdf: -- place the docbook files in a directory name "docbook" +- place the docbook files in a directory named "docbook" +download and unzip the docbook distribution into the +directory <cvs>/docs/design/dockbook/ + - place docbookx package in a directory name "docbookx" the files are avaialable here: http://www.oasis-open.org/docbook/xml/4.1.2/index.shtml + - run the build script diff --git a/docs/design/areas.xml b/docs/design/areas.xml index 201fb6035..a58a2eaf9 100644 --- a/docs/design/areas.xml +++ b/docs/design/areas.xml @@ -7,7 +7,10 @@ defined in the specification. A number of optimisations may be possible for similar areas and groups of areas. </para> <para> - +Since the area tree will be used during the layout by the layout managers +it will need to store information that affects the layout. The information +such as spacing and keeps will be held in such a way that it can be +discarded once the layout is finalised. </para> </section> diff --git a/docs/design/build.sh b/docs/design/build.sh index 3222894f1..ff55ede59 100644 --- a/docs/design/build.sh +++ b/docs/design/build.sh @@ -1,9 +1,10 @@ #! /bin/sh # $Id$ -LIBDIR=../../lib +LIBDIR=../../lib TARGET_CLASSPATH=$LIBDIR/ant.jar:\ $LIBDIR/buildtools.jar:\ +$LIBDIR/xalan-2.0.0.jar:\ $LIBDIR/xalan-1.2.2.jar:\ $LIBDIR/xerces-1.2.3.jar:\ $LIBDIR/bsf.jar:\ @@ -11,7 +12,6 @@ $LIBDIR/bsf.jar:\ $LIBDIR/logkit-1.0b4.jar:\ $LIBDIR/avalon-framework-4.0.jar:\ $LIBDIR/batik.jar:\ -$LIBDIR/optional.jar:\ $LIBDIR/jimi-1.0.jar: if [ "$JAVA_HOME" != "" ] ; then @@ -19,5 +19,5 @@ if [ "$JAVA_HOME" != "" ] ; then else echo "Error: The JAVA_HOME environment variable is not set." fi - -java -classpath $TARGET_CLASSPATH -Djboss.home=$JBOSS_HOME org.apache.tools.ant.Main $* + +java -classpath $TARGET_CLASSPATH org.apache.tools.ant.Main $* diff --git a/docs/design/build.xml b/docs/design/build.xml index 999e7bfb6..ad17b53b9 100644 --- a/docs/design/build.xml +++ b/docs/design/build.xml @@ -12,6 +12,7 @@ <property name="lib.dir" value="${basedir}/lib"/> + <taskdef name="xslt" classname="org.apache.fop.tools.anttasks.Xslt"/> <taskdef name="fop" classname="org.apache.fop.tools.anttasks.Fop"/> </target> @@ -42,11 +43,16 @@ <target name="pdf" depends="prepare"> <echo message="Building pdf documentation. Please wait ..."/> <delete file="fop.fo"/> + <xslt infile="fop.xml" xsltfile="docbook/fo/docbook.xsl" + dependent="fop.xml" + outfile="fop.fo" smart="yes"/> +<!-- <style basedir="./" destdir="./" style="docbook/fo/docbook.xsl" extension=".fo" includes="fop.xml"/> +--> <fop fofile="fop.fo" pdffile="fop.pdf"/> <!-- <delete file="fop.fo"/>--> </target> diff --git a/docs/design/fop.xml b/docs/design/fop.xml index 0b6d9bfbd..1b7b48496 100644 --- a/docs/design/fop.xml +++ b/docs/design/fop.xml @@ -23,7 +23,7 @@ <title>Areas</title> &areas.xml; </chapter> -<chapter id="areas"> +<chapter id="optimise"> <title>Optimising</title> &optimise.xml; </chapter> diff --git a/docs/design/optimise.xml b/docs/design/optimise.xml index 291481436..273bf6b01 100644 --- a/docs/design/optimise.xml +++ b/docs/design/optimise.xml @@ -1,5 +1,5 @@ <?xml version = "1.0" encoding = "UTF-8"?> -<section id="optimise"> +<section id="optimisations"> <title>Process Optimisations</title> <para> FOP should be able to handle very large documents. A document can be @@ -30,7 +30,7 @@ as minimal as possible. <para> Line areas can be optimised once the layout for the line has been finalised. Consecutive characters with the same properties -can be combined into a "word" to hold the infomration with +can be combined into a "word" to hold the information with limited overhead. </para> diff --git a/docs/design/useragent.xml b/docs/design/useragent.xml index 5900e97db..ad24e6e73 100644 --- a/docs/design/useragent.xml +++ b/docs/design/useragent.xml @@ -13,6 +13,10 @@ rendering the document. The user agent must be available to the layout processor and the renderer. Users can supply their own user agent or use the default one for a particular renderer. + </para> + <para> +The user agent needs to be made available to the property +resolution layout process and the renderer. </para> <para> @@ -35,7 +39,7 @@ title, used to identify a set of pages (in a page sequence) </para></listitem> <listitem><para> the width (in inline-progression-dimension) of a character with -trea-word-as-space true +treat-word-as-space true </para></listitem> <listitem><para> maximum space used by conditional areas from region-reference-area |