@@ -, +, @@ 
    Fix Bug 54731 by adjusting javadoc to work around javadoc strangeness related to tables
--- a/src/java/org/apache/poi/hssf/record/aggregates/ColumnInfoRecordsAggregate.java	
+++ a/src/java/org/apache/poi/hssf/record/aggregates/ColumnInfoRecordsAggregate.java	
@@ -171,7 +171,7 @@ public final class ColumnInfoRecordsAggregate extends RecordAggregate {
 	/**
 	 * 'Collapsed' state is stored in a single column col info record immediately after the outline group
 	 * @param idx
-	 * @return
+	 * @return true, if the column is collapsed, false otherwise.
 	 */
 	private boolean isColumnGroupCollapsed(int idx) {
 		int endOfOutlineGroupIdx = findEndOfColumnOutlineGroup(idx);
--- a/src/java/org/apache/poi/ss/formula/functions/Finance.java	
+++ a/src/java/org/apache/poi/ss/formula/functions/Finance.java	
@@ -107,7 +107,7 @@ public class Finance {
      * @return <code>double</code> representing principal portion of payment.
      * 
      * @see #pmt(double, int, double, double, int)
-     * @see #ipmt(double, int, int, double, double, boolean)
+     * @see #ipmt(double, int, int, double, double, int)
      */
 	static public double ppmt(double r, int per, int nper, double pv, double fv, int type) {
 	    return pmt(r, nper, pv, fv, type) - ipmt(r, per, nper, pv, fv, type);
--- a/src/java/org/apache/poi/ss/util/AreaReference.java	
+++ a/src/java/org/apache/poi/ss/util/AreaReference.java	
@@ -261,6 +261,8 @@ public class AreaReference {
     }
 
     /**
+	 * Returns a text representation of this area reference.
+	 * <p/>
      *  Example return values:
      *    <table border="0" cellpadding="1" cellspacing="0" summary="Example return values">
      *      <tr><th align='left'>Result</th><th align='left'>Comment</th></tr>
--- a/src/java/org/apache/poi/ss/util/CellReference.java	
+++ a/src/java/org/apache/poi/ss/util/CellReference.java	
@@ -437,6 +437,8 @@ public class CellReference {
 	}
 
 	/**
+	 * Returns a text representation of this cell reference.
+	 * <p/>
 	 *  Example return values:
 	 *	<table border="0" cellpadding="1" cellspacing="0" summary="Example return values">
 	 *	  <tr><th align='left'>Result</th><th align='left'>Comment</th></tr>
--- a/src/ooxml/java/org/apache/poi/openxml4j/opc/OPCPackage.java	
+++ a/src/ooxml/java/org/apache/poi/openxml4j/opc/OPCPackage.java	
@@ -755,7 +755,7 @@ public abstract class OPCPackage implements RelationshipSource, Closeable {
 	 *             If rule M1.12 is not verified : Packages shall not contain
 	 *             equivalent part names and package implementers shall neither
 	 *             create nor recognize packages with equivalent part names.
-	 * @see {@link#createPartImpl(URI, String)}
+	 * @see #createPartImpl(PackagePartName, String, boolean)
 	 */
 	PackagePart createPart(PackagePartName partName, String contentType,
 			boolean loadRelationships) {