From 595cc7e41a922e3b85ccd200c2c57aede8a72149 Mon Sep 17 00:00:00 2001 From: Clay Leeds Date: Thu, 2 Aug 2007 06:08:49 +0000 Subject: [PATCH] Changes to fop-0_94 branch to prepare it for 0.94 release. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_94@562023 13f79535-47bb-0310-9956-ffa450edef68 --- .../content/xdocs/0.94/configuration.xml | 7 ++ .../content/xdocs/0.94/fonts.xml | 15 ++++- .../content/xdocs/0.94/index.xml | 23 ++++--- src/documentation/content/xdocs/0.94/pdfx.xml | 4 +- .../content/xdocs/0.94/upgrading.xml | 3 +- .../content/xdocs/dev/release.xml | 22 +++---- src/documentation/content/xdocs/faq.xml | 64 +++++++++---------- src/documentation/content/xdocs/index.xml | 2 +- src/documentation/content/xdocs/relnotes.xml | 15 +++-- src/documentation/content/xdocs/site.xml | 30 +++++---- .../content/xdocs/trunk/upgrading.xml | 4 +- 11 files changed, 110 insertions(+), 79 deletions(-) diff --git a/src/documentation/content/xdocs/0.94/configuration.xml b/src/documentation/content/xdocs/0.94/configuration.xml index b7984e773..6321b4e8e 100644 --- a/src/documentation/content/xdocs/0.94/configuration.xml +++ b/src/documentation/content/xdocs/0.94/configuration.xml @@ -332,6 +332,13 @@

+
+ Apache FOP Font Config +

+ Apache FOP has special Font considerations, which are explained in detail + on the Fonts page. +

+
When it does not work diff --git a/src/documentation/content/xdocs/0.94/fonts.xml b/src/documentation/content/xdocs/0.94/fonts.xml index 2ee297ba0..e6424dff6 100644 --- a/src/documentation/content/xdocs/0.94/fonts.xml +++ b/src/documentation/content/xdocs/0.94/fonts.xml @@ -234,7 +234,7 @@ It will display all of the font names and exit with an Exception.

msmincho.ttc msminch.xml
- Register Fonts with FOP + Register Fonts with FOP - Auto-Detect Fonts

You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:

@@ -254,7 +254,18 @@ It will display all of the font names and exit with an Exception.

]]> - Review the documentation for FOP Configuration for instructions on making the FOP configuration available to FOP when it runs. Otherwise, FOP has no way of finding your custom font information. + + Review the documentation for FOP Configuration for + instructions on making the FOP configuration available to FOP when it runs. Otherwise, + FOP has no way of finding your custom font information. + + The Unix autodetect feature looks in the following locations for fonts it can use: +
    +
  • java user.home + "/.fonts"
  • +
  • "/usr/local/fonts"
  • +
  • "/usr/share/fonts"
  • +
  • "/usr/X11R6/lib/X11/fonts"
  • +
  • URLs are used to access the font metric and font files. diff --git a/src/documentation/content/xdocs/0.94/index.xml b/src/documentation/content/xdocs/0.94/index.xml index 80092d054..750047678 100644 --- a/src/documentation/content/xdocs/0.94/index.xml +++ b/src/documentation/content/xdocs/0.94/index.xml @@ -19,24 +19,21 @@
    - Apache FOP Trunk (Development code) + Apache FOP Version 0.94 $Revision: 201586 $
    Introduction

    - FOP Trunk is the name for the current - development code as found in the Subversion repository. This - section of the FOP web site provides the documentation for - this version. + The Apache FOP team is proud to present to you this production quality release. + We're still in the process of adding new features. We welcome any feedback you + might have and even more, any other form of help to get the project forward.

    - The Apache FOP team is proud to present to you this production quality codebase. It has taken - over three years to get this far and over two years without a new release from the FOP - project. We're still in the process of adding new features. We welcome any feedback you - might have and even more, any other form of help to get the project forward. + This fifth release contains many bug fix release and new features compared + to 0.92beta. To see what has changed since the last release, please visit the + Changes Page and the Release Notes.

    @@ -46,5 +43,11 @@ information contained on the Upgrading page!

    +
    + Download +

    + To download this version, please visit the download page. +

    +
    diff --git a/src/documentation/content/xdocs/0.94/pdfx.xml b/src/documentation/content/xdocs/0.94/pdfx.xml index cf796c74d..342a0ca4c 100644 --- a/src/documentation/content/xdocs/0.94/pdfx.xml +++ b/src/documentation/content/xdocs/0.94/pdfx.xml @@ -28,8 +28,8 @@
    Overview - Support for PDF/X is available beginning with version 0.93. This feature is new and - may not be 100% complete, yet. Feedback is welcome. + Support for PDF/X was made available beginning with version 0.93. + This feature is new and may not be 100% complete, yet. Feedback is welcome.

    PDF/X is a standard which faciliates prepress digital data exchange using PDF. diff --git a/src/documentation/content/xdocs/0.94/upgrading.xml b/src/documentation/content/xdocs/0.94/upgrading.xml index 46c9cff3b..f99cdc93a 100644 --- a/src/documentation/content/xdocs/0.94/upgrading.xml +++ b/src/documentation/content/xdocs/0.94/upgrading.xml @@ -31,7 +31,8 @@

    • - More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached production level. + More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached production level, and + the tradition continues with version 0.94.
    • The API of FOP has changed considerably and is not diff --git a/src/documentation/content/xdocs/dev/release.xml b/src/documentation/content/xdocs/dev/release.xml index 8785d8789..7d6ca5734 100644 --- a/src/documentation/content/xdocs/dev/release.xml +++ b/src/documentation/content/xdocs/dev/release.xml @@ -38,12 +38,12 @@ The purpose of documenting it here is to facilitate consistency, ensure that the
    • Determine whether further testing is required.
    • Commit any outstanding changes
    • Create a branch called branches/fop-v_vv
    • -
    • Edit release notes (README and status.xml in the root).
    • -
    • Update the index.xml and site.xml for the new version.
    • +
    • Edit release notes (README and status.xml in the root).
    • +
    • Update the index.xml and site.xml for the new version.
    • Update the version numbers in the release column on the - compliance page; update the compliance in the release column + compliance page (compliance.xml); update the compliance in the release column to the current state (development column).
    • -
    • Update version number in build.xml (not to be merged back +
    • Update version number in build.xml (not to be merged back into trunk).
    • Copy trunk documentation directory to a new directory with the version number, and update any links and the .htaccess @@ -62,10 +62,10 @@ The purpose of documenting it here is to facilitate consistency, ensure that the people.apache.org
    • Ask on fop-dev to check the branch and the generated dist files for errors.
    • -
    • Tag the source tree with the release ID. For example, if the release is 0.93: - svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_93 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_93
    • +
    • Tag the source tree with the release ID. For example, if the release is 0.94: + svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_94 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_94
    • Make a fresh checkout with the just created tag: - svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_93
    • + svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_94
    • Copy jimi and jai to lib/ (jimi-1.0.jar, jai_core.jar, jai_codec.jar)
    • Copy jce-jdk13-119.jar from from http://www.bouncycastle.org/latest_releases.html to lib/
    • @@ -75,15 +75,15 @@ The purpose of documenting it here is to facilitate consistency, ensure that the
    • Alternatively, create a build-local.properties file that points to the above libs.
    • Run build[.sh] dist. Do this once using Sun JDK 1.3.1_15 or later and once with Sun JDK 1.4.2_08 or later. A Forrest installation is needed.
    • Create signatures. Don't forget to upload your KEY: - gpg -a -b --force-v3-sigs fop-0.93-src.tar.gz etc.
    • + gpg -a -b --force-v3-sigs fop-0.94-src.tar.gz etc.
    • Upload the dist and signature files to your web directory on people.apache.org (An account on minotaur is needed): - scp fop-0.93*.tar.gz* + scp fop-0.94*.tar.gz* chrisg@people.apache.org:public_html/
    • Check permissions: chmod 664 ... ; chgrp xmlgraphics ...
    • -
    • Add MD5 sums: md5 fop-0.93-src.tar.gz > - fop-0.93-src.tar.gz.md5 etc.
    • +
    • Add MD5 sums: md5 fop-0.94-src.tar.gz > + fop-0.94-src.tar.gz.md5 etc.
    • Make a test download.
    • Start a vote for the release on general@xmlgraphics.a.o. The message should point diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index b34003773..7fe2f5443 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -138,10 +138,10 @@

      When it's ready and the committers have enough time to go through the time-consuming process of creating a release. We - released version 0.93 on 9 January 2007, and intend to - release version 1.0 later in 2007. If you - want to speed up the process, consider to - contribute to FOP.

      + released version 0.94 on XX August 2007, and intend to + release version 1.0 later in late 2007 or early 2008. If you + want to speed up the process, consider + contributing to FOP.

      @@ -211,7 +211,7 @@ If you run FOP embedded in your servlet, web application or other Java application, check the classpath of the application. Check the also the information pertaining to servlet engines + href="0.94/servlets.html#servlet-engine">servlet engines for further hints.

      @@ -241,7 +241,7 @@ I get an OutOfMemoryException.

      - See FOP Memory. + See FOP Memory.

      @@ -302,7 +302,7 @@

      If you use XSLT, problems in your style sheet and in your source XML also can produce a NullPointerException. Run the transformation + href="0.94/running.html#check-input">Run the transformation separately to check for this, usually you'll get a detailed error message from the XSLT processor.

      @@ -380,7 +380,7 @@

      Try also setting the font-base + href="0.94/configuration.html#general-elements">font-base configuration.

      @@ -389,7 +389,7 @@ Problems with FOP output - Leaders don't work anymore in 0.93. Instead of + Leaders don't work anymore in 0.94. Instead of filling the line, only three dots or a short ruler is output. @@ -470,7 +470,7 @@ Check the following:

      Other possibilities:

      • The image format is not supported or not supported completely. - See FOP Graphics Formats for a + See FOP Graphics Formats for a list of supported formats and related issues.
      • The graphic may be too large to fit into the intended space.
      • There may be something (static content) that is obscuring the @@ -482,14 +482,14 @@ Check the following:

        My graphical images do not work properly. -

        See FOP Graphics Formats for a +

        See FOP Graphics Formats for a list of supported graphics formats and related issues.

        Why is my graphic rendered at a different resolution than it was created? -

        See Graphics Resolution.

        +

        See Graphics Resolution.

        @@ -621,7 +621,7 @@ Check the following:

        Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):

        ]]> -

        See Hyphenation Support for details and instructions on using hyphenation with FOP.

        +

        See Hyphenation Support for details and instructions on using hyphenation with FOP.

        Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):

        ]]>
        @@ -652,7 +652,7 @@ Check the following:

        How do I use FOP in a servlet?

        - See Using FOP in a Servlet. + See Using FOP in a Servlet.

        @@ -661,7 +661,7 @@ Check the following:

        transformation?

        - See Using FOP in a Servlet with XSLT Transformation. + See Using FOP in a Servlet with XSLT Transformation.

        @@ -669,7 +669,7 @@ Check the following:

        How do I pass parameters to the XSLT transformation?

        - See Using FOP in a Servlet with XSLT Transformation. + See Using FOP in a Servlet with XSLT Transformation.

        @@ -687,7 +687,7 @@ Check the following:

        How do I set the baseDir property in a servlet environment?

        - See Setting the Configuration Programmatically. + See Setting the Configuration Programmatically.

        @@ -695,7 +695,7 @@ Check the following:

        How do I use a user configuration file from a servlet?

        - See Using a Configuration File in an Embedded App. + See Using a Configuration File in an Embedded App.

        @@ -704,7 +704,7 @@ Check the following:

        get FOP working for various servlet engines?

        - See Servlet Engines. + See Servlet Engines.

        @@ -712,7 +712,7 @@ Check the following:

        Can FOP be used in multithreaded environments?

        - See Multithreading FOP. + See Multithreading FOP.

        @@ -723,13 +723,13 @@ Check the following:

        The rendering of SVG text in my PDF is of poor quality. Can I control this? -

        See Placing SVG Text into PDF.

        +

        See Placing SVG Text into PDF.

        How do I use FOP with SVG on headless servers? -

        See FOP: Graphics (Batik).

        +

        See FOP: Graphics (Batik).

        @@ -792,7 +792,7 @@ Can I control this? Why is my SVG rendered at a size different from that specified in my fo:external-graphic element? -

        See SVG Scaling.

        +

        See SVG Scaling.

        @@ -825,7 +825,7 @@ Can I control this? How do I embed fonts in PDF?

        - See the Fonts page for information + See the Fonts page for information about embedding fonts.

        @@ -844,7 +844,7 @@ Can I control this? set. For a variety of reasons, even those are not completely guaranteed to work, for example you can't use the fi ligature from the standard serif font. Check the overview for the default + href="0.94/output.html#pdf-fonts">overview for the default PDF fonts.

        @@ -852,7 +852,7 @@ Can I control this? the desired character. Furthermore the font must be available on the machine where the PDF is viewed or it must have been embedded in the PDF file. See embedding fonts. + href="0.94/fonts.html">embedding fonts.

        For most symbols, it is better to select the symbol font @@ -870,7 +870,7 @@ Can I control this? What tools are available for post-processing my PDF document? -

        See PDF Post-processing.

        +

        See PDF Post-processing.

        @@ -878,8 +878,8 @@ Can I control this? to my PDF document?

        - See PDF Encryption. - See also PDF Post-processing. + See PDF Encryption. + See also PDF Post-processing.

        @@ -887,13 +887,13 @@ Can I control this? How do I add document properties (title, author, etc.) to my PDF document? -

        See PDF Post-processing.

        +

        See PDF Post-processing.

        How do I add watermarks to my PDF document? -

        See PDF Watermarks.

        +

        See PDF Watermarks.

        @@ -929,7 +929,7 @@ Can I control this?

        This is a problem of Internet Explorer requesting the content several - times. Please see the notes on Internet Explorer + times. Please see the notes on Internet Explorer for more information.

        diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml index 2d8550202..b0f44fac3 100644 --- a/src/documentation/content/xdocs/index.xml +++ b/src/documentation/content/xdocs/index.xml @@ -31,7 +31,7 @@ application that reads a formatting object (FO) tree and renders the resulting pages to a specified output. Output formats currently supported include PDF, PS, PCL, AFP, XML (area tree representation), - Print, AWT, PNG and TXT. The primary output target is PDF. + Print, AWT and PNG, and to a lesser extent, RTF and TXT. The primary output target is PDF.

        diff --git a/src/documentation/content/xdocs/relnotes.xml b/src/documentation/content/xdocs/relnotes.xml index 8499d674b..0037817bd 100644 --- a/src/documentation/content/xdocs/relnotes.xml +++ b/src/documentation/content/xdocs/relnotes.xml @@ -44,11 +44,11 @@

      • The API has changed between 0.91beta this release. - Please consult the "Upgrading" page for details. + Please consult the "Upgrading" page for details.
      • You may experience different behaviour compared to version 0.20.5. - Please consult the "Upgrading" page for details. + Please consult the "Upgrading" page for details.

      Known Issues:

      @@ -177,7 +177,7 @@
    • You may experience different behaviour compared to version 0.20.5. - Please consult the "Upgrading" page indicated above for details. + Please consult the "Upgrading" page indicated above for details.

    Known Issues:

    @@ -318,7 +318,7 @@
  • You may experience different behaviour compared to version 0.20.5. - Please consult the "Upgrading" page indicated above for details. + Please consult the "Upgrading" page indicated above for details.

Known Issues:

@@ -430,7 +430,7 @@
FOP 0.20.5 -

This is the last planned release in the 0.20.x series (aka maintenance branch).

+

This was the last release in the 0.20.x series (aka maintenance branch).

Important changes since the last release (0.20.4):

  • Some hyphenation patterns (cs, da, de, de_DR, el, en, en_US, fr, nl, @@ -461,7 +461,8 @@
  • Links in PDF won't generate multiple link rectangles anymore. If this causes a problem you can set the system property "links.merge" to "no".
  • -
  • FOP has been compiled with cryptography support. See +
  • FOP has been compiled with cryptography support. See + PDF encryption for details about installation and usage.
  • The behaviour of leader has changed. See @@ -496,7 +497,7 @@ support for additional truetype fonts in AWT Viewer.
  • Logging has been changed from LogKit to Avalon's Logger Interface. - (see Embedding for details). + (see Embedding for details).
  • Building under JDK 1.4: You need to add a method in diff --git a/src/documentation/content/xdocs/site.xml b/src/documentation/content/xdocs/site.xml index f1e4c4960..e82163089 100644 --- a/src/documentation/content/xdocs/site.xml +++ b/src/documentation/content/xdocs/site.xml @@ -55,11 +55,15 @@ --> - + - + + + + + @@ -68,29 +72,31 @@ - + + + + - - + - + - - + + @@ -117,7 +123,7 @@