From c525b8cd71144ff2c6dfec6b302ac13abafaecf1 Mon Sep 17 00:00:00 2001
From: Keiron Liddle
Date: Tue, 19 Nov 2002 07:57:29 +0000
Subject: [PATCH] The attached patch file contains: 1. Valid URIs for all xdoc
DTD declarations. 2. Some minor changes for xdoc documents that were
discovered to be invalid after the DTD declarations were fixed. 3. Changed
tabs.xml so that the 2nd tab on our site will now read "Redesign" instead of
"dev" (this was discussed in a recent thread). Submitted By: vic@outfitr.com
(Victor Mote)
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@195562 13f79535-47bb-0310-9956-ffa450edef68
---
src/documentation/content/xdocs/book.xml | 4 +-
src/documentation/content/xdocs/bugs.xml | 3 +-
src/documentation/content/xdocs/compiling.xml | 3 +-
.../content/xdocs/compliance.xml | 3 +-
.../content/xdocs/configuration.xml | 3 +-
.../content/xdocs/design/architecture.xml | 3 +-
.../content/xdocs/design/areas.xml | 39 ++--
.../content/xdocs/design/book.xml | 3 +-
.../content/xdocs/design/breakpos.xml | 3 +-
.../content/xdocs/design/embedding.xml | 13 +-
.../content/xdocs/design/extending.xml | 9 +-
.../content/xdocs/design/fotree.xml | 5 +-
.../content/xdocs/design/index.xml | 5 +-
.../content/xdocs/design/layout.xml | 33 ++--
.../content/xdocs/design/optimise.xml | 3 +-
.../content/xdocs/design/properties.xml | 3 +-
.../content/xdocs/design/renderers.xml | 3 +-
.../content/xdocs/design/status.xml | 7 +-
.../content/xdocs/design/useragent.xml | 171 +++++-------------
src/documentation/content/xdocs/dev/book.xml | 3 +-
.../content/xdocs/dev/configuration.xml | 27 +--
.../content/xdocs/dev/examples.xml | 11 +-
.../content/xdocs/dev/extensions.xml | 28 +--
src/documentation/content/xdocs/dev/faq.xml | 4 +-
src/documentation/content/xdocs/dev/index.xml | 8 +-
src/documentation/content/xdocs/dev/svg.xml | 39 ++--
src/documentation/content/xdocs/download.xml | 3 +-
src/documentation/content/xdocs/embedding.xml | 3 +-
src/documentation/content/xdocs/examples.xml | 3 +-
.../content/xdocs/extensions.xml | 3 +-
src/documentation/content/xdocs/faq.xml | 4 +-
src/documentation/content/xdocs/fonts.xml | 3 +-
src/documentation/content/xdocs/gethelp.xml | 3 +-
.../content/xdocs/implemented.xml | 3 +-
src/documentation/content/xdocs/index.xml | 25 +--
src/documentation/content/xdocs/involved.xml | 3 +-
src/documentation/content/xdocs/license.xml | 3 +-
.../content/xdocs/limitations.xml | 3 +-
src/documentation/content/xdocs/news.xml | 3 +-
src/documentation/content/xdocs/output.xml | 3 +-
src/documentation/content/xdocs/relnotes.xml | 3 +-
src/documentation/content/xdocs/resources.xml | 15 +-
src/documentation/content/xdocs/running.xml | 3 +-
src/documentation/content/xdocs/status.xml | 3 +-
src/documentation/content/xdocs/svg.xml | 3 +-
src/documentation/content/xdocs/tabs.xml | 5 +-
src/documentation/content/xdocs/testing.xml | 3 +-
47 files changed, 237 insertions(+), 299 deletions(-)
diff --git a/src/documentation/content/xdocs/book.xml b/src/documentation/content/xdocs/book.xml
index c1a85cc9d..fb9334be6 100644
--- a/src/documentation/content/xdocs/book.xml
+++ b/src/documentation/content/xdocs/book.xml
@@ -1,5 +1,7 @@
-
+
+
-
+
diff --git a/src/documentation/content/xdocs/compiling.xml b/src/documentation/content/xdocs/compiling.xml
index 61baf4c12..9026af99e 100644
--- a/src/documentation/content/xdocs/compiling.xml
+++ b/src/documentation/content/xdocs/compiling.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/compliance.xml b/src/documentation/content/xdocs/compliance.xml
index 0290c7097..26e829118 100644
--- a/src/documentation/content/xdocs/compliance.xml
+++ b/src/documentation/content/xdocs/compliance.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/configuration.xml b/src/documentation/content/xdocs/configuration.xml
index eddf1ea18..d5924cd25 100644
--- a/src/documentation/content/xdocs/configuration.xml
+++ b/src/documentation/content/xdocs/configuration.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/architecture.xml b/src/documentation/content/xdocs/design/architecture.xml
index 2adab8f1b..f76fc9273 100644
--- a/src/documentation/content/xdocs/design/architecture.xml
+++ b/src/documentation/content/xdocs/design/architecture.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/areas.xml b/src/documentation/content/xdocs/design/areas.xml
index 38e3e7c2e..9d30e0dc1 100644
--- a/src/documentation/content/xdocs/design/areas.xml
+++ b/src/documentation/content/xdocs/design/areas.xml
@@ -1,16 +1,17 @@
-
+
-
- Area Tree
- Area Tree Design for FOP
-
-
-
-
+
+ Area Tree
+ Area Tree Design for FOP
+
+
+
+
-
+
Area Tree
@@ -169,21 +170,13 @@ Inline
The renderer will need to be able to:
+
-
-render each individual page
-
-
-clip and align child areas to a viewport
-
-
-handle all types of inline area, text, image etc.
-
-
-draw various lines and rectangles
-
+ - render each individual page
+ - clip and align child areas to a viewport
+ - handle all types of inline area, text, image etc.
+ - draw various lines and rectangles
-
An abstract renderer will be able to handle the generic positioning
of child areas, iterating through areas that have child areas.
@@ -191,6 +184,6 @@ of child areas, iterating through areas that have child areas.
-
+
diff --git a/src/documentation/content/xdocs/design/book.xml b/src/documentation/content/xdocs/design/book.xml
index 6f8fa0d98..43e5e4834 100644
--- a/src/documentation/content/xdocs/design/book.xml
+++ b/src/documentation/content/xdocs/design/book.xml
@@ -1,5 +1,6 @@
-
+
-
+
diff --git a/src/documentation/content/xdocs/design/embedding.xml b/src/documentation/content/xdocs/design/embedding.xml
index 2572c74af..42812b063 100644
--- a/src/documentation/content/xdocs/design/embedding.xml
+++ b/src/documentation/content/xdocs/design/embedding.xml
@@ -1,5 +1,6 @@
-
+
@@ -34,52 +35,44 @@ specific information. The list of user agent values can be found on the
Logging
-
- logging level
- logging messages of various levels
- error handling
- Logging setup (LogKit, Log4J, JDK14Logging)
-
XML input
-
- various ways to supply FOP with the xsl:fo file, fo, xml+xsl
- sax handler
-
general options
-
- base directory
- uri resolvers
- which implementation of a particular
- LayoutManager to use
-
Rendering Options
-
- embedding fonts
- compression in pdf
- image embedding
-
for the PS renderer (eventually):
+
- PostScript Level
- PPD to use
- binary/ascii switch
-
User Agent
diff --git a/src/documentation/content/xdocs/design/extending.xml b/src/documentation/content/xdocs/design/extending.xml
index d0a954586..35d468422 100644
--- a/src/documentation/content/xdocs/design/extending.xml
+++ b/src/documentation/content/xdocs/design/extending.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/layout.xml b/src/documentation/content/xdocs/design/layout.xml
index 0f08bcb66..1d99728f3 100644
--- a/src/documentation/content/xdocs/design/layout.xml
+++ b/src/documentation/content/xdocs/design/layout.xml
@@ -1,5 +1,6 @@
-
+
@@ -119,7 +120,7 @@ n(orphans) + n(widows) in total. This will only be relevant for areas at
the start or end of a particular reference area.
-
+
The spacing between the areas (including spacing in block areas inside
@@ -267,7 +268,7 @@ also effected as there must be enough space on the page to fit the
side float.
-
+
@@ -369,27 +370,15 @@ when the value is resolved.
Block Areas
The block area has info about the following:
+
-
-all anchors including which lines they are on
-
-
-unresolved page references with line info
-
-
-id and link areas
-
-
-height (min/max/optimum) or area including floats
-
-
-holds space before/after and keep information
-
-
-widows and orphans
-
+ - all anchors including which lines they are on
+ - unresolved page references with line info
+ - id and link areas
+ - height (min/max/optimum) or area including floats
+ - holds space before/after and keep information
+ - widows and orphans
-
Once the layout has been finalised then this information can be
discarded.
diff --git a/src/documentation/content/xdocs/design/optimise.xml b/src/documentation/content/xdocs/design/optimise.xml
index b65f35dcb..0bb51ea90 100644
--- a/src/documentation/content/xdocs/design/optimise.xml
+++ b/src/documentation/content/xdocs/design/optimise.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/properties.xml b/src/documentation/content/xdocs/design/properties.xml
index f905f9fa9..bcc4983ce 100644
--- a/src/documentation/content/xdocs/design/properties.xml
+++ b/src/documentation/content/xdocs/design/properties.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/renderers.xml b/src/documentation/content/xdocs/design/renderers.xml
index be491f420..01b9e53cc 100644
--- a/src/documentation/content/xdocs/design/renderers.xml
+++ b/src/documentation/content/xdocs/design/renderers.xml
@@ -1,5 +1,6 @@
-
+
diff --git a/src/documentation/content/xdocs/design/status.xml b/src/documentation/content/xdocs/design/status.xml
index 2d9857e8a..fcc24db07 100644
--- a/src/documentation/content/xdocs/design/status.xml
+++ b/src/documentation/content/xdocs/design/status.xml
@@ -1,5 +1,6 @@
-
+
@@ -26,7 +27,6 @@ A number of issues have been dealt with in the redesigned code.
Features TODO
-
- avalon integration - logging, configuration, component management, caching, uri resolver
- improved interfaces
@@ -37,7 +37,6 @@ A number of issues have been dealt with in the redesigned code.
- better commandline handling
-
Done/Started Features
@@ -45,6 +44,7 @@ A number of issues have been dealt with in the redesigned code.
Many of these changes will make FOP much better to use and develop.
So if you help out with the development you can get to use these
things sooner.
+
- better layout design - that can handle keeps and
spacing better
@@ -69,7 +69,6 @@ this is done automatically
- changed area tree xml format to match the area tree hierarchy
-
diff --git a/src/documentation/content/xdocs/design/useragent.xml b/src/documentation/content/xdocs/design/useragent.xml
index e6dffe3d9..3a64366c7 100644
--- a/src/documentation/content/xdocs/design/useragent.xml
+++ b/src/documentation/content/xdocs/design/useragent.xml
@@ -1,5 +1,6 @@
-
+
@@ -39,137 +40,57 @@ resolution layout process and the renderer.
Standard Features:
+
-
-error handling, what to do if fo markup is invalid
-
-
-auto overflow value and handling error-if-overflow
-
-
-adjusting length values (eg. for borders) to renderable values
-
-
-available fonts
-
-
-converting cm/in to pt (dpi)
-
-
-active state for multi properties
-
-
-title, used to identify a set of pages (in a page sequence)
-
-
-the width (in inline-progression-dimension) of a character with
-treat-word-as-space true
-
-
-maximum space used by conditional areas from region-reference-area
-
-
-if there should be "hot links" to before floats or footnotes
-
-
-when to clear side floats if space in inline-progression-dimension
-is not enough
-
-
-placement of left over footnotes on a page with a region-body
-
-
-using color property as border colour
-
-
-interpretting all border styles (except outset) as solid
-
-
-thin, medium and thick values for border width
-
-
-initial font-family value
-
-
-absolute font sizes (eg, xx-small, x-small etc.)
-
-
-relative font sizes (eg. larger, smaller)
-
-
-small caps simulation
-
-
-font weight mapping
-
-
-baseline info for a font if not available
-
-
-determining sub/superscript when another baseline is dominant
-
-
-scaling method for external-graphic and instream-foreign-object
-
-
-the width of a replaced element
-
-
-"normal" line height value
-
-
-text alignment (stretching the line with letter and word spacing)
-
-
-text transform
-
-
-initial color
-
-
-rendering intent of auto
-
-
-dot character for leader
-
-
-line breaking with leaders, use optimum length when breaking the line
-
-
-page height/width of auto
-
-
-left and right caption widths
-
-
-glyph orientation vertical of auto
-
-
-rendering processor of content-type (mime type)
-
+ - error handling, what to do if fo markup is invalid
+ - auto overflow value and handling error-if-overflow
+ - adjusting length values (eg. for borders) to renderable values
+ - available fonts
+ - converting cm/in to pt (dpi)
+ - active state for multi properties
+ - title, used to identify a set of pages (in a page sequence)
+ - the width (in inline-progression-dimension) of a character with
+treat-word-as-space true
+ - maximum space used by conditional areas from region-reference-area
+ - if there should be "hot links" to before floats or footnotes
+ - when to clear side floats if space in inline-progression-dimension
+is not enough
+ - placement of left over footnotes on a page with a region-body
+ - using color property as border colour
+ - interpretting all border styles (except outset) as solid
+ - thin, medium and thick values for border width
+ - initial font-family value
+ - absolute font sizes (eg, xx-small, x-small etc.)
+ - relative font sizes (eg. larger, smaller)
+ - small caps simulation
+ - font weight mapping
+ - baseline info for a font if not available
+ - determining sub/superscript when another baseline is dominant
+ - scaling method for external-graphic and instream-foreign-object
+ - the width of a replaced element
+ - "normal" line height value
+ - text alignment (stretching the line with letter and word spacing)
+ - text transform
+ - initial color
+ - rendering intent of auto
+ - dot character for leader
+ - line breaking with leaders, use optimum length when breaking the line
+ - page height/width of auto
+ - left and right caption widths
+ - glyph orientation vertical of auto
+ - rendering processor of content-type (mime type)
-
Interactive Features:
+
-
-inline and block scroll amount
-
-
-dynamic effects, links and property sets
-
-
-initial "pause-after", "pause-before" and "voice-family" value
-
-
-treating fixed as scroll on background attachement
-
-
-media usage of auto
-
+ - inline and block scroll amount
+ - dynamic effects, links and property sets
+ - initial "pause-after", "pause-before" and "voice-family" value
+ - treating fixed as scroll on background attachement
+ - media usage of auto
-
diff --git a/src/documentation/content/xdocs/dev/book.xml b/src/documentation/content/xdocs/dev/book.xml
index 44c8096cc..7d4a73c43 100644
--- a/src/documentation/content/xdocs/dev/book.xml
+++ b/src/documentation/content/xdocs/dev/book.xml
@@ -1,5 +1,6 @@
-
+
-
-
-
-
-
- Configuring FOP
-
+
+
+
+
+
+
+ Configuring FOP
+
In the directory xml-fop/conf you will find an example
configuration file. It contains the default values of various
configurable options available in FOP.
@@ -40,6 +42,7 @@ configurable options available in FOP.
and rebuild Fop. The file will be picked up and added
to the fop.jar.
-
-
-
+
+
+
+
diff --git a/src/documentation/content/xdocs/dev/examples.xml b/src/documentation/content/xdocs/dev/examples.xml
index 008f04537..210f42c5a 100644
--- a/src/documentation/content/xdocs/dev/examples.xml
+++ b/src/documentation/content/xdocs/dev/examples.xml
@@ -1,5 +1,7 @@
-
+
+