You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by vh...@apache.org on 2009/08/05 13:07:19 UTC

svn commit: r801130 - /xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml

Author: vhennebert
Date: Wed Aug  5 11:07:18 2009
New Revision: 801130

URL: http://svn.apache.org/viewvc?rev=801130&view=rev
Log:
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

Modified:
    xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml

Modified: xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml?rev=801130&r1=801129&r2=801130&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml (original)
+++ xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/extensions.xml Wed Aug  5 11:07:18 2009
@@ -240,19 +240,20 @@
           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>
-            <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.
-          </p>
-          <note>
-            It is implemented for PDF and Java2D renderers.
-          </note>
+          <p>Value: &lt;number&gt;{1,2}</p>
+          <p>Initial: 1</p>
+          <p>Applies to: fo:simple-page-master</p>
+          <p>
+            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>
         </section>
         <section id="bleed">
           <title>fox:bleed</title>
@@ -260,15 +261,17 @@
               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 @@
             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 @@
         <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 @@
           </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>



---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org