try to explain setting the size of output with transcoder a bit better

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

diff --git a/docs/xml-docs/fop/svg.xml b/docs/xml-docs/fop/svg.xml
index 375d319672e159a6be93b3acb705d6c9f3215a10..bbc6e5a0e20522168f9ec418721bdd8696ecfa80 100644 (file)
--- a/docs/xml-docs/fop/svg.xml
+++ b/docs/xml-docs/fop/svg.xml
@@ -31,8 +31,13 @@ This will output the svg document as "document.pdf" containing a PDF rendering o
 the SVG file.
     </p>
     <p>
-It is also possible to specify the width and/or height of the PDF document.
-Currently the SVG image is simply scaled in PDF so the result my not be the best possible.
+It is also possible to specify the width and/or height of the PDF document on the command line with -w and -h or if you are using the transcoder api you can use the transcoding hints.
+    </p>
+    <p>
+Currently the SVG image is drawn at the SVG document size and simply scaled in PDF to the new size. So the result may not be the best possible. For example if you have any images or effects it will draw them at the original resolution of the svg document. When this is viewed in the pdf it will have an incorrect resolution for the size of the pdf.
+</p>
+    <p>
+The size of the pdf file will also remain the same regardless of what size the page is.
     </p>
     <p>
 For more information see <jump href="http://xml.apache.org/batik/">Batik</jump> for