Fixed and improved documentation about prepress extensions:

- AFAIU all of them have been implemented in both the PDF and Java2D renderers
- the default value of crop-offset is bleed


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

1 files changed, 21 insertions, 15 deletions

diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml
index 91c0b9c31..a635205d2 100644
--- a/src/documentation/content/xdocs/trunk/extensions.xml
+++ b/src/documentation/content/xdocs/trunk/extensions.xml
@@ -240,19 +240,20 @@ to following pages. Here is an example of FO code creating such a table-header:<
           registration marks, color bars and page information are placed.
           For details, please read on below.
         </p>
+        <note>
+          Those extensions have been implemented in the PDF and Java2D renderers only.
+        </note>
         
         <section id="scale">
           <title>fox:scale</title>
-          <p>Default: 1</p>
+          <p>Value: &lt;number&gt;{1,2}</p>
+          <p>Initial: 1</p>
+          <p>Applies to: fo:simple-page-master</p>
           <p>
-            <code>fox:scale="sx [sy]"</code> attribute is used in <code>fo:simple-page-master</code> element and specifies
-            the a scale operation by sx and sy. If sy is not provided, it is assumed to be equal to sx.
-            sx and sy should be a positive number. A scale factor smaller than 1 shrinks the page.
-            A scale factor greater than 1 enlarges the page.
+            This property specifies a scale factor along resp. the x and y axes. If only one number 
+            is provided it is used for both the x and y scales. A scale factor smaller than 1 
+            shrinks the page. A scale factor greater than 1 enlarges the page.
           </p>
-          <note>
-            It is implemented for PDF and Java2D renderers.
-          </note>
         </section>
         <section id="bleed">
           <title>fox:bleed</title>
@@ -260,15 +261,17 @@ to following pages. Here is an example of FO code creating such a table-header:<
               Value: &lt;length&gt;{1,4}
           </p>
           <p>
-              Default: 0pt
+              Initial: 0pt
           </p>
+          <p>Applies to: fo:simple-page-master</p>
           <p>
               If there is only one value, it applies to all sides. If there are two values, the top and bottom
               bleed widths are set to the first value and the right and left bleed widths are set to the second.
               If there are three values, the top is set to the first value, the left and right are set to the second,
               and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and
               left, respectively.
-              (Corresponds to <a href="http://www.w3.org/TR/xsl11/#padding">http://www.w3.org/TR/xsl11/#padding</a>).
+              (Corresponds to <a href="http://www.w3.org/TR/xsl11/#padding">the definition of 
+                padding</a>).
           </p>
           <p>
               This extension indirectly defines the BleedBox and is calculated by expanding the TrimBox by
@@ -281,10 +284,12 @@ to following pages. Here is an example of FO code creating such a table-header:<
             Value: &lt;length&gt;{1,4}
           </p>
           <p>
-            Default: 0pt
+            Initial: bleed (see below)
           </p>
+          <p>Applies to: fo:simple-page-master</p>
           <p>
-            Same behaviour as with fox:bleed.
+            Same behaviour as with fox:bleed. The initial value is set to the same values as the 
+            fox:bleed property.
           </p>
           <p>
             This extension indirectly defines the MediaBox and is calculated by expanding
@@ -294,11 +299,12 @@ to following pages. Here is an example of FO code creating such a table-header:<
         <section id="cropBox">
           <title>fox:crop-box</title>
           <p>
-            Value: (trim-box|bleed-box|media-box)
+            Value: [trim-box | bleed-box | media-box]
           </p>
           <p>
-            Default: media-box
+            Initial: media-box
           </p>
+          <p>Applies to: fo:simple-page-master</p>
           <p>
             The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes
             the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension
@@ -307,7 +313,7 @@ to following pages. Here is an example of FO code creating such a table-header:<
           </p>
           <p>
             If requested in the future, we could offer to specify the CropBox in absolute coordinates rather
-            than just be referencing another box.
+            than just by referencing another box.
           </p>
         </section>
       </section>