]> source.dussan.org Git - poi.git/commitdiff
Javadoc fixes
authorAndreas Beeker <kiwiwings@apache.org>
Sun, 26 Jul 2015 00:25:27 +0000 (00:25 +0000)
committerAndreas Beeker <kiwiwings@apache.org>
Sun, 26 Jul 2015 00:25:27 +0000 (00:25 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1692674 13f79535-47bb-0310-9956-ffa450edef68

13 files changed:
src/java/org/apache/poi/sl/draw/DrawPaint.java
src/java/org/apache/poi/sl/usermodel/GroupShape.java
src/java/org/apache/poi/sl/usermodel/ShapeContainer.java
src/java/org/apache/poi/sl/usermodel/TextParagraph.java
src/ooxml/java/org/apache/poi/xslf/usermodel/XSLFShape.java
src/ooxml/java/org/apache/poi/xslf/usermodel/XSLFTextParagraph.java
src/scratchpad/src/org/apache/poi/hslf/model/textproperties/TabStopPropCollection.java
src/scratchpad/src/org/apache/poi/hslf/record/TextHeaderAtom.java
src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFGroupShape.java
src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFPictureShape.java
src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFSlideShowImpl.java
src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFTableCell.java
src/scratchpad/src/org/apache/poi/hslf/usermodel/HSLFTextRun.java

index 16562b82a06b0e38f3adddb14fed59762390f955..26a94ed34722646a687517c72fc5da404206210e 100644 (file)
@@ -37,7 +37,7 @@ import org.apache.poi.util.POILogger;
 /**\r
  * This class handles color transformations\r
  * \r
- * @see HSL code taken from <a href="https://tips4java.wordpress.com/2009/07/05/hsl-color/">Java Tips Weblog</a>\r
+ * @see <a href="https://tips4java.wordpress.com/2009/07/05/hsl-color/">HSL code taken from Java Tips Weblog</a>\r
  */\r
 public class DrawPaint {\r
     // HSL code is public domain - see https://tips4java.wordpress.com/contact-us/\r
@@ -147,8 +147,7 @@ public class DrawPaint {
      * Apply lumMod / lumOff adjustments\r
      *\r
      * @param c the color to modify\r
-     * @param lumMod luminance modulation in the range [0..100000]\r
-     * @param lumOff luminance offset in the range [0..100000]\r
+     * @param fc the color style containing the lumMod / lumOff adjustments\r
      * @return  modified color\r
      * \r
      * @see <a href="https://msdn.microsoft.com/en-us/library/dd560821%28v=office.12%29.aspx">Using Office Open XML to Customize Document Formatting in the 2007 Office System</a>\r
index d71bb253fe22f75906d7a61a0c812aaba4fb61b9..8133ac048e4ac288676027e6aeeb5c5798b0e476 100644 (file)
@@ -25,7 +25,7 @@ public interface GroupShape<T extends Shape> extends Shape, ShapeContainer<T>, P
      * Gets the coordinate space of this group.  All children are constrained
      * to these coordinates.
      *
-     * @param anchor the coordinate space of this group
+     * @return the coordinate space of this group
      */
     Rectangle2D getInteriorAnchor();
     
index 1741a732d30b7334342e3e34cffe9e501ee764e3..0172fa7701590f9494dd2ade8e03b7a0f8f05901 100644 (file)
@@ -37,7 +37,7 @@ public interface ShapeContainer<T extends Shape> extends Iterable<T> {
      * (optional operation).  If this sheet does not contain the element,
      * it is unchanged.
      *
-     * @param xShape shape to be removed from this sheet, if present
+     * @param shape the shape to be removed from this sheet, if present
      * @return <tt>true</tt> if this sheet contained the specified element
      * @throws IllegalArgumentException if the type of the specified shape
      *         is incompatible with this sheet (optional)
index a914dd7cb3fed1be858ff0bc43d0e164275df932..0b2eb062c20d53c81b21c00c88f4b45ec6e19474 100644 (file)
@@ -279,7 +279,7 @@ public interface TextParagraph<T extends TextRun> extends Iterable<T> {
      *      paragraph.setLineSpacing(-48.0);\r
      * </code></pre>\r
      * \r
-     * @param linespacing the vertical line spacing\r
+     * @param lineSpacing the vertical line spacing\r
      */\r
     void setLineSpacing(Double lineSpacing);\r
 \r
index 2e169638fd7c105c39fc5ebc193b71cabd0e2b54..3ea1d3a7ca1865b065b8be8c335a862d25424f00 100644 (file)
@@ -271,9 +271,9 @@ public abstract class XSLFShape implements Shape {
      * properties. This method is the generalized form of selecting and casting those\r
      * properties.\r
      *\r
-     * @param resultClass\r
-     * @param xquery\r
-     * @return\r
+     * @param resultClass the requested result class\r
+     * @param xquery the simple (xmlbean) xpath expression to the property\r
+     * @return the xml object at the xpath location, or null if not found\r
      */\r
     @SuppressWarnings("unchecked")\r
     protected <T extends XmlObject> T selectProperty(Class<T> resultClass, String xquery) {\r
@@ -354,7 +354,6 @@ public abstract class XSLFShape implements Shape {
      * Convert shape fill into java.awt.Paint. The result is either Color or\r
      * TexturePaint or GradientPaint or null\r
      *\r
-     * @param graphics  the target graphics\r
      * @param obj       the xml to read. Must contain elements from the EG_ColorChoice group:\r
      * <code>\r
      *     a:scrgbClr    RGB Color Model - Percentage Variant\r
index 45000a1c3e48b1b2ded951bc2d572bbb2f3e6e8a..f9bad78be24a8002a509d9ec4ef31a3dafce3374 100644 (file)
@@ -144,7 +144,7 @@ public class XSLFTextParagraph implements TextParagraph<XSLFTextRun> {
      * Returns the alignment that is applied to the paragraph.\r
      *\r
      * If this attribute is omitted, then null is returned.\r
-     * User code can imply the value {@link TextAlign#LEFT} then.\r
+     * User code can imply the value {@link org.apache.poi.sl.usermodel.TextParagraph.TextAlign#LEFT} then.\r
      *\r
      * @return alignment that is applied to the paragraph\r
      */\r
@@ -166,7 +166,7 @@ public class XSLFTextParagraph implements TextParagraph<XSLFTextRun> {
     /**\r
      * Specifies the alignment that is to be applied to the paragraph.\r
      * Possible values for this include left, right, centered, justified and distributed,\r
-     * see {@link org.apache.poi.sl.usermodel.TextAlign}.\r
+     * see {@link org.apache.poi.sl.usermodel.TextParagraph.TextAlign}.\r
      *\r
      * @param align text align\r
      */\r
index 786b3733822ce1280bc0b97edced70a612af1957..366886217006f1073822daef776e2adb9d434202 100644 (file)
@@ -90,7 +90,6 @@ public class TabStopPropCollection extends TextProp {
      *\r
      * @param data the data stream\r
      * @param offset the offset within the data\r
-     * @return the new offset\r
      */\r
     public void parseProperty(byte data[], int offset) {\r
         int count = LittleEndian.getUShort(data, offset);\r
index a63d8934d58823755a8af10d96d1f37c17876ee7..3fab236a1c218a90db0f208ea419ba86fffce9c8 100644 (file)
@@ -58,7 +58,7 @@ public final class TextHeaderAtom extends RecordAtom implements ParentAwareRecor
        public int getIndex() { return index; }
 
     /**
-     *  @param id 0-based index of the text run in the SLWT container
+     *  @param index 0-based index of the text run in the SLWT container
      */
        public void setIndex(int index) { this.index = index; }
 
index ae343f22c141bbea8d6d573bdcdd1f01a73cd27a..12c0167ad910571dda57ea7bad6679686c76e79a 100644 (file)
@@ -212,7 +212,7 @@ public class HSLFGroupShape extends HSLFShape implements GroupShape<HSLFShape> {
 
     /**
      * Return type of the shape.
-     * In most cases shape group type is {@link org.apache.poi.hslf.model.ShapeTypes#NotPrimitive}
+     * In most cases shape group type is {@link org.apache.poi.sl.usermodel.ShapeType#NOT_PRIMITIVE}
      *
      * @return type of the shape.
      */
index 5db610af0079d9e988341d3a30b0062ab23f9b8e..a6857937c0b74b1a2ef20ed61f00adf3e81c6dcf 100644 (file)
@@ -253,12 +253,11 @@ public class HSLFPictureShape extends HSLFSimpleShape implements PictureShape {
         }
     }
 
-    /**
-     * The anchor specified by {@link #getLogicalAnchor2D()} is the displayed size,
-     * i.e. the size of the already clipped image
-     */
+
     @Override
     public Insets getClipping() {
+        // The anchor specified by the escher properties is the displayed size,
+        // i.e. the size of the already clipped image
         EscherOptRecord opt = getEscherOptRecord();
         
         double top    = getFractProp(opt, EscherProperties.BLIP__CROPFROMTOP);
index 34638f63092fdd0a050f7ec85c1da3bbeb4f83f0..c02fe22c95c30b1c9bb0d07b2679fa625d6da433 100644 (file)
@@ -144,7 +144,7 @@ public final class HSLFSlideShowImpl extends POIDocument {
     *  POIFS Filesystem. Parses the document and places all the
     *  important stuff into data structures.
     *
-    * @deprecated Use {@link #HSLFSlideShow(DirectoryNode)} instead
+    * @deprecated Use {@link #HSLFSlideShowImpl(DirectoryNode)} instead
     * @param dir the POIFS directory to read from
     * @param filesystem the POIFS FileSystem to read from
     * @throws IOException if there is a problem while parsing the document.
index b1e7c3e4bbe6e45665b1e9e813ae94bbf65773c6..74abd190386fe6cb4ec9eaa42cd15a128d534b53 100644 (file)
@@ -43,7 +43,7 @@ public final class HSLFTableCell extends HSLFTextBox {
     /**
      * Create a TableCell object and initialize it from the supplied Record container.
      *
-     * @param escherRecord       {@link EscherSpContainer} container which holds information about this shape
+     * @param escherRecord       EscherSpContainer which holds information about this shape
      * @param parent    the parent of the shape
      */
    protected HSLFTableCell(EscherContainerRecord escherRecord, ShapeContainer<HSLFShape> parent){
index 8728eabb6b4b786489fe161a5b628e69ecf14743..08565e3da65ec27c70685a75b416b78109edea16 100644 (file)
@@ -48,7 +48,7 @@ public final class HSLFTextRun implements TextRun {
 
        /**
         * Create a new wrapper around a rich text string
-        * @param parent The parent paragraph
+        * @param parentParagraph the parent paragraph
         */
        public HSLFTextRun(HSLFTextParagraph parentParagraph) {
                this.parentParagraph = parentParagraph;