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 2007/08/05 17:07:00 UTC
svn commit: r562881 - in
/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk:
compiling.xml configuration.xml extensions.xml fonts.xml graphics.xml
output.xml pdfencryption.xml running.xml upgrading.xml
Author: vhennebert
Date: Sun Aug 5 08:06:59 2007
New Revision: 562881
URL: http://svn.apache.org/viewvc?view=rev&rev=562881
Log:
Changes in the trunk tab:
- update content
- fix typos
- fix broken links
Modified:
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/compiling.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/configuration.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/extensions.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/fonts.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/graphics.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/output.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/pdfencryption.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/running.xml
xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/upgrading.xml
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/compiling.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/compiling.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/compiling.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/compiling.xml Sun Aug 5 08:06:59 2007
@@ -59,7 +59,7 @@
<p>
The build script uses <a href="ext:ant">Apache Ant</a>, a popular
Java-based build tool, which usually requires that the environment variable JAVA_HOME point to
- your local JDK root directory. This is true even if you use JDK 1.2 or above, which normally
+ your local JDK root directory. This is true even if you use JDK 1.3 or above, which normally
does not need this setting.
</p>
</section>
@@ -103,7 +103,8 @@
needed, but may be helpful if you are having problems with the build process itself.
</li>
<li>
- <strong>javadocs</strong>: Generates javadocs. This creates the FOP API documentation.
+ <strong>javadocs</strong>: Creates the FOP API documentation.
+ <note>A minimum JDK version of 1.4.2 is required for generating the javadocs.</note>
</li>
</ul>
<p>To run the build:</p>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/configuration.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/configuration.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/configuration.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/configuration.xml Sun Aug 5 08:06:59 2007
@@ -311,7 +311,7 @@
offered by Java.
</p>
<p>
- Additionally, there are certain settings that control who the renderer handles various elements.
+ Additionally, there are certain settings that control how the renderer handles various elements.
</p>
<source><![CDATA[<renderer mime="application/vnd.hp-PCL">
<rendering>quality</rendering>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/extensions.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/extensions.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/extensions.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/extensions.xml Sun Aug 5 08:06:59 2007
@@ -34,7 +34,7 @@
to you. If you wish to add an extension of your own to FOP, please see the
<a href="../dev/extensions.html">Developers' Extension Page</a>.
</p>
- <note>All extensions required the correct use of an appropriate namespace in your input document.</note>
+ <note>All extensions require the correct use of an appropriate namespace in your input document.</note>
<section id="svg">
<title>SVG</title>
<p>
@@ -52,10 +52,6 @@
</p>
<source><![CDATA[<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
xmlns:fox="http://xmlgraphics.apache.org/fop/extensions">]]></source>
- <note>
- Currently, no extension elements are implemented in FOP Trunk which use the
- FOP extension namespace.
- </note>
</section>
<section id="bookmarks">
<title>PDF Bookmarks</title>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/fonts.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/fonts.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/fonts.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/fonts.xml Sun Aug 5 08:06:59 2007
@@ -262,7 +262,7 @@
See <a href="configuration.html">FOP: Configuration</a> for more information.
</li>
<li>Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.</li>
- <li>The font "kerning" attribute is optional. Kerning is currently not used at all.</li>
+ <li>The font "kerning" attribute is optional.</li>
<li>If embedding is off, the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.</li>
<li>When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.</li>
<li>The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.</li>
@@ -291,14 +291,8 @@
<p>When FOP embeds a font, it adds a prefix to the fontname to ensure that the name will not match the fontname of an installed font.
This is helpful with older versions of Acrobat Reader that preferred installed fonts over embedded fonts.</p>
<p>When embedding PostScript fonts, the entire font is always embedded.</p>
- <p>When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the original font, containing only the glyphs used, is embedded in the output document.
-Currently, this embedded font contains only the minimum data needed to be embedded in a pdf document, and does not contain any codepage information.
-The PDF document contains indexes to the glyphs in the font instead of to encoded characters.
-While the document will be displayed correctly, the net effect of this is that searching, indexing, and cut-and-paste will not work properly.</p>
- <p>One workaround for this behavior is to use the "-enc ansi" option when generating metrics with TTFReader.
-This will cause the whole font to be embedded in the pdf document.
-Characters will be WinAnsi encoded (as specified in the PDF spec), so you lose the ability to use characters from other character sets.
-See <a href="#ttf-encoding">Table of TTF Encoding Options</a> for more details.</p>
+ <p>When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the
+ original font, containing only the glyphs used, is embedded in the output document.</p>
</section>
<section id="embedding-base14">
<title>Explicitly embedding the base 14 fonts</title>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/graphics.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/graphics.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/graphics.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/graphics.xml Sun Aug 5 08:06:59 2007
@@ -155,7 +155,6 @@
</section>
<section id="jai">
<title>JAI (Java Advanced Imaging API)</title>
- <warning>JAI support is available for Release 0.20.5 and later. The comments in this section do not apply to releases earlier than 0.20.5.</warning>
<p>
FOP has been compiled with JAI support, but JAI is not included in the FOP distribution.
To use it, install <a href="http://java.sun.com/products/java-media/jai">JAI</a>, then copy the jai_core.jar and the jai_codec.jar files to {fop-install-dir}/lib.
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/output.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/output.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/output.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/output.xml Sun Aug 5 08:06:59 2007
@@ -618,6 +618,9 @@
possible. The RTF output follows Microsoft's RTF specifications
and produces best results on Microsoft Word.
</p>
+ <note>RTF output is currently unmaintained and lacks many features compared to other output
+ formats. Using other editable formats like Open Document Format, instead of producing XSL-FO
+ then RTF through FOP, might give better results.</note>
</section>
<section id="xml">
<title>XML (Area Tree XML)</title>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/pdfencryption.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/pdfencryption.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/pdfencryption.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/pdfencryption.xml Sun Aug 5 08:06:59 2007
@@ -29,10 +29,6 @@
<body>
<section>
<title>Overview</title>
- <warning>
- PDF Encryption is available in Release 0.20.5 and later. The comments on this page do
- not apply to releases earlier than 0.20.5.
- </warning>
<p>
FOP supports encryption of PDF output, thanks to Patrick
C. Lankswert. This feature is commonly used to prevent
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/running.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/running.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/running.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/running.xml Sun Aug 5 08:06:59 2007
@@ -180,7 +180,7 @@
Fop foo.fo -awt]]></source>
<p>
PDF encryption is only available if FOP was compiled with encryption support
- <strong>and</strong> if compatible encryption support is availabe at run time.
+ <strong>and</strong> if compatible encryption support is available at run time.
Currently, only the JCE is supported. Check the <a href="pdfencryption.html">Details</a>.
</p>
</section>
@@ -339,11 +339,6 @@
This can be substantial if the page sequence contains lots of FO elements.
</li>
</ul>
- <p>
- One of FOP's stated design goals is to be able to process input of arbitrary size.
- Addressing this goal is one of the prime motivations behind the
- <a href="../dev/index.html">FOP Redesign</a>.
- </p>
</section>
<section id="problems">
<title>Problems</title>
Modified: xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/upgrading.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/upgrading.xml?view=diff&rev=562881&r1=562880&r2=562881
==============================================================================
--- xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/upgrading.xml (original)
+++ xmlgraphics/fop/branches/fop-0_94/src/documentation/content/xdocs/trunk/upgrading.xml Sun Aug 5 08:06:59 2007
@@ -79,17 +79,12 @@
</li>
<li>
Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP
- extension for <a href="http://barcode4j.krysalis.org">Barcode4J</a> will be available in
+ extension for <a href="http://barcode4j.krysalis.org">Barcode4J</a> is available since
January 2007.
</li>
<li>
- The PCL Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional
+ The SVG Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional
and hope for someone to step up and reimplement them.
- </li>
- <li>
- By looking at the <a href="../compliance.html">Compliance page</a> you might get the impression
- that the new code is much more advanced than version 0.20.5. That's true but there may still
- be a few things that may not be handled as gracefully by the new code as by version 0.20.5.
</li>
</ul>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org