From: Jeremias Maerki <jeremias@apache.org>
Date: Fri, 18 Nov 2005 21:17:11 +0000 (+0000)
Subject: "build/site" is now copied to "docs".
X-Git-Tag: fop-0_90-alpha1~5
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=a06c6139c114d97ebb770073983c5cefee31b557;p=xmlgraphics-fop.git

"build/site" is now copied to "docs".
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
---

diff --git a/build.xml b/build.xml
index 24dd315c8..1c57d10a6 100644
--- 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="**"/>
diff --git a/src/documentation/content/xdocs/relnotes.xml b/src/documentation/content/xdocs/relnotes.xml
index 5c4387486..a3c2346f2 100644
--- a/src/documentation/content/xdocs/relnotes.xml
+++ b/src/documentation/content/xdocs/relnotes.xml
@@ -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>
@@ -25,6 +25,136 @@
   </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>