diff options
Diffstat (limited to 'src/documentation/content/xdocs/dev/design')
17 files changed, 28 insertions, 45 deletions
diff --git a/src/documentation/content/xdocs/dev/design/areas.xml b/src/documentation/content/xdocs/dev/design/areas.xml index 6966b782f..5b6038832 100644 --- a/src/documentation/content/xdocs/dev/design/areas.xml +++ b/src/documentation/content/xdocs/dev/design/areas.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Area Tree</title> diff --git a/src/documentation/content/xdocs/dev/design/breakpos.xml b/src/documentation/content/xdocs/dev/design/breakpos.xml index f76a91ee8..67808ee1b 100644 --- a/src/documentation/content/xdocs/dev/design/breakpos.xml +++ b/src/documentation/content/xdocs/dev/design/breakpos.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/configuration.xml b/src/documentation/content/xdocs/dev/design/configuration.xml index 43d8ebe61..10fe17ca1 100644 --- a/src/documentation/content/xdocs/dev/design/configuration.xml +++ b/src/documentation/content/xdocs/dev/design/configuration.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd" [ +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd" [ <!ENTITY lsquo "‘"> <!ENTITY rsquo "’"> <!ENTITY ldquo "“"> @@ -52,7 +51,7 @@ well-formed.</p> <section id="general-available"> <title>Making Configuration Available to FOP</title> <p>After creating your configuration file, you must tell FOP how -to find it.</p> +to find it.</p> <section id="command-line"> <title>From the Command Line</title> @@ -67,7 +66,7 @@ configuration file as the option value.</p> <code>org.apache.avalon.framework.configuration</code>. For detailed information, see the documentation of the package.</p> <p>If you want to use a user configuration file with your -embedded program, you need to build an Avalon configuration +embedded program, you need to build an Avalon configuration object from it, and register that with the user agent:</p> <source>FOUserAgent foUserAgent; @@ -132,17 +131,17 @@ which are provided by this font file. See the example configuration file for details.</dd> </dl> <p>The example configuration file provides for details about the -other renderers.</p> +other renderers.</p> </section> <section id="hyphenation-dir"> <title>Hyphenation</title> <p>When FOP needs to load a hyphenation file for a certain -language and country combination, it follows these steps.</p> +language and country combination, it follows these steps.</p> <ol> <li>FOP searches for the compiled hyphenation file (extension <code>hyp</code> in the directory <code>hyph</code> in the -class path.</li> +class path.</li> <li>FOP searches for the compiled or the XML hyphenation file in a user directory. At the time of this writing FOP does not read the configuration file for the user directory. It always @@ -195,7 +194,7 @@ org.apache.commons.logging.simplelog.log.org.apache.fop.pdf=trace </source> <p>FOP uses several named loggers. When you set the logging level for all loggers to “info”, you get a decent small amount -of information +of information about application progress. The debugging and especially the trace levels produce a lot of output. If you need these logging levels, it is wise to switch them on for one or several specific loggers. The diff --git a/src/documentation/content/xdocs/dev/design/embedding.xml b/src/documentation/content/xdocs/dev/design/embedding.xml index 2fe66f2fe..ab4bcf282 100644 --- a/src/documentation/content/xdocs/dev/design/embedding.xml +++ b/src/documentation/content/xdocs/dev/design/embedding.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/extending.xml b/src/documentation/content/xdocs/dev/design/extending.xml index 17d5763c8..db242acf2 100644 --- a/src/documentation/content/xdocs/dev/design/extending.xml +++ b/src/documentation/content/xdocs/dev/design/extending.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/fotree.xml b/src/documentation/content/xdocs/dev/design/fotree.xml index cc99cb22f..c379866ae 100644 --- a/src/documentation/content/xdocs/dev/design/fotree.xml +++ b/src/documentation/content/xdocs/dev/design/fotree.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: FO Tree</title> diff --git a/src/documentation/content/xdocs/dev/design/images.xml b/src/documentation/content/xdocs/dev/design/images.xml index c946090f9..e2aebcb94 100644 --- a/src/documentation/content/xdocs/dev/design/images.xml +++ b/src/documentation/content/xdocs/dev/design/images.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/index.xml b/src/documentation/content/xdocs/dev/design/index.xml index d74e13232..4a6a41770 100644 --- a/src/documentation/content/xdocs/dev/design/index.xml +++ b/src/documentation/content/xdocs/dev/design/index.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Introduction</title> diff --git a/src/documentation/content/xdocs/dev/design/layout.xml b/src/documentation/content/xdocs/dev/design/layout.xml index 3973a192a..86686c485 100644 --- a/src/documentation/content/xdocs/dev/design/layout.xml +++ b/src/documentation/content/xdocs/dev/design/layout.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Layout</title> @@ -73,7 +72,7 @@ Other cases are tables and lists, these objects will also have layout managers t <p>A layout manager is also able to determine height (min/max/optimum) and keep status. This will be used when organising the layout on a page. The manager will be able to determine the next place a break can be made and then be able to organise the height.</p> - <p>A layout manager is essentially a bridge between the formatting objects and the area tree. + <p>A layout manager is essentially a bridge between the formatting objects and the area tree. It will keep a list of line areas inside block areas. Each line area will contain a list of inline areas that is able to be adjusted if the need arises.</p> <p>The objects in the area tree that are organised by the manager will mostly contain the information about there layout such as spacing and keeps, this information will be thrown away once the layout for a page is finalised.</p> @@ -164,7 +163,7 @@ The body region should be in the order before float, main then footnote.</p> <p>Creating a line areas uses a similair concept. Each inline area is placed across the available space until there is no room left. The line is then split by considering all keeps and spacing.</p> - <p>Each word (group of adjacent character inline areas) will have keeps based on hyphenation. + <p>Each word (group of adjacent character inline areas) will have keeps based on hyphenation. The line break is at the lowest keep value starting from the end of the line.</p> <p>Once a line has been layed out for a particular width then that line is fixed for the page (except for unresolved page references).</p> </section> @@ -280,7 +279,7 @@ Then the next equally low keep is found to determine if the spacing will be clos <title>Before Floats/Footnotes</title> <p>After filling the page with the block areas then the new body height is used to find the best position to break. Before each line area or block area is remove any associated before floats and footnotes are removed. -This will then adjust the available space on the page and may allow for a different breaking point. +This will then adjust the available space on the page and may allow for a different breaking point. Areas are removed towards the new breaking point until the areas fit on the page. When finding the optimum spacing the removal of before floats and footnotes must also be onsidered.</p> </section> @@ -382,12 +381,12 @@ that requires further analysis.</td> <tr> <td>Border collapsing on tables</td> <td>Low</td> - <td>RenderX hasnt implemented this (17/03/04)</td> + <td>RenderX hasnt implemented this (17/03/04)</td> </tr> <tr> <td>Fine-tuning all other borders</td> <td>Low</td> - <td>Not sure what Joerg means by this, border collapse priorties? + <td>Not sure what Joerg means by this, border collapse priorties? Dashed and dotted borders have been implemented in PDF</td> </tr> <tr> diff --git a/src/documentation/content/xdocs/dev/design/optimise.xml b/src/documentation/content/xdocs/dev/design/optimise.xml index 162dd9d64..a5f3004ec 100644 --- a/src/documentation/content/xdocs/dev/design/optimise.xml +++ b/src/documentation/content/xdocs/dev/design/optimise.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/parsing.xml b/src/documentation/content/xdocs/dev/design/parsing.xml index d3b253df2..f218eb887 100644 --- a/src/documentation/content/xdocs/dev/design/parsing.xml +++ b/src/documentation/content/xdocs/dev/design/parsing.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Input Parsing</title> diff --git a/src/documentation/content/xdocs/dev/design/pdf-library.xml b/src/documentation/content/xdocs/dev/design/pdf-library.xml index ba6fa01d7..88a14a9eb 100644 --- a/src/documentation/content/xdocs/dev/design/pdf-library.xml +++ b/src/documentation/content/xdocs/dev/design/pdf-library.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/properties.xml b/src/documentation/content/xdocs/dev/design/properties.xml index 1ffb247b2..879f287b0 100644 --- a/src/documentation/content/xdocs/dev/design/properties.xml +++ b/src/documentation/content/xdocs/dev/design/properties.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Properties</title> diff --git a/src/documentation/content/xdocs/dev/design/renderers.xml b/src/documentation/content/xdocs/dev/design/renderers.xml index 4c169e71f..e1cf8a532 100644 --- a/src/documentation/content/xdocs/dev/design/renderers.xml +++ b/src/documentation/content/xdocs/dev/design/renderers.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Renderers</title> diff --git a/src/documentation/content/xdocs/dev/design/startup.xml b/src/documentation/content/xdocs/dev/design/startup.xml index c4da884d6..9281af08b 100644 --- a/src/documentation/content/xdocs/dev/design/startup.xml +++ b/src/documentation/content/xdocs/dev/design/startup.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> <title>FOP Design: Startup, Environment, Control</title> diff --git a/src/documentation/content/xdocs/dev/design/svg.xml b/src/documentation/content/xdocs/dev/design/svg.xml index 6779fb919..f5ea6e8ae 100644 --- a/src/documentation/content/xdocs/dev/design/svg.xml +++ b/src/documentation/content/xdocs/dev/design/svg.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> diff --git a/src/documentation/content/xdocs/dev/design/useragent.xml b/src/documentation/content/xdocs/dev/design/useragent.xml index 329778fec..36032a519 100644 --- a/src/documentation/content/xdocs/dev/design/useragent.xml +++ b/src/documentation/content/xdocs/dev/design/useragent.xml @@ -16,8 +16,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd"> <document> <header> |