revert of r1639217 and offline-linking for maven javadocs

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

diff --git a/build.xml b/build.xml
index 6b83e31045b8db426f0105269ab0ed9e8106cda2..8a7659608aedd381f478fb0c4e2f7d0ab7ed8e69 100644 (file)
--- a/build.xml
+++ b/build.xml
@@ -1264,7 +1264,7 @@ under the License.
         <echo>Use mvn-deploy.sh to deploy the artifacts in the remote repository</echo>
     </target>
 
-    <target name="jar" depends="compile-all, compile-version" description="Creates jar files for distribution">
+    <target name="-manifest">
         <manifest file="build/poi-manifest.mf">
             <attribute name="Built-By" value="${user.name}"/>
             <attribute name="Specification-Title" value="Apache POI"/>
@@ -1275,6 +1275,9 @@ under the License.
             <attribute name="Implementation-Vendor-Id" value="org.apache.poi"/>
             <attribute name="Implementation-Vendor" value="The Apache Software Foundation"/>
         </manifest>
+    </target>
+
+    <target name="jar" depends="compile-all, compile-version, -manifest" description="Creates jar files for distribution">
         <jar destfile="${dist.dir}/${jar.name}-${version.id}-${DSTAMP}.jar"
              manifest="build/poi-manifest.mf">
             <fileset dir="${main.output.dir}"/>
@@ -1335,7 +1338,21 @@ under the License.
         </jar>
     </target>
 
-    <target name="jar-javadocs" description="JavaDocs for Maven">
+
+    <target name="-do-jar-check-javadocs-package-list">
+        <condition property="javadocs.package-list.present">
+               <available file="build/tmp/site/build/site/apidocs/package-list"/>
+        </condition>
+    </target>
+
+    <target name="-do-jar-create-javadocs-package-list"
+       depends="-do-jar-check-javadocs-package-list"
+       unless="javadocs.package-list.present">
+       <antcall target="javadocs"/>
+    </target>
+       
+       
+       <target name="jar-javadocs" description="JavaDocs for Maven" depends="compile,-manifest,-do-jar-create-javadocs-package-list">
         <property name="build.maven.javadocs" location="build/tmp/maven-javadocs"/>
 
         <!-- Build and package the main javadocs -->
@@ -1354,7 +1371,8 @@ under the License.
            <param name="jarname" value="${jar.name}-ooxml" />
         </antcall>
     </target>
-    <target name="-do-jar-javadocs">
+
+       <target name="-do-jar-javadocs">
         <echo message="Building ${jarname} javadocs from ${srcfolder}" />
         <delete dir="${build.maven.javadocs}"/>
         <mkdir dir="${build.maven.javadocs}"/>
@@ -1365,6 +1383,7 @@ under the License.
             <packageset dir="${srcfolder}" defaultexcludes="yes">
                 <include name="org/apache/poi/**"/>
             </packageset>
+            <link href="https://poi.apache.org/apidocs" packagelistLoc="build/tmp/site/build/site/apidocs"/>
         </javadoc>
         <jar destfile="${dist.dir}/${jarname}-${version.id}-javadocs-${DSTAMP}.jar"
              manifest="build/poi-manifest.mf">

diff --git a/src/java/org/apache/poi/POIOLE2TextExtractor.java b/src/java/org/apache/poi/POIOLE2TextExtractor.java
index a42ced76f3c64a4b22d57e8a02f4593c7277ed91..c0f4cbd1d741b9b755893c812dc90986f502a117 100644 (file)
--- a/src/java/org/apache/poi/POIOLE2TextExtractor.java
+++ b/src/java/org/apache/poi/POIOLE2TextExtractor.java
@@ -28,10 +28,10 @@ import org.apache.poi.poifs.filesystem.POIFSFileSystem;
  * You will typically find the implementation of
  *  a given format's text extractor under
  *  org.apache.poi.[format].extractor .
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hssf/extractor/ExcelExtractor.html">org.apache.poi.hssf.extractor.ExcelExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hslf/extractor/PowerPointExtractor.html">org.apache.poi.hslf.extractor.PowerPointExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hdgf/extractor/VisioTextExtractor.html">org.apache.poi.hdgf.extractor.VisioTextExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hwpf/extractor/WordExtractor.html">org.apache.poi.hwpf.extractor.WordExtractor</a>
+ * @see org.apache.poi.hssf.extractor.ExcelExtractor
+ * @see org.apache.poi.hslf.extractor.PowerPointExtractor
+ * @see org.apache.poi.hdgf.extractor.VisioTextExtractor
+ * @see org.apache.poi.hwpf.extractor.WordExtractor
  */
 public abstract class POIOLE2TextExtractor extends POITextExtractor {
        /**

diff --git a/src/java/org/apache/poi/POITextExtractor.java b/src/java/org/apache/poi/POITextExtractor.java
index 7ea997c764b668bd4af8d3c68107620ce1ae38d1..e18078b461f4cec23dad0d137a13d661983d546c 100644 (file)
--- a/src/java/org/apache/poi/POITextExtractor.java
+++ b/src/java/org/apache/poi/POITextExtractor.java
@@ -25,10 +25,10 @@ import java.io.IOException;
  * You will typically find the implementation of
  *  a given format's text extractor under
  *  org.apache.poi.[format].extractor .
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hssf/extractor/ExcelExtractor.html">org.apache.poi.hssf.extractor.ExcelExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hslf/extractor/PowerPointExtractor.html">org.apache.poi.hslf.extractor.PowerPointExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hdgf/extractor/VisioTextExtractor.html">org.apache.poi.hdgf.extractor.VisioTextExtractor</a>
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/hwpf/extractor/WordExtractor.html">org.apache.poi.hwpf.extractor.WordExtractor</a>
+ * @see org.apache.poi.hssf.extractor.ExcelExtractor
+ * @see org.apache.poi.hslf.extractor.PowerPointExtractor
+ * @see org.apache.poi.hdgf.extractor.VisioTextExtractor
+ * @see org.apache.poi.hwpf.extractor.WordExtractor
  */
 public abstract class POITextExtractor implements Closeable {
        /** The POIDocument that's open */

diff --git a/src/java/org/apache/poi/poifs/crypt/package.html b/src/java/org/apache/poi/poifs/crypt/package.html
index 0cc2d4b67a807b5f1ce43dce8565558e9a1ed267..977cf8b5a972005fa1ebd9a6973e1d5295f1b767 100644 (file)
--- a/src/java/org/apache/poi/poifs/crypt/package.html
+++ b/src/java/org/apache/poi/poifs/crypt/package.html
@@ -27,7 +27,7 @@
 <ul>
 <li>This package contains common functions for both current implemented cipher modes.</li>
 <li>the {@link org.apache.poi.poifs.crypt.standard standard} package is part of the base poi jar and contains classes for the standard encryption ...</li>
-<li>the <a href="https://poi.apache.org/apidocs/org/apache/poi/poifs/crypt/agile/package-summary.html">agile</a> package is part of the poi ooxml jar and the provides agile encryption support.</li>
+<li>the {@link org.apache.poi.poifs.crypt.agile agile} package is part of the poi ooxml jar and the provides agile encryption support.</li>
 </ul>
 
 <h2>Related Documentation</h2>
@@ -39,6 +39,6 @@ Some implementations informations can be found under:
 
 <!-- Put @see and @since tags down here. -->
 @see org.apache.poi.poifs.crypt.standard
-@see <a href="https://poi.apache.org/apidocs/org/apache/poi/poifs/crypt/agile/package-summary.html">org.apache.poi.poifs.crypt.agile</a>
+@see org.apache.poi.poifs.crypt.agile
 </body>
 </html>

diff --git a/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java b/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java
index 8d0811d249df5b64535ce2b77c20e0df68fad1b8..21fa5763840fb8870455f66adbe250bad4dcf8d2 100644 (file)
--- a/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java
+++ b/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java
@@ -36,7 +36,7 @@ import org.apache.poi.ss.usermodel.Workbook;
 /**
  * An alternative workbook evaluator that saves memory in situations where a single workbook is
  * concurrently and independently evaluated many times.  With standard formula evaluation, around
- * 90% of memory consumption is due to loading of the {@link HSSFWorkbook} or <a href="https://poi.apache.org/apidocs/org/apache/poi/xssf/usermodel/XSSFWorkbook.html">XSSFWorkbook</a>.
+ * 90% of memory consumption is due to loading of the {@link HSSFWorkbook} or {@link org.apache.poi.xssf.usermodel.XSSFWorkbook}.
  * This class enables a 'master workbook' to be loaded just once and shared between many evaluation
  * clients.  Each evaluation client creates its own {@link ForkedEvaluator} and can set cell values
  * that will be used for local evaluations (and don't disturb evaluations on other evaluators).

diff --git a/src/java/org/apache/poi/util/XMLHelper.java b/src/java/org/apache/poi/util/XMLHelper.java
index ac617adda89ec8d160a8bdda8dc18d6bc2ed5f42..22d27208be067341c458452c4965039045caa996 100644 (file)
--- a/src/java/org/apache/poi/util/XMLHelper.java
+++ b/src/java/org/apache/poi/util/XMLHelper.java
@@ -22,7 +22,7 @@ import javax.xml.parsers.DocumentBuilderFactory;
 
 /**
  * Helper methods for working with javax.xml classes.
- * @see <a href="https://poi.apache.org/apidocs/org/apache/poi/util/SAXHelper.html">org.apache.poi.util.SAXHelper</a>
+ * @see org.apache.poi.util.SAXHelper
  */
 public final class XMLHelper
 {