]> source.dussan.org Git - xmlgraphics-fop.git/commitdiff
"build/site" is now copied to "docs".
authorJeremias Maerki <jeremias@apache.org>
Fri, 18 Nov 2005 21:17:11 +0000 (21:17 +0000)
committerJeremias Maerki <jeremias@apache.org>
Fri, 18 Nov 2005 21:17:11 +0000 (21:17 +0000)
The build directory isn't included in either distribution anymore.
Source distribution doesn't contain fop.jar, javadocs and compiled docs anymore to make the distribution smaller.
KEYS and status.xml and lib/xalan*.txt added (Thanks, Simon).
Added version info to javadocs.
Removed limitation to build javadocs only with JDKs >= 1.4. It works fine for me on Win32 Sun JDK 1.3.1_15.
You can add "javahome.jdk14" to your build-local.properties so Forrest docs can be built during a JDK 1.3 distribution build.
Added release notes to site (Thanks, Christian, for the reminder).

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_90@345576 13f79535-47bb-0310-9956-ffa450edef68

build.xml
src/documentation/content/xdocs/relnotes.xml

index 24dd315c8dbd53b3fa93c8ded788b473dab1c7a3..1c57d10a6f3dd1772854da908511254a0aaadaed 100644 (file)
--- a/build.xml
+++ b/build.xml
@@ -62,19 +62,14 @@ list of possible build targets.
 
   <fileset dir="${basedir}" id="dist.bin">
     <include name="conf/**"/>
-    <include name="build/site/**"/>
-    <!--include name="CHANGES"/-->
+    <include name="examples/**"/>
     <include name="LICENSE"/>
     <include name="NOTICE"/>
     <include name="README"/>
-    <!--include name="STATUS"/-->
+    <include name="KEYS"/>
+    <include name="status.xml"/>
     <include name="fop.bat"/>
     <include name="fop"/>
-    <include name="examples/**"/>
-    <exclude name="docs/**"/>
-    <exclude name="src/**"/>
-    <exclude name="dist/**"/>
-    <exclude name="lib/**"/>
   </fileset>
 
   <fileset dir="${basedir}" id="dist.bin.lib">
@@ -85,17 +80,13 @@ list of possible build targets.
       <include name="lib/commons-logging*"/>
       <include name="lib/README*"/>
       <include name="lib/serializer*"/>
-      <include name="lib/xalan-*"/>
+      <include name="lib/xalan*"/>
       <include name="lib/xerces*"/>
       <include name="lib/xml-apis*"/>
     </patternset>
   </fileset>
 
   <fileset dir="${basedir}" id="dist.src">
-    <exclude name="lib/classes/**"/>
-    <exclude name="lib/org/**"/>
-    <exclude name="lib/src/**"/>
-    <include name="build/site/**"/>
     <include name="src/**"/>
     <include name="conf/**"/>
     <include name="hyph/hyphenation.dtd"/>
@@ -104,11 +95,11 @@ list of possible build targets.
     <include name="lib/servlet*"/>
     <include name="test/**"/>
     <include name="examples/**"/>
-    <!--include name="CHANGES"/-->
     <include name="LICENSE"/>
     <include name="NOTICE"/>
     <include name="README"/>
-    <!--include name="STATUS"/-->
+    <include name="KEYS"/>
+    <include name="status.xml"/>
     <include name="build.*"/>
     <include name="fop.bat"/>
     <include name="fop"/>
@@ -830,7 +821,7 @@ NOTE:
   <!-- Creates the API documentation                                       -->
   <!-- =================================================================== -->
   <target name="javadocs" depends="codegen" description="Generates javadocs">
-    <condition property="javadoc.version.ok">
+    <!--condition property="javadoc.version.ok">
       <not>
         <or>
           <equals arg1="${ant.java.version}" arg2="1.1"/>
@@ -839,7 +830,7 @@ NOTE:
         </or>
       </not>
     </condition>
-    <fail message="Building FOP javadocs requires at least Java 1.4" unless="javadoc.version.ok"/>
+    <fail message="Building FOP javadocs requires at least Java 1.4" unless="javadoc.version.ok"/-->
     <property name="javadoc.public"  value="false"/>
     <property name="javadoc.package" value="false"/>
     <property name="javadoc.private" value="false"/>
@@ -861,7 +852,7 @@ NOTE:
         destdir="${build.javadocs.dir}"
         author="true"
         version="true"
-        windowtitle="${Name} API"
+        windowtitle="${Name} ${version} API"
         doctitle="Apache Formatting Objects Processor (FOP)"
         bottom="Copyright ${year} The Apache Software Foundation. All Rights Reserved."
         overview="${src.dir}/java/org/apache/fop/overview.html"
@@ -870,6 +861,8 @@ NOTE:
         public="${javadoc.public}"
         package="${javadoc.package}"
         private="${javadoc.private}">
+      <header><![CDATA[${name} ${version}]]></header>
+      <footer><![CDATA[${name} ${version}]]></footer>
       <classpath>
         <path refid="libs-build-classpath"/>
         <pathelement path="${java.class.path}"/>
@@ -1043,10 +1036,24 @@ NOTE:
     <echo message="Make sure you have a proper Forrest installation (see http://forrest.apache.org/)"/>
 
     <!--<antcall target="site"/>-->
+    
+    <!-- You can provide a JDK 1.4 for a JDK 1.3 build by adding "javahome.jdk14" to build-local.properties -->
+    <condition property="javahome.jdk14.override" value="${javahome.jdk14}">
+      <isset property="javahome.jdk14"/>
+    </condition>
+    <echo message="java home: ${javahome.jdk14.override}"/>
+    <condition property="javahome.jdk14.override" value="${env.JAVA_HOME}">
+      <not>
+        <isset property="javahome.jdk14.override"/>
+      </not>
+    </condition>
+    <echo message="java home: ${javahome.jdk14.override}"/>
     <condition property="forrest.call" value="forrest.bat" else="forrest">
       <os family="windows"/>
     </condition>
-    <exec executable="${forrest.call}"/>
+    <exec executable="${forrest.call}">
+      <env key="JAVA_HOME" value="${javahome.jdk14.override}"/>
+    </exec>
   </target>
   
   <!-- =================================================================== -->
@@ -1054,7 +1061,7 @@ NOTE:
   <!-- =================================================================== -->
   <target name="dist" depends="dist-src,dist-bin" description="Generates the distribution package"/>
 
-  <target name="dist-bin" depends="all,docs">
+  <target name="dist-bin" depends="all,javadocs,docs">
     <echo message="Building the binary distribution files (zip,tar)"/>
     <fail message="A complete binary build requires Jimi" unless="jimi.present"/>
     <fail message="A complete binary build requires JAI" unless="jai.present"/>
@@ -1064,6 +1071,12 @@ NOTE:
       <fileset refid="dist.bin"/>
       <fileset refid="dist.bin.lib"/>
     </copy>
+    <copy todir="${dist.bin.result.dir}/docs">
+      <fileset dir="${build.dir}/site"/>
+    </copy>
+    <copy todir="${dist.bin.result.dir}/javadocs">
+      <fileset dir="${build.javadocs.dir}"/>
+    </copy>
     <mkdir dir="${dist.bin.result.dir}/build"/>
     <copy todir="${dist.bin.result.dir}/build" file="build/fop.jar"/>
     <chmod file="${dist.bin.result.dir}/fop" perm="ugo+rx"/>
@@ -1083,17 +1096,17 @@ NOTE:
     <delete file="${name}-${version}-bin.tar"/>
   </target>
 
-  <target name="dist-src" depends="all, javadocs, docs">
+  <target name="dist-src" depends="all">
     <echo message="Building the source distribution files (zip,tar)"/>
     <mkdir dir="${dist.src.result.dir}"/>
     <copy todir="${dist.src.result.dir}">
       <fileset refid="dist.src"/>
     </copy>
-    <copy todir="${dist.src.result.dir}/javadocs">
+    <!--copy todir="${dist.src.result.dir}/javadocs">
       <fileset dir="${build.javadocs.dir}"/>
-    </copy>
-    <mkdir dir="${dist.src.result.dir}/build"/>
-    <copy todir="${dist.src.result.dir}/build" file="build/fop.jar"/>
+    </copy-->
+    <!--mkdir dir="${dist.src.result.dir}/build"/>
+    <copy todir="${dist.src.result.dir}/build" file="build/fop.jar"/-->
     <chmod file="${dist.src.result.dir}/fop" perm="ugo+rx"/>
 
     <zip zipfile="${name}-${version}-src.zip" basedir="${dist.src.dir}" includes="**"/>
index 5c438748672477d536b926f2d50e5cb99a4ffffe..a3c2346f2f851bf348419b935bf850920a5ae363 100644 (file)
@@ -1,6 +1,6 @@
 <?xml version="1.0" standalone="no"?>
 <!--
-  Copyright 1999-2004 The Apache Software Foundation
+  Copyright 1999-2005 The Apache Software Foundation
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
   limitations under the License.
 -->
 <!-- $Id$ -->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN"
     "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd">
 
 <document>
   </header>
 
     <body>
+<section>
+  <title>FOP 0.90 alpha 1</title>
+  <p>
+    This is the first preview release after the big redesign effort.
+  </p>
+  <p>
+    We would like to encourage you to download the code and to play with it. 
+    We're still in the process of adding new major features and stabilizing 
+    the code. We welcome any feedback you might have and even more, any
+    other form of help to get the project forward.
+  </p>
+  <p>Caveats:</p>
+  <ul>
+    <li>
+      This release is a preview release and not intended for use in a
+      production environment. Use at your own risk!
+    </li>
+    <li>
+      The API is not to be considered stable, yet. Please be prepared 
+      for the API to be changed in a backwards-incompatible way.
+    </li>
+    <li>
+      You may experience different behaviour compared to version 0.20.5.
+      Please consult the <link href="0.90/upgrading.html">"Upgrading"</link> page indicated above for details.
+    </li>
+  </ul>
+  <p>Known Issues:</p>
+  <ul>
+    <li>
+      PCL, MIF and SVG support have not been restored, yet.
+    </li>
+    <li>
+      Java2D/AWT support contains some problems, for example with 
+      block-containers.
+    </li>
+    <li>
+      Support for kerning has not been restored, yet.
+    </li>
+    <li>
+      Auto table layout is not implemented, yet.
+    </li>
+    <li>
+      The collapsing border model on tables is not implemented, yet. Please 
+      use border-collapse="separate" for now.
+    </li>
+    <li>
+      Footnotes may overlap with text of the region-body in multi-column 
+      documents.
+    </li>
+    <li>
+      Space resolution does not work between footnote regions.
+    </li>
+    <li>
+      There's a problem involving nested block-containers and 
+      reference-orientation 180/-180 (<link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36391">Bugzilla #36391</link>)
+    </li>
+    <li>
+      block-containers with no height currently don't create a fence for
+      spaces as they should (they behave like a normal block).
+    </li>
+    <li>
+      Preserved linefeeds in fo:character are not handled correctly.
+    </li>
+    <li>
+      Zero-width spaces are not handled correctly.
+    </li>
+    <li>
+      An empty block currently produces a fence for stacking constraints
+      which it shouldn't.
+    </li>
+    <li>
+      There are several small problems around white space handling.
+    </li>
+    <li>
+      Images currently don't shrink so they fit on a page when they are 
+      too big and shrinking is allowed to happen.
+    </li>
+    <li>
+      Block-level content in fo:inlines may produce unwelcome results.
+    </li>
+    <li>
+      inline-container may not work as expected.
+    </li>
+    <li>
+      letter-spacing and word-spacing properties may not work as expected.
+    </li>
+    <li>
+      leaders with leader-pattern="use-content" may not work as expected.
+    </li>
+    <li>
+      keep-with-previous doesn't work inside tables and lists, yet.
+    </li>
+    <li>
+      White space on direct inline-level children of a marker is not 
+      handled correctly.
+    </li>
+    <li>
+      If two consecutive pages don't have the same available width, the 
+      content currently isn't properly fit into the available space on
+      the new page.
+    </li>
+    <li>
+      background-images on page-number-citations are not placed correctly.
+    </li>
+    <li>
+      Not all FO elements can be referenced by their "id", most notably:
+      table-body, table-header, table-footer and table-row.
+    </li>
+    <li>
+      The backgrounds of table-body, table-header, table-footer and 
+      table-column are not painted, yet.
+    </li>
+    <li>
+      Border and padding conditionality are not supported on table-cells, yet.
+    </li>
+    <li>
+      Copy/Paste from PDF content in Acrobat Reader is not supported for
+      text using embedded TrueType fonts.
+    </li>
+    <li>
+      Column balancing in multi-column documents may not work as expected
+      (<link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36356">Bugzilla #36356</link>)
+    </li>
+    <li>
+      Omitting fo:table-column or having fo:table-column without a column-width 
+      and attempting to create columns implicitly from the first
+      table row is not implemented, yet (<link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=35656">Bugzilla #35656</link>).
+    </li>
+  </ul>
+</section>
 <section>
   <title>FOP 0.20.5</title>
   <p>This is the last planned release in the 0.20.x series (aka maintenance branch).</p>