diff options
| author | Andreas Beeker <kiwiwings@apache.org> | 2021-04-14 22:53:33 +0000 |
|---|---|---|
| committer | Andreas Beeker <kiwiwings@apache.org> | 2021-04-14 22:53:33 +0000 |
| commit | bb5d321b79193b98051f435621f5044842716c4e (patch) | |
| tree | bec508518798239131c7cdf3825d4328a7d0e831 /poi-scratchpad | |
| parent | 7c67bba960e46433d8bf11674ef862153403cfdc (diff) | |
| download | poi-bb5d321b79193b98051f435621f5044842716c4e.tar.gz poi-bb5d321b79193b98051f435621f5044842716c4e.zip | |
fix javadocs - remove @author tags (http://apache-poi.1045710.n5.nabble.com/Javadocs-clean-up-remove-author-tags-tp5737663.html)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1888780 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'poi-scratchpad')
172 files changed, 191 insertions, 750 deletions
diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hdgf/exceptions/HDGFException.java b/poi-scratchpad/src/main/java/org/apache/poi/hdgf/exceptions/HDGFException.java index c893bd2dfb..c7147328fa 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hdgf/exceptions/HDGFException.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hdgf/exceptions/HDGFException.java @@ -19,8 +19,6 @@ package org.apache.poi.hdgf.exceptions; /** * The superclass of all HDGF exceptions - * - * @author Yegor Kozlov */ public final class HDGFException extends RuntimeException { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/dev/SlideShowRecordDumper.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/dev/SlideShowRecordDumper.java index cff59a70c5..88b6407cab 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/dev/SlideShowRecordDumper.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/dev/SlideShowRecordDumper.java @@ -40,12 +40,10 @@ import org.apache.poi.util.HexDump; * This class provides a way to view the contents of a powerpoint file. * It will use the recored layer to grok the contents of the file, and * will print out what it finds. - * - * @author Nick Burch */ public final class SlideShowRecordDumper { static final String tabs = "\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t"; - + private boolean optVerbose; private boolean optEscher; private HSLFSlideShowImpl doc; @@ -203,16 +201,16 @@ public final class SlideShowRecordDumper { ps.println(ind+ child); prevChild = child; } - + } - + private void printEscherContainerRecord( EscherContainerRecord ecr, int indent ) { String ind = tabs.substring(0, indent); ps.println(ind + ecr.getClass().getName() + " (" + ecr.getRecordName() + "):"); ps.println(ind + " isContainer: " + ecr.isContainerRecord()); ps.println(ind + " options: 0x" + HexDump.toHex( ecr.getOptions() )); ps.println(ind + " recordId: 0x" + HexDump.toHex( ecr.getRecordId() )); - + ps.println(ind + " numchildren: " + ecr.getChildCount()); ps.println(ind + " children: "); int count = 0; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/CorruptPowerPointFileException.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/CorruptPowerPointFileException.java index 3c61039483..e585f64f0a 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/CorruptPowerPointFileException.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/CorruptPowerPointFileException.java @@ -20,16 +20,13 @@ package org.apache.poi.hslf.exceptions; /** * This exception is thrown when we try to open a PowerPoint file, and * something is fundamentally broken about it. - * - * @author Nick Burch */ - public final class CorruptPowerPointFileException extends IllegalStateException { public CorruptPowerPointFileException(String s) { super(s); } - + public CorruptPowerPointFileException(String s, Throwable t) { super(s,t); } diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/HSLFException.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/HSLFException.java index f534d9ce0d..061d5a8457 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/HSLFException.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/exceptions/HSLFException.java @@ -19,8 +19,6 @@ package org.apache.poi.hslf.exceptions; /** * A generic exception that can be thrown by HSLF classes - * - * @author Yegor Kozlov */ public final class HSLFException extends RuntimeException { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/MovieShape.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/MovieShape.java index ee00ae73ab..c5e001ff7e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/MovieShape.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/MovieShape.java @@ -39,8 +39,6 @@ import org.apache.poi.sl.usermodel.ShapeContainer; /** * Represents a movie in a PowerPoint document. - * - * @author Yegor Kozlov */ public final class MovieShape extends HSLFPictureShape { public static final int DEFAULT_MOVIE_THUMBNAIL = -1; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/Polygon.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/Polygon.java index 061e89555c..3c4e8b04cf 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/Polygon.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/Polygon.java @@ -35,8 +35,6 @@ import org.apache.poi.util.Units; /** * A simple closed polygon shape - * - * @author Yegor Kozlov */ public final class Polygon extends HSLFAutoShape { /** diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/ParagraphFlagsTextProp.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/ParagraphFlagsTextProp.java index 0ffc38e5b3..4a8b9f01d6 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/ParagraphFlagsTextProp.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/ParagraphFlagsTextProp.java @@ -19,8 +19,6 @@ package org.apache.poi.hslf.model.textproperties; /** * Definition for the common paragraph text property bitset. - * - * @author Yegor Kozlov */ public final class ParagraphFlagsTextProp extends BitMaskTextProp { public static final int BULLET_IDX = 0; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/TextPFException9.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/TextPFException9.java index 927cbe553d..8197b30890 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/TextPFException9.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/model/textproperties/TextPFException9.java @@ -35,9 +35,6 @@ import org.apache.poi.util.LittleEndian; * this means the default values will be used: statNumber=1 and sheme=ANM_ArabicPeriod * @see <a href="http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28"> * http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28</a> - * - * @author Alex Nikiforov [mailto:anikif@gmail.com] - * */ public class TextPFException9 implements GenericRecord { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfo.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfo.java index 9bf2bf789f..09f237280d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfo.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfo.java @@ -27,8 +27,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * A container record that specifies information about animation information for a shape. - * - * @author Yegor Kozlov */ public final class AnimationInfo extends RecordContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfoAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfoAtom.java index f9ec145eac..95e076e83b 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfoAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/AnimationInfoAtom.java @@ -31,8 +31,6 @@ import org.apache.poi.util.LittleEndian; /** * An atom record that specifies the animation information for a shape. - * - * @author Yegor Kozlov */ public final class AnimationInfoAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/BinaryTagDataBlob.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/BinaryTagDataBlob.java index 79d8d9da7d..2910c18fb2 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/BinaryTagDataBlob.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/BinaryTagDataBlob.java @@ -31,8 +31,6 @@ import org.apache.poi.util.LittleEndian; * disk this is, but not much else. * Anything done using this should quite quickly be transitioned to its * own proper record class! - * - * @author Nick Burch */ public final class BinaryTagDataBlob extends PositionDependentRecordContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/CString.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/CString.java index 329915f93e..f2991f02c1 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/CString.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/CString.java @@ -32,8 +32,6 @@ import org.apache.poi.util.StringUtil; * A CString (type 4026). Holds a unicode string, and the first two bytes * of the record header normally encode the count. Typically attached to * some complex sequence of records, eg Commetns. - * - * @author Nick Burch */ public final class CString extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ColorSchemeAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ColorSchemeAtom.java index 8625245844..bd2ac34d98 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ColorSchemeAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ColorSchemeAtom.java @@ -34,8 +34,6 @@ import org.apache.poi.util.LittleEndian; * colours of bits of text, that makes up a given colour scheme. * Slides (presumably) link to a given colour scheme atom, and that * defines the colours to be used - * - * @author Nick Burch */ public final class ColorSchemeAtom extends RecordAtom { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000.java index 69c8d2181f..f0f33ab863 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000.java @@ -28,7 +28,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * This class represents a comment on a slide, in the format used by * PPT 2000/XP/etc. (PPT 97 uses plain Escher Text Boxes for comments) - * @author Nick Burch */ public final class Comment2000 extends RecordContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000Atom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000Atom.java index 00c3cdef01..765b7d41b1 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000Atom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Comment2000Atom.java @@ -31,8 +31,6 @@ import org.apache.poi.util.LittleEndian; /** * An atomic record containing information about a comment. - * - * @author Daniel Noll */ public final class Comment2000Atom extends RecordAtom diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Document.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Document.java index 73489a9d2f..de69dd05a5 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Document.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Document.java @@ -27,8 +27,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * Master container for Document. There is one of these for every * slideshow, and it holds lots of definitions, and some summaries. - * - * @author Nick Burch */ public final class Document extends PositionDependentRecordContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DocumentEncryptionAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DocumentEncryptionAtom.java index bb498f2088..c0b1d09c6d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DocumentEncryptionAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DocumentEncryptionAtom.java @@ -39,8 +39,6 @@ import org.apache.poi.util.LittleEndianInputStream; /** * A Document Encryption Atom (type 12052). Holds information * on the Encryption of a Document - * - * @author Nick Burch */ public final class DocumentEncryptionAtom extends PositionDependentRecordAtom { private static final long _type = RecordTypes.DocumentEncryptionAtom.typeID; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyPositionSensitiveRecordWithChildren.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyPositionSensitiveRecordWithChildren.java index db7a0cb943..526bc363d8 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyPositionSensitiveRecordWithChildren.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyPositionSensitiveRecordWithChildren.java @@ -31,8 +31,6 @@ import org.apache.poi.util.LittleEndian; * disk this is, but not much else. * Anything done using this should quite quickly be transitioned to its * own proper record class! - * - * @author Nick Burch */ public final class DummyPositionSensitiveRecordWithChildren extends PositionDependentRecordContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyRecordWithChildren.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyRecordWithChildren.java index cc99aa2f98..93e5aa3cca 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyRecordWithChildren.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/DummyRecordWithChildren.java @@ -27,8 +27,6 @@ import org.apache.poi.util.LittleEndian; * If we come across a record we know has children of (potential) * interest, but where the record itself is boring, we create one * of these. It allows us to get at the children, but not much else - * - * @author Nick Burch */ public final class DummyRecordWithChildren extends RecordContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Environment.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Environment.java index a8bebeaeaa..25d5820ec4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Environment.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Environment.java @@ -23,8 +23,6 @@ import java.util.Arrays; /** * Environment, which contains lots of settings for the document. - * - * @author Nick Burch */ public final class Environment extends PositionDependentRecordContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/EscherTextboxWrapper.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/EscherTextboxWrapper.java index 7cfe763f98..7a47e9fd4e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/EscherTextboxWrapper.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/EscherTextboxWrapper.java @@ -32,8 +32,6 @@ import org.apache.poi.util.GenericRecordUtil; * Note: when asked to write out, will simply put any child records correctly * into the Escher layer. A call to the escher layer to write out (by the * parent PPDrawing) will do the actual write out - * - * @author Nick Burch */ public final class EscherTextboxWrapper extends RecordContainer { private EscherTextboxRecord _escherRecord; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExAviMovie.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExAviMovie.java index 62a5c4bbe3..7d9086ef65 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExAviMovie.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExAviMovie.java @@ -20,8 +20,6 @@ package org.apache.poi.hslf.record; /** * A container record that specifies information about a movie stored externally. - * - * @author Yegor Kozlov */ public final class ExAviMovie extends ExMCIMovie { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControl.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControl.java index 58be5715ee..9fdebc86b8 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControl.java @@ -28,10 +28,6 @@ package org.apache.poi.hslf.record; * A ProgID is a string that uniquely identifies a given object. * 5. CString (4026), Instance ClipboardName (3) that appears in the paste special dialog. * 6. MetaFile( 4033), optional - * </p> - * - * - * @author Yegor kozlov */ public final class ExControl extends ExEmbed { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControlAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControlAtom.java index 58d27ef340..d0ea0811b4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControlAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExControlAtom.java @@ -28,8 +28,6 @@ import org.apache.poi.util.LittleEndian; /** * An atom record that specifies an ActiveX control. - * - * @author Yegor Kozlov */ public final class ExControlAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExEmbedAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExEmbedAtom.java index f3c3a48f43..1841a6deda 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExEmbedAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExEmbedAtom.java @@ -40,8 +40,6 @@ import org.apache.poi.util.LittleEndian; * 5 bool1 noSizeToServerB Set if don't need to send the dimension to the embedded object * 6 Bool1 isTable Set if the object is a Word table * --> - * - * @author Daniel Noll */ public class ExEmbedAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlink.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlink.java index 945a8df41b..0d20be1424 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlink.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlink.java @@ -26,7 +26,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * This class represents the data of a link in the document. - * @author Nick Burch */ public class ExHyperlink extends RecordContainer { private static final long _type = RecordTypes.ExHyperlink.typeID; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlinkAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlinkAtom.java index ba63ac5da6..104973c8ca 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlinkAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExHyperlinkAtom.java @@ -30,8 +30,6 @@ import org.apache.poi.util.LittleEndian; /** * Tne atom that holds metadata on a specific Link in the document. * (The actual link is held in a sibling CString record) - * - * @author Nick Burch */ public final class ExHyperlinkAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMCIMovie.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMCIMovie.java index 81654dfded..dc784921ad 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMCIMovie.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMCIMovie.java @@ -27,8 +27,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * A container record that specifies information about a movie stored externally. - * - * @author Yegor Kozlov */ public class ExMCIMovie extends RecordContainer { // TODO - instantiable superclass private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMediaAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMediaAtom.java index 486b976f66..c65d1a5603 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMediaAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExMediaAtom.java @@ -32,8 +32,6 @@ import org.apache.poi.util.LittleEndian; /** * An atom record that specifies information about external audio or video data. - * - * @author Yegor Kozlov */ public final class ExMediaAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjList.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjList.java index bee803a21b..86437d8df0 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjList.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjList.java @@ -24,9 +24,7 @@ import java.util.Arrays; import org.apache.poi.util.LittleEndian; /** - * This class holds the links to exernal objects referenced - * from the document. - * @author Nick Burch + * This class holds the links to exernal objects referenced from the document. */ public class ExObjList extends RecordContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjListAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjListAtom.java index 5fab662c42..3b5b7125d2 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjListAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExObjListAtom.java @@ -30,8 +30,6 @@ import org.apache.poi.util.LittleEndian; /** * Tne atom that holds the seed info used by a ExObjList - * - * @author Nick Burch */ public class ExObjListAtom extends RecordAtom diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExVideoContainer.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExVideoContainer.java index c6935e84dd..9c3398a359 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExVideoContainer.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ExVideoContainer.java @@ -27,8 +27,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * A container record that specifies information about external video data. - * - * @author Yegor Kozlov */ public final class ExVideoContainer extends RecordContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/FontEntityAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/FontEntityAtom.java index 0d576f6a6a..4ba09c1892 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/FontEntityAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/FontEntityAtom.java @@ -38,8 +38,6 @@ import org.apache.poi.util.StringUtil; * It keeps all the information needed to define the attributes of a font, * such as height, width, etc. For more information, consult the * Windows API Programmer's reference. - * - * @author Yegor Kozlov */ public final class FontEntityAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersAtom.java index 42f8d017ca..9d51daa0fc 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersAtom.java @@ -33,8 +33,6 @@ import org.apache.poi.util.LittleEndian; /** * An atom record that specifies options for displaying headers and footers * on a presentation slide or notes slide. - * - * @author Yegor Kozlov */ public final class HeadersFootersAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersContainer.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersContainer.java index 2c1bd86229..6c1d9c3b56 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersContainer.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/HeadersFootersContainer.java @@ -28,15 +28,14 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * A container record that specifies information about the footers on a presentation slide. * <p> - * It contains:<br> + * It contains: + * <ul> * <li> 1. {@link HeadersFootersAtom} * <li> 2. {@link CString }, Instance UserDate (0), optional: Stores the user's date. * This is the date that the user wants in the footers, instead of today's date. * <li> 3. {@link CString }, Instance Header (1), optional: Stores the Header's contents. * <li> 4. {@link CString }, Instance Footer (2), optional: Stores the Footer's contents. - * </p> - * - * @author Yegor Kozlov + * </ul> */ public final class HeadersFootersContainer extends RecordContainer { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfo.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfo.java index 38b0c6ecc9..63826003a0 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfo.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfo.java @@ -26,7 +26,6 @@ import org.apache.poi.util.LittleEndian; * This class represents the metadata of a link in a slide/notes/etc. * It normally just holds a InteractiveInfoAtom, with the metadata * in it. - * @author Nick Burch */ public class InteractiveInfo extends RecordContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfoAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfoAtom.java index 3543010612..5b60c632fc 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfoAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/InteractiveInfoAtom.java @@ -33,9 +33,6 @@ import org.apache.poi.util.LittleEndian; /** * Tne atom that holds metadata on Links in the document. * (The actual link is held Document.ExObjList.ExHyperlink) - * - * @author Nick Burch - * @author Yegor Kozlov */ public class InteractiveInfoAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/MainMaster.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/MainMaster.java index e771fcf57d..62c475de46 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/MainMaster.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/MainMaster.java @@ -24,8 +24,6 @@ import java.util.Arrays; /** * Master slide - * - * @author Yegor Kozlov */ public final class MainMaster extends SheetContainer { private byte[] _header; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Notes.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Notes.java index 4854426283..b53842f70f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Notes.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Notes.java @@ -24,8 +24,6 @@ import java.util.Arrays; /** * Master container for Notes. There is one of these for every page of * notes, and they have certain specific children - * - * @author Nick Burch */ public final class Notes extends SheetContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/NotesAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/NotesAtom.java index 655898adb8..74fb25f27e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/NotesAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/NotesAtom.java @@ -30,8 +30,6 @@ import org.apache.poi.util.LittleEndian; /** * A Notes Atom (type 1009). Holds information on the parent Notes, such * as what slide it is tied to - * - * @author Nick Burch */ public final class NotesAtom extends RecordAtom diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/OutlineTextRefAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/OutlineTextRefAtom.java index e521c74383..e56a9aec16 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/OutlineTextRefAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/OutlineTextRefAtom.java @@ -35,9 +35,6 @@ import org.apache.poi.util.LittleEndian; * in a SlideListWithText containter. Sometimes slide texts are not contained * within the slide container to be able to delay loading a slide and still display * the title and body text in outline view. - * </p> - * - * @author Yegor Kozlov */ public final class OutlineTextRefAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ParentAwareRecord.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ParentAwareRecord.java index b2d84373cb..d09c8f7702 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ParentAwareRecord.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/ParentAwareRecord.java @@ -20,8 +20,6 @@ package org.apache.poi.hslf.record; /** * Interface to define how a record can indicate it cares about what its * parent is, and how it wants to be told which record is its parent. - * - * @author Nick Burch (nick at torchbox dot com) */ public interface ParentAwareRecord { public org.apache.poi.hslf.record.RecordContainer getParentRecord(); diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PersistRecord.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PersistRecord.java index 339331865c..23cb585f81 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PersistRecord.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PersistRecord.java @@ -19,8 +19,6 @@ package org.apache.poi.hslf.record; /** * A record that can be referenced in PersistPtr storage. - * - * @author Yegor Kozlov */ public interface PersistRecord { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PositionDependentRecord.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PositionDependentRecord.java index 844c14d45d..e71a9a7b5a 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PositionDependentRecord.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/PositionDependentRecord.java @@ -28,8 +28,6 @@ import java.util.Map; * need to be pinged with their current location. When written out, they * need to be given their new location, and offered the list of records * which have changed their location. - * - * @author Nick Burch */ public interface PositionDependentRecord diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Record.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Record.java index be3bde7aab..e66f481c1f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Record.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Record.java @@ -38,8 +38,6 @@ import static org.apache.logging.log4j.util.Unbox.box; * This abstract class represents a record in the PowerPoint document. * Record classes should extend with RecordContainer or RecordAtom, which * extend this in turn. - * - * @author Nick Burch */ public abstract class Record implements GenericRecord diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RecordAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RecordAtom.java index 4de227a2c2..9d2cbb1457 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RecordAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RecordAtom.java @@ -19,8 +19,6 @@ package org.apache.poi.hslf.record; /** * Abstract class which all atom records will extend. - * - * @author Nick Burch */ public abstract class RecordAtom extends Record diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RoundTripHFPlaceholder12.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RoundTripHFPlaceholder12.java index 283c65ba43..d29cfb99df 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RoundTripHFPlaceholder12.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/RoundTripHFPlaceholder12.java @@ -28,9 +28,6 @@ import org.apache.poi.util.LittleEndian; /** * An atom record that specifies that a shape is a header or footer placeholder shape - * - * @since PowerPoint 2007 - * @author Yegor Kozlov */ public final class RoundTripHFPlaceholder12 extends RecordAtom { /** diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Slide.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Slide.java index cf8d2466c0..f8e718a9e5 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Slide.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Slide.java @@ -26,8 +26,6 @@ import org.apache.poi.util.LittleEndian; /** * Master container for Slides. There is one of these for every slide, * and they have certain specific children - * - * @author Nick Burch */ public final class Slide extends SheetContainer diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SlideListWithText.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SlideListWithText.java index d0298a5be2..b57207e41d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SlideListWithText.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SlideListWithText.java @@ -42,8 +42,6 @@ import org.apache.poi.util.LittleEndian; * * For now, we scan through looking for interesting bits, then creating * the helpful Sheet from model for them - * - * @author Nick Burch */ // For now, pretend to be an atom diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Sound.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Sound.java index 2df455bd9e..1fca0bf9d4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Sound.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/Sound.java @@ -25,15 +25,13 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * A container holding information about a sound. It contains: - * <p> + * <ul> * <li>1. CString (4026), Instance 0: Name of sound (e.g. "crash") * <li>2. CString (4026), Instance 1: Type of sound (e.g. ".wav") * <li>3. CString (4026), Instance 2: Reference id of sound in sound collection * <li>4. CString (4026), Instance 3, optional: Built-in id of sound, for sounds we ship. This is the id that?s in the reg file. * <li>5. SoundData (2023), optional - * </p> - * - * @author Yegor Kozlov + * </ul> */ public final class Sound extends RecordContainer { /** diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundCollection.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundCollection.java index 3fda587c6e..d55cfe25e2 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundCollection.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundCollection.java @@ -23,10 +23,10 @@ import java.util.Arrays; /** * Is a container for all sound related atoms and containers. It contains: - *<li>1. SoundCollAtom (2021) - *<li>2. Sound (2022), for each sound, if any - * - * @author Yegor Kozlov + * <ul> + * <li>1. SoundCollAtom (2021)</li> + * <li>2. Sound (2022), for each sound, if any</li> + * </ul> */ public final class SoundCollection extends RecordContainer { /** diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundData.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundData.java index 0989052c56..f51e059a21 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundData.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/SoundData.java @@ -29,8 +29,6 @@ import org.apache.poi.util.LittleEndian; /** * Storage for embedded sounds. - * - * @author Yegor Kozlov */ public final class SoundData extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TextSpecInfoAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TextSpecInfoAtom.java index b26e9cb04b..fdc16db465 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TextSpecInfoAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TextSpecInfoAtom.java @@ -35,8 +35,6 @@ import org.apache.poi.util.LittleEndianByteArrayInputStream; /** * The special info runs contained in this text. * Special info runs consist of character properties which don?t follow styles. - * - * @author Yegor Kozlov */ public final class TextSpecInfoAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TxInteractiveInfoAtom.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TxInteractiveInfoAtom.java index f5896aa817..87175331be 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TxInteractiveInfoAtom.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/TxInteractiveInfoAtom.java @@ -29,8 +29,6 @@ import org.apache.poi.util.LittleEndian; /** * Tne atom that holds starting and ending character positions of a hyperlink - * - * @author Yegor Kozlov */ public final class TxInteractiveInfoAtom extends RecordAtom { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/UnknownRecordPlaceholder.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/UnknownRecordPlaceholder.java index 886a0dd20f..6b1b5483e4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/UnknownRecordPlaceholder.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/record/UnknownRecordPlaceholder.java @@ -30,8 +30,6 @@ import org.apache.poi.util.LittleEndian; * If we come across a record we don't know about, we create one of * these. It allows us to keep track of what it contains, so we can * write it back out to disk unchanged - * - * @author Nick Burch */ @SuppressWarnings("unused") diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFBackground.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFBackground.java index 8f477f9562..eac3d846fb 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFBackground.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFBackground.java @@ -23,8 +23,6 @@ import org.apache.poi.sl.usermodel.ShapeContainer; /** * Background shape - * - * @author Yegor Kozlov */ public final class HSLFBackground extends HSLFShape implements Background<HSLFShape,HSLFTextParagraph> { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFLine.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFLine.java index 1e42326f26..38a3a5fe6f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFLine.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFLine.java @@ -27,8 +27,6 @@ import org.apache.poi.sl.usermodel.ShapeType; /** * Represents a line in a PowerPoint drawing - * - * @author Yegor Kozlov */ public final class HSLFLine extends HSLFTextShape implements Line<HSLFShape,HSLFTextParagraph> { public HSLFLine(EscherContainerRecord escherRecord, ShapeContainer<HSLFShape,HSLFTextParagraph> parent){ @@ -47,7 +45,7 @@ public final class HSLFLine extends HSLFTextShape implements Line<HSLFShape,HSLF @Override protected EscherContainerRecord createSpContainer(boolean isChild){ EscherContainerRecord ecr = super.createSpContainer(isChild); - + setShapeType(ShapeType.LINE); EscherSpRecord spRecord = ecr.getChildById(EscherSpRecord.RECORD_ID); @@ -67,20 +65,20 @@ public final class HSLFLine extends HSLFTextShape implements Line<HSLFShape,HSLF return ecr; } - + // /** // * Sets the orientation of the line, if inverse is false, then line goes -// * from top-left to bottom-right, otherwise use inverse equals true +// * from top-left to bottom-right, otherwise use inverse equals true // * // * @param inverse the orientation of the line // */ // public void setInverse(boolean inverse) { // setShapeType(inverse ? ShapeType.LINE_INV : ShapeType.LINE); // } -// +// // /** // * Gets the orientation of the line, if inverse is false, then line goes -// * from top-left to bottom-right, otherwise inverse equals true +// * from top-left to bottom-right, otherwise inverse equals true // * // * @return inverse the orientation of the line // */ diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFNotes.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFNotes.java index 9377bfa439..baca28cd5d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFNotes.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFNotes.java @@ -31,8 +31,6 @@ import org.apache.poi.sl.usermodel.Placeholder; * This class represents a slide's notes in a PowerPoint Document. It * allows access to the text within, and the layout. For now, it only * does the text side of things though - * - * @author Nick Burch */ public final class HSLFNotes extends HSLFSheet implements Notes<HSLFShape,HSLFTextParagraph> { @@ -72,6 +70,7 @@ public final class HSLFNotes extends HSLFSheet implements Notes<HSLFShape,HSLFTe /** * Return <code>null</code> - Notes Masters are not yet supported */ + @Override public HSLFMasterSheet getMasterSheet() { return null; } diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholder.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholder.java index 4b13300590..9366dface1 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholder.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholder.java @@ -23,8 +23,6 @@ import org.apache.poi.sl.usermodel.ShapeContainer; /** * Represents a Placeholder in PowerPoint. - * - * @author Yegor Kozlov */ public final class HSLFPlaceholder extends HSLFTextBox { @@ -48,7 +46,7 @@ public final class HSLFPlaceholder extends HSLFTextBox { @Override protected EscherContainerRecord createSpContainer(boolean isChild){ EscherContainerRecord ecr = super.createSpContainer(isChild); - + setPlaceholder(Placeholder.BODY); return ecr; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSheet.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSheet.java index 9a010661c5..6ceafed5b4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSheet.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSheet.java @@ -47,14 +47,11 @@ import org.apache.poi.util.Internal; /** * This class defines the common format of "Sheets" in a powerpoint * document. Such sheets could be Slides, Notes, Master etc - * - * @author Nick Burch - * @author Yegor Kozlov */ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,HSLFTextParagraph> { /** - * The <code>SlideShow</code> we belong to + * The {@code SlideShow} we belong to */ private HSLFSlideShow _slideShow; @@ -69,9 +66,9 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H * for notes it is org.apache.poi.hslf.record.Notes, * for slide masters it is org.apache.poi.hslf.record.SlideMaster, etc. */ - private SheetContainer _container; + private final SheetContainer _container; - private int _sheetNo; + private final int _sheetNo; public HSLFSheet(SheetContainer container, int sheetNo) { _container = container; @@ -130,7 +127,7 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H if (_slideShow != null) { throw new HSLFException("Can't change existing slideshow reference"); } - + _slideShow = ss; List<List<HSLFTextParagraph>> trs = getTextParagraphs(); if (trs == null) { @@ -177,14 +174,14 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H EscherContainerRecord sp = (EscherContainerRecord)r; HSLFShape sh = HSLFShapeFactory.createShape(sp, null); sh.setSheet(this); - + if (sh instanceof HSLFSimpleShape) { HSLFHyperlink link = HSLFHyperlink.find(sh); if (link != null) { ((HSLFSimpleShape)sh).setHyperlink(link); } } - + shapeList.add(sh); } @@ -224,7 +221,7 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H * Removes the specified shape from this sheet. * * @param shape shape to be removed from this sheet, if present. - * @return <tt>true</tt> if the shape was deleted. + * @return {@code true} if the shape was deleted. */ @Override public boolean removeShape(HSLFShape shape) { @@ -287,8 +284,6 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H /** * Subclasses should call this method and update the array of text runs * when a text shape is added - * - * @param shape */ protected void onAddTextShape(HSLFTextShape shape) { } @@ -297,7 +292,7 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H * Return placeholder by text type * * @param type type of text, See {@link org.apache.poi.hslf.record.TextHeaderAtom} - * @return <code>TextShape</code> or <code>null</code> + * @return {@code TextShape} or {@code null} */ public HSLFTextShape getPlaceholderByTextType(int type){ for (HSLFShape shape : getShapes()) { @@ -330,7 +325,7 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H } /** - * Return programmable tag associated with this sheet, e.g. <code>___PPT12</code>. + * Return programmable tag associated with this sheet, e.g. {@code ___PPT12}. * * @return programmable tag associated with this sheet. */ @@ -452,7 +447,7 @@ public abstract class HSLFSheet implements HSLFShapeContainer, Sheet<HSLFShape,H addShape(s); return s; } - + /** * Header / Footer settings for this slide. * diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlide.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlide.java index 7d1b6711ee..1d51de9f91 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlide.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlide.java @@ -33,7 +33,6 @@ import org.apache.poi.hslf.record.ColorSchemeAtom; import org.apache.poi.hslf.record.Comment2000; import org.apache.poi.hslf.record.EscherTextboxWrapper; import org.apache.poi.hslf.record.HeadersFootersContainer; -import org.apache.poi.hslf.record.Record; import org.apache.poi.hslf.record.RecordContainer; import org.apache.poi.hslf.record.RecordTypes; import org.apache.poi.hslf.record.SSSlideInfoAtom; @@ -54,9 +53,6 @@ import org.apache.poi.sl.usermodel.TextShape.TextPlaceholder; * This class represents a slide in a PowerPoint Document. It allows * access to the text within, and the layout. For now, it only does * the text side of things though - * - * @author Nick Burch - * @author Yegor Kozlov */ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTextParagraph> { @@ -154,9 +150,10 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe * Called by SlideShow ater a new slide is created. * <p> * For Slide we need to do the following: - * <li> set id of the drawing group. - * <li> set shapeId for the container descriptor and background - * </p> + * <ul> + * <li> set id of the drawing group.</li> + * <li> set shapeId for the container descriptor and background</li> + * </ul> */ @Override public void onCreate(){ @@ -191,9 +188,9 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe } /** - * Create a <code>TextBox</code> object that represents the slide's title. + * Create a {@code TextBox} object that represents the slide's title. * - * @return <code>TextBox</code> object that represents the slide's title. + * @return {@code TextBox} object that represents the slide's title. */ public HSLFTextBox addTitle() { HSLFPlaceholder pl = new HSLFPlaceholder(); @@ -211,8 +208,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * <p> - * The title is a run of text of type <code>TextHeaderAtom.CENTER_TITLE_TYPE</code> or - * <code>TextHeaderAtom.TITLE_TYPE</code> + * The title is a run of text of type {@code TextHeaderAtom.CENTER_TITLE_TYPE} or + * {@code TextHeaderAtom.TITLE_TYPE} * </p> * * @see TextHeaderAtom @@ -259,7 +256,7 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe } /** - * @return set of records inside <code>SlideListWithtext</code> container + * @return set of records inside {@code SlideListWithtext} container * which hold text data for this slide (typically for placeholders). */ protected SlideAtomsSet getSlideAtomsSet() { return _atomSet; } @@ -298,8 +295,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Sets whether this slide follows master background * - * @param flag <code>true</code> if the slide follows master, - * <code>false</code> otherwise + * @param flag {@code true} if the slide follows master, + * {@code false} otherwise */ @Override public void setFollowMasterBackground(boolean flag){ @@ -310,8 +307,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Whether this slide follows master sheet background * - * @return <code>true</code> if the slide follows master background, - * <code>false</code> otherwise + * @return {@code true} if the slide follows master background, + * {@code false} otherwise */ @Override public boolean getFollowMasterBackground(){ @@ -322,8 +319,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Sets whether this slide draws master sheet objects * - * @param flag <code>true</code> if the slide draws master sheet objects, - * <code>false</code> otherwise + * @param flag {@code true} if the slide draws master sheet objects, + * {@code false} otherwise */ @Override public void setFollowMasterObjects(boolean flag){ @@ -334,8 +331,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Whether this slide follows master color scheme * - * @return <code>true</code> if the slide follows master color scheme, - * <code>false</code> otherwise + * @return {@code true} if the slide follows master color scheme, + * {@code false} otherwise */ public boolean getFollowMasterScheme(){ SlideAtom sa = getSlideRecord().getSlideAtom(); @@ -345,8 +342,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Sets whether this slide draws master color scheme * - * @param flag <code>true</code> if the slide draws master color scheme, - * <code>false</code> otherwise + * @param flag {@code true} if the slide draws master color scheme, + * {@code false} otherwise */ public void setFollowMasterScheme(boolean flag){ SlideAtom sa = getSlideRecord().getSlideAtom(); @@ -356,8 +353,8 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe /** * Whether this slide draws master sheet objects * - * @return <code>true</code> if the slide draws master sheet objects, - * <code>false</code> otherwise + * @return {@code true} if the slide draws master sheet objects, + * {@code false} otherwise */ @Override public boolean getFollowMasterObjects(){ @@ -403,6 +400,7 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe * PPT 2003 files. Doesn't work for PPT 97 * ones, as they do their comments oddly. */ + @Override public List<HSLFComment> getComments() { final List<HSLFComment> comments = new ArrayList<>(); // If there are any, they're in @@ -427,6 +425,7 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe * * @return Header / Footer settings for this slide */ + @Override public HeadersFooters getHeadersFooters(){ return new HeadersFooters(this, HeadersFootersContainer.SlideHeadersFootersContainer); } @@ -473,7 +472,7 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe Drawable draw = drawFact.getDrawable(this); draw.draw(graphics); } - + @Override public boolean getFollowMasterColourScheme() { return false; @@ -482,7 +481,7 @@ public final class HSLFSlide extends HSLFSheet implements Slide<HSLFShape,HSLFTe @Override public void setFollowMasterColourScheme(boolean follow) { } - + @Override public boolean getFollowMasterGraphics() { return getFollowMasterObjects(); diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideMaster.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideMaster.java index 2f258e6eb6..dbd5079118 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideMaster.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSlideMaster.java @@ -33,8 +33,6 @@ import org.apache.poi.util.Internal; * SlideMaster determines the graphics, layout, and formatting for all the slides in a given presentation. * It stores information about default font styles, placeholder sizes and positions, * background design, and color schemes. - * - * @author Yegor Kozlov */ public final class HSLFSlideMaster extends HSLFMasterSheet { private final List<List<HSLFTextParagraph>> _paragraphs = new ArrayList<>(); @@ -80,11 +78,11 @@ public final class HSLFSlideMaster extends HSLFMasterSheet { * If {@code name = "*"} return the current collection, otherwise if the name is not found * in the current selection of txtype/level/name, first try lower levels then try parent types, * if it wasn't found there return {@code null}. - * + * * @param txtype the {@link TextHeaderAtom} type * @param level the indent level of the paragraph, if the level is not defined for the found * collection, the highest existing level will be used - * @param name the property name, + * @param name the property name, * @param isCharacter if {@code true} use character styles, otherwise use paragraph styles */ @Override diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSoundData.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSoundData.java index dda143735a..d6403b204e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSoundData.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFSoundData.java @@ -23,8 +23,6 @@ import java.util.ArrayList; /** * A class that represents sound data embedded in a slide show. - * - * @author Yegor Kozlov */ public final class HSLFSoundData { /** diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTable.java index 6218e1e5ed..98eba71017 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTable.java @@ -40,8 +40,6 @@ import org.apache.poi.util.Units; /** * Represents a table in a PowerPoint presentation - * - * @author Yegor Kozlov */ public final class HSLFTable extends HSLFGroupShape implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { @@ -186,10 +184,10 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { if (htc.isEmpty()) { throw new IllegalStateException("HSLFTable without HSLFTableCells"); } - + SortedSet<Double> colSet = new TreeSet<>(); SortedSet<Double> rowSet = new TreeSet<>(); - + // #1 pass - determine cols and rows for (HSLFTableCell sh : htc) { Rectangle2D anchor = sh.getAnchor(); @@ -197,10 +195,10 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { rowSet.add(anchor.getY()); } cells = new HSLFTableCell[rowSet.size()][colSet.size()]; - + List<Double> colLst = new ArrayList<>(colSet); List<Double> rowLst = new ArrayList<>(rowSet); - + // #2 pass - assign shape to table cells for (HSLFTableCell sh : htc) { Rectangle2D anchor = sh.getAnchor(); @@ -208,14 +206,14 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { int col = colLst.indexOf(anchor.getX()); assert(row != -1 && col != -1); cells[row][col] = sh; - + // determine gridSpan / rowSpan int gridSpan = calcSpan(colLst, anchor.getWidth(), col); int rowSpan = calcSpan(rowLst, anchor.getHeight(), row); - + sh.setGridSpan(gridSpan); sh.setRowSpan(rowSpan); - } + } } private int calcSpan(List<Double> spaces, double totalSpace, int idx) { @@ -227,7 +225,7 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { } return span; } - + static class LineRect { final HSLFLine l; final double lx1, lx2, ly1, ly2; @@ -356,10 +354,10 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { if (row < 0 || row >= cells.length) { throw new IllegalArgumentException("Row index '"+row+"' is not within range [0-"+(cells.length-1)+"]"); } - + return cells[row][0].getAnchor().getHeight(); } - + @Override public void setRowHeight(int row, final double height) { if (row < 0 || row >= cells.length) { @@ -373,7 +371,7 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { double currentHeight = Units.masterToPoints(LittleEndian.getInt(masterBytes, 0)); LittleEndian.putInt(masterBytes, 0, Units.pointsToMaster(height)); p.setElement(row, masterBytes); - + // move the cells double dy = height - currentHeight; for (int i = row; i < cells.length; i++) { @@ -400,7 +398,7 @@ implements HSLFShapeContainer, TableShape<HSLFShape,HSLFTextParagraph> { if (col < 0 || col >= cells[0].length) { throw new IllegalArgumentException("Column index '"+col+"' is not within range [0-"+(cells[0].length-1)+"]"); } - + // TODO: check for merged cols return cells[0][col].getAnchor().getWidth(); } diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTextBox.java b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTextBox.java index 485389dcdd..228cc719e8 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTextBox.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFTextBox.java @@ -29,9 +29,6 @@ import org.apache.poi.sl.usermodel.VerticalAlignment; * <p> * Contains the text in a text frame as well as the properties and methods * that control alignment and anchoring of the text. - * </p> - * - * @author Yegor Kozlov */ public class HSLFTextBox extends HSLFTextShape implements TextBox<HSLFShape,HSLFTextParagraph> { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelConverter.java b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelConverter.java index 6f5ab29bb4..6447663d00 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelConverter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelConverter.java @@ -33,7 +33,6 @@ import org.w3c.dom.Document; /** * Common class for {@link ExcelToFoConverter} and {@link ExcelToHtmlConverter} * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) * @see AbstractWordConverter */ @Beta @@ -67,7 +66,7 @@ public abstract class AbstractExcelConverter /** * Generates name for output as column header in case - * <tt>{@link #isOutputColumnHeaders()} == true</tt> + * {@link #isOutputColumnHeaders()}{@code == true} * * @param columnIndex * 0-based column index @@ -86,7 +85,7 @@ public abstract class AbstractExcelConverter /** * Generates name for output as row number in case - * <tt>{@link #isOutputRowNumbers()} == true</tt> + * {@link #isOutputRowNumbers()}{@code == true} */ protected String getRowName( HSSFRow row ) { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelUtils.java b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelUtils.java index 744ffc9041..a4f9b13e23 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelUtils.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/AbstractExcelUtils.java @@ -160,7 +160,7 @@ class AbstractExcelUtils { * @param mergedRanges map of sheet merged ranges built with * {@link #buildMergedRangesMap(Sheet)} * @return {@link CellRangeAddress} from map if cell with specified row and - * column numbers contained in found range, <tt>null</tt> otherwise + * column numbers contained in found range, {@code null} otherwise */ public static CellRangeAddress getMergedRange( CellRangeAddress[][] mergedRanges, int rowNumber, int columnNumber) { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToFoConverter.java b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToFoConverter.java index d6938867e1..5724e024b0 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToFoConverter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToFoConverter.java @@ -170,11 +170,11 @@ public class ExcelToFoConverter extends AbstractExcelConverter { } /** - * Returns <tt>false</tt> if cell style by itself (without text, i.e. - * borders, fill, etc.) worth a mention, <tt>true</tt> otherwise + * Returns {@code false} if cell style by itself (without text, i.e. + * borders, fill, etc.) worth a mention, {@code true} otherwise * - * @return <tt>false</tt> if cell style by itself (without text, i.e. - * borders, fill, etc.) worth a mention, <tt>true</tt> otherwise + * @return {@code false} if cell style by itself (without text, i.e. + * borders, fill, etc.) worth a mention, {@code true} otherwise */ protected boolean isEmptyStyle(CellStyle cellStyle) { return cellStyle == null || ( @@ -423,7 +423,7 @@ public class ExcelToFoConverter extends AbstractExcelConverter { /** * Creates COLGROUP element with width specified for all columns. (Except - * first if <tt>{@link #isOutputRowNumbers()}==true</tt>) + * first if {@link #isOutputRowNumbers()}{@code ==true}) * * @return table width in inches */ @@ -670,7 +670,7 @@ public class ExcelToFoConverter extends AbstractExcelConverter { /** * Process single sheet (as specified by 0-based sheet index) * - * @return <tt>true</tt> if result were added to FO document, <tt>false</tt> + * @return {@code true} if result were added to FO document, {@code false} * otherwise */ protected boolean processSheet(HSSFWorkbook workbook, int sheetIndex) { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java index aab72a0e69..7c0fd29801 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hssf/converter/ExcelToHtmlConverter.java @@ -69,7 +69,7 @@ public class ExcelToHtmlConverter extends AbstractExcelConverter { private static final Logger LOG = LogManager.getLogger(ExcelToHtmlConverter.class); /** - * Java main() interface to interact with {@link ExcelToHtmlConverter} + * Java main() interface to interact with ExcelToHtmlConverter * * <p> * Usage: ExcelToHtmlConverter infile outfile @@ -266,13 +266,14 @@ public class ExcelToHtmlConverter extends AbstractExcelConverter { return cssClassPrefixTable; } + @Override public Document getDocument() { return htmlDocumentFacade.getDocument(); } protected String getStyleClassName(HSSFWorkbook workbook, HSSFCellStyle cellStyle) { - final Short cellStyleKey = Short.valueOf(cellStyle.getIndex()); + final Short cellStyleKey = cellStyle.getIndex(); String knownClass = excelStyleToClass.get(cellStyleKey); if (knownClass != null) { @@ -446,7 +447,7 @@ public class ExcelToHtmlConverter extends AbstractExcelConverter { /** * Creates COLGROUP element with width specified for all columns. (Except - * first if <tt>{@link #isOutputRowNumbers()}==true</tt>) + * first if {@link #isOutputRowNumbers()}{@code ==true}) */ protected void processColumnWidths(HSSFSheet sheet, int maxSheetColumns, Element table) { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/NumberFormatter.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/NumberFormatter.java index 4a69de63c5..5c47a5ca23 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/NumberFormatter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/NumberFormatter.java @@ -25,8 +25,6 @@ import org.apache.poi.util.Beta; /** * Utility class to translate numbers in letters, usually for lists. - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Beta public final class NumberFormatter { @@ -61,7 +59,7 @@ public final class NumberFormatter { return String.valueOf( num ); } } - + private static String toLetters(int number) { if ( number <= 0 ) { throw new IllegalArgumentException( "Unsupported number: " + number ); diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/PicturesManager.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/PicturesManager.java index e8bb2e2c5a..fc2e52df83 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/PicturesManager.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/PicturesManager.java @@ -21,8 +21,6 @@ import org.apache.poi.util.Beta; /** * User-implemented pictures manager to store images on-disk - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Beta public interface PicturesManager @@ -35,7 +33,7 @@ public interface PicturesManager * {@link PictureType#TIFF}, but rarely {@link PictureType#EMF} or * {@link PictureType#WMF}. FO (Apache FOP) supports at least PNG and SVG * types. - * + * * @param content * picture content * @param pictureType @@ -50,7 +48,7 @@ public interface PicturesManager * display height in inches (scaled). May be useful for rendering * vector images (such as EMF or WMF) * @return path to file that can be used as reference in HTML (img's src) of - * XLS FO (fo:external-graphic's src) or <tt>null</tt> if image were + * XLS FO (fo:external-graphic's src) or {@code null} if image were * not saved and should not be referenced from result HTML / FO. */ String savePicture( byte[] content, PictureType pictureType, diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToFoConverter.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToFoConverter.java index d91708424c..3aca26981f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToFoConverter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToFoConverter.java @@ -58,9 +58,6 @@ import org.w3c.dom.Node; import org.w3c.dom.NodeList; import org.w3c.dom.Text; -/** - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) - */ @Beta public class WordToFoConverter extends AbstractWordConverter { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToHtmlConverter.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToHtmlConverter.java index a60d504405..e829a997ec 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToHtmlConverter.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/converter/WordToHtmlConverter.java @@ -67,8 +67,8 @@ import org.w3c.dom.Text; public class WordToHtmlConverter extends AbstractWordConverter { /** - * Holds properties values, applied to current <tt>p</tt> element. Those - * properties shall not be doubled in children <tt>span</tt> elements. + * Holds properties values, applied to current {@code p} element. Those + * properties shall not be doubled in children {@code span} elements. */ private static class BlockProperies { @@ -91,7 +91,7 @@ public class WordToHtmlConverter extends AbstractWordConverter private Element notes; /** - * Creates new instance of {@link WordToHtmlConverter}. Can be used for + * Creates new instance of WordToHtmlConverter. Can be used for * output several {@link HWPFDocument}s into single HTML document. * * @param document XML DOM Document used as HTML document @@ -132,7 +132,7 @@ public class WordToHtmlConverter extends AbstractWordConverter } /** - * Java main() interface to interact with {@link WordToHtmlConverter}<p> + * Java main() interface to interact with WordToHtmlConverter<p> * * Usage: WordToHtmlConverter infile outfile<p> * diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/FieldIterator.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/FieldIterator.java index 1c15980b90..39bd5f31fe 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/FieldIterator.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/FieldIterator.java @@ -20,11 +20,7 @@ package org.apache.poi.hwpf.dev; import org.apache.poi.util.Internal; /** - * <p> * For iterating through our fields. Used during model classes autogeneration. - * </p> - * - * @author Glen Stampoultzis (glens at apache.org) */ @Internal public class FieldIterator diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/HWPFLister.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/HWPFLister.java index 6d487487bc..8fb9055bc5 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/HWPFLister.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/HWPFLister.java @@ -69,9 +69,6 @@ import org.apache.poi.util.LittleEndian; /** * Used by developers to list out key information on a HWPF file. End users will * probably never need to use this program. - * - * @author Nick Burch (nick at torchbox dot com) - * @author Sergey Vladimirov (vlsergey at gmail dot com) */ @Beta public final class HWPFLister { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/RecordUtil.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/RecordUtil.java index 6ecb5c33df..cd11e5d879 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/RecordUtil.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/dev/RecordUtil.java @@ -23,9 +23,6 @@ import org.apache.poi.util.StringUtil; /** * Helper functions for the record transformations. Used during model classes * autogeneration. - * - * @author Glen Stampoultzis (glens at apache.org) - * @author Andrew C. Oliver (acoliver at apache dot org) */ @Internal public class RecordUtil diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/Word6Extractor.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/Word6Extractor.java index 526d21be35..2cd17399e3 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/Word6Extractor.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/Word6Extractor.java @@ -33,8 +33,6 @@ import org.apache.poi.poifs.filesystem.POIFSFileSystem; * This should only be used on the older files, for most uses you * should call {@link WordExtractor} which deals properly * with HWPF. - * - * @author Nick Burch */ public final class Word6Extractor implements POIOLE2TextExtractor { private HWPFOldDocument doc; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/WordExtractor.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/WordExtractor.java index 4e4d190536..82f806caaa 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/WordExtractor.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/extractor/WordExtractor.java @@ -35,8 +35,6 @@ import org.apache.poi.poifs.filesystem.POIFSFileSystem; * * You should use either getParagraphText() or getText() unless you have a * strong reason otherwise. - * - * @author Nick Burch */ public final class WordExtractor implements POIOLE2TextExtractor { private final HWPFDocument doc; diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPBinTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPBinTable.java index 178186bd35..24cfb6d183 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPBinTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPBinTable.java @@ -46,8 +46,6 @@ import static org.apache.logging.log4j.util.Unbox.box; /** * This class holds all of the character formatting properties. - * - * @author Ryan Ackley */ @Internal public class CHPBinTable diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPFormattedDiskPage.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPFormattedDiskPage.java index 349f39b634..91dfcf6c1f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPFormattedDiskPage.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/CHPFormattedDiskPage.java @@ -40,8 +40,6 @@ import org.apache.poi.util.RecordFormatException; * CHP and PAP fkps also store the compressed styles(grpprl) that correspond to * the offsets on the front of the fkp. The offset of the grpprls is determined * differently for CHP fkps and PAP fkps. - * - * @author Ryan Ackley */ @Internal public final class CHPFormattedDiskPage extends FormattedDiskPage diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/DocumentProperties.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/DocumentProperties.java index f292643fb1..b2bfbe8fc3 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/DocumentProperties.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/DocumentProperties.java @@ -24,11 +24,6 @@ import org.apache.poi.hwpf.model.types.DOPAbstractType; import org.apache.poi.util.IOUtils; import org.apache.poi.util.Internal; -/** - * Comment me - * - * @author Ryan Ackley - */ @Internal public final class DocumentProperties extends DOPAbstractType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFData.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFData.java index a33e5af350..50f51ed663 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFData.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFData.java @@ -28,17 +28,6 @@ import org.apache.poi.util.LittleEndianConsts; /** * The FFData structure specifies form field data for a text box, check box, or * drop-down list box. - * <p> - * Class and fields descriptions are quoted from [MS-DOC] -- v20121003 Word - * (.doc) Binary File Format; Copyright (c) 2012 Microsoft Corporation; Release: - * October 8, 2012 - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - * - * @author Sergey Vladimirov; according to [MS-DOC] -- v20121003 Word (.doc) - * Binary File Format; Copyright (c) 2012 Microsoft Corporation; - * Release: October 8, 2012 */ @Internal public class FFData diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFDataBase.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFDataBase.java index b12fe40691..444ab29b50 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFDataBase.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FFDataBase.java @@ -29,10 +29,6 @@ import org.apache.poi.util.Internal; * <p> * This class is internal. It content or properties may change without notice * due to changes in our knowledge of internal Microsoft Word binary structures. - * - * @author Sergey Vladimirov; according to [MS-DOC] -- v20121003 Word (.doc) - * Binary File Format; Copyright (c) 2012 Microsoft Corporation; - * Release: October 8, 2012 */ @Internal public class FFDataBase extends FFDataBaseAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FSPA.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FSPA.java index 3688914061..b035da4acb 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FSPA.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FSPA.java @@ -22,8 +22,6 @@ import org.apache.poi.util.Internal; /** * File Shape Address structure - * - * @author Squeeself */ @Internal public final class FSPA extends FSPAAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Ffn.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Ffn.java index 532318d739..32d9631277 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Ffn.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Ffn.java @@ -30,8 +30,6 @@ import org.apache.poi.util.LittleEndianConsts; * FFN - Font Family Name. FFN is a data structure that stores the names of the Main * Font and that of Alternate font as an array of characters. It has also a header * that stores info about the whole structure and the fonts - * - * @author Praveen Mathew */ @Internal public final class Ffn diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibBase.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibBase.java index 8f505b9588..a9e0a6e3ba 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibBase.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibBase.java @@ -27,10 +27,6 @@ import org.apache.poi.util.Internal; * <p> * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format. - * - * @author Andrew C. Oliver; Sergey Vladimirov; according to Microsoft Office - * Word 97-2007 Binary File Format Specification [*.doc] and [MS-DOC] - - * v20110608 Word (.doc) Binary File Format */ @Internal public class FibBase extends FibBaseAbstractType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw95.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw95.java index f2834eff39..218b3121da 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw95.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw95.java @@ -22,16 +22,9 @@ import org.apache.poi.util.Internal; /** * The FibRgLw97 structure is the third section of the FIB. This contains an * array of 4-byte values. - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format */ @Internal -class FibRgLw95 extends FibRgLw95AbstractType implements FibRgLw +class FibRgLw95 extends FibRgLw95AbstractType implements FibRgLw { public FibRgLw95() diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw97.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw97.java index 933afd0ca0..1713e829e3 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw97.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgLw97.java @@ -25,10 +25,6 @@ import org.apache.poi.util.Internal; * <p> * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format */ @Internal public class FibRgLw97 extends FibRgLw97AbstractType implements FibRgLw diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgW97.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgW97.java index c3b0f6bd9c..5fa906f952 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgW97.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FibRgW97.java @@ -23,13 +23,6 @@ import org.apache.poi.util.Internal; /** * The FibRgW97 structure is a variable-length portion of the Fib. - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format. - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format */ @Internal public class FibRgW97 extends FibRgW97AbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldDescriptor.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldDescriptor.java index 58e55a46cd..b81dd8c999 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldDescriptor.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldDescriptor.java @@ -22,8 +22,6 @@ import org.apache.poi.util.Internal; /** * Class for the FLD structure. - * - * @author Cedric Bosdonnat <cbosdonnat@novell.com> */ @Internal public final class FieldDescriptor extends FLDAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldsTables.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldsTables.java index 595078e47f..d672c294af 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldsTables.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FieldsTables.java @@ -29,9 +29,6 @@ import org.apache.poi.util.Internal; /** * This class provides access to all the fields Plex. - * - * @author Cedric Bosdonnat <cbosdonnat@novell.com> - * */ @Internal public class FieldsTables diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FontTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FontTable.java index 8fba06f82b..1a67d1c87d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FontTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FontTable.java @@ -32,8 +32,6 @@ import org.apache.poi.util.LittleEndianConsts; * Word files. The sttbfffn is an sttbf where each string is an FFN structure instead * of pascal-style strings. An sttbf is a string Table stored in file. Thus sttbffn * is like an Sttbf with an array of FFN structures that stores the font name strings - * - * @author Praveen Mathew */ @Internal public final class FontTable diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FormattedDiskPage.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FormattedDiskPage.java index 4c82d2db25..a5e4760f3a 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FormattedDiskPage.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/FormattedDiskPage.java @@ -37,8 +37,6 @@ import org.apache.poi.util.LittleEndian; * CHP and PAP fkps also store the compressed styles(grpprl) that correspond to * the offsets on the front of the fkp. The offset of the grpprls is determined * differently for CHP fkps and PAP fkps. - * - * @author Ryan Ackley */ @Internal public abstract class FormattedDiskPage { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Grfhic.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Grfhic.java index f627289a48..a08d503735 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Grfhic.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Grfhic.java @@ -24,15 +24,6 @@ import org.apache.poi.util.Internal; * HTML incompatibilities of a list structure. The values specify possible * incompatibilities between an LVL or LVLF and HTML lists. The values do not * define list properties. - * <p> - * Class and fields descriptions are quoted from [MS-DOC] -- v20110315 Word - * (.doc) Binary File Format specification - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - * - * @author Sergey Vladimirov; according to [MS-DOC] -- v20110315 Word (.doc) - * Binary File Format specification */ @Internal public class Grfhic extends GrfhicAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFO.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFO.java index edc069964a..5325ccc845 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFO.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFO.java @@ -23,10 +23,7 @@ import org.apache.poi.hwpf.model.types.LFOAbstractType; /** * "The LFO structure specifies the LSTF element that corresponds to a list that * contains a paragraph. An LFO can also specify formatting information that - * overrides the LSTF element to which it corresponds." -- [MS-DOC] -- v20110315 - * Word (.doc) Binary File Format - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) + * overrides the LSTF element to which it corresponds." */ @Internal public class LFO extends LFOAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOData.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOData.java index 2f22afdd51..0e8cca03a4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOData.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOData.java @@ -29,8 +29,6 @@ import org.apache.poi.util.LittleEndianConsts; /** * The LFOData structure contains the Main Document CP of the corresponding LFO, * as well as an array of LVL override data. - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Internal public class LFOData diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOLVLBase.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOLVLBase.java index 3a50a7c2f3..d117cac8d6 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOLVLBase.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LFOLVLBase.java @@ -24,10 +24,6 @@ import org.apache.poi.hwpf.model.types.LFOLVLBaseAbstractType; * <p> * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format */ class LFOLVLBase extends LFOLVLBaseAbstractType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LSTF.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LSTF.java index 9e00ffed40..f801904b2e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LSTF.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LSTF.java @@ -19,15 +19,7 @@ package org.apache.poi.hwpf.model; import org.apache.poi.hwpf.model.types.LSTFAbstractType; /** - * The LSTF structure contains formatting properties that apply to an entire - * list. - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format + * The LSTF structure contains formatting properties that apply to an entire list. */ class LSTF extends LSTFAbstractType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LVLF.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LVLF.java index 38192d263d..9c0678a6db 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LVLF.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/LVLF.java @@ -22,10 +22,6 @@ import org.apache.poi.util.Internal; /** * The LVLF structure contains formatting properties for an individual level in * a list - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] and [MS-DOC] - v20110608 Word - * (.doc) Binary File Format */ @Internal class LVLF extends LVLFAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NoteType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NoteType.java index 8168e96ae3..256332a300 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NoteType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NoteType.java @@ -15,15 +15,13 @@ limitations under the License. ==================================================================== */ -/** - * Word document notes types (and their FIB field indices) - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) - */ package org.apache.poi.hwpf.model; import org.apache.poi.util.Internal; +/** + * Word document notes types (and their FIB field indices) + */ @Internal public enum NoteType { /** Ending note */ diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NotesTables.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NotesTables.java index 92fa5287f0..c6ae28a415 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NotesTables.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/NotesTables.java @@ -24,8 +24,6 @@ import org.apache.poi.util.Internal; /** * Holds information about document notes (footnotes or ending notes) - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) */ @Internal public class NotesTables diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OfficeArtContent.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OfficeArtContent.java index 35436bf75a..df53ee6bc4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OfficeArtContent.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OfficeArtContent.java @@ -34,8 +34,6 @@ import static org.apache.logging.log4j.util.Unbox.box; * Information about drawings in the document. * <p> * The {@code delay stream} referenced in {@code [MS-ODRAW]} is the {@code WordDocument} stream. - * - * @author Squeeself */ @Internal public final class OfficeArtContent { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PAPFormattedDiskPage.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PAPFormattedDiskPage.java index e9c56cc558..785f692405 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PAPFormattedDiskPage.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PAPFormattedDiskPage.java @@ -41,8 +41,6 @@ import org.apache.poi.util.LittleEndian; * CHP and PAP fkps also store the compressed styles(grpprl) that correspond to * the offsets on the front of the fkp. The offset of the grpprls is determined * differently for CHP fkps and PAP fkps. - * - * @author Ryan Ackley */ @Internal public final class PAPFormattedDiskPage extends FormattedDiskPage { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PICF.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PICF.java index 44ab74078b..4610fd5716 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PICF.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PICF.java @@ -24,11 +24,6 @@ import org.apache.poi.util.Internal; /** * The PICF structure specifies the type of a picture, as well as the size of * the picture and information about its border. - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Internal public class PICF extends PICFAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PicturesTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PicturesTable.java index d3ef0b51a9..f1325081e3 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PicturesTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PicturesTable.java @@ -52,8 +52,6 @@ import org.apache.poi.util.LittleEndian; * CharacterRun.isSpecial() returns true. The file location of the picture in the Word binary file is accessed * via CharacterRun.getPicOffset(). The CharacterRun.getPicOffset() is a byte offset into the data stream. * Beginning at the position recorded in picOffset, a header data structure, will be stored. - * - * @author Dmitry Romanov */ @Internal public final class PicturesTable { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlexOfField.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlexOfField.java index 15793b7a4e..737659ea34 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlexOfField.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlexOfField.java @@ -25,8 +25,6 @@ import org.apache.poi.util.Internal; /** * Structure describing the Plex for fields (contained plclfd* in the spec). - * - * @author Cedric Bosdonnat <cbosdonnat@novell.com> */ @Internal public class PlexOfField diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlfLfo.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlfLfo.java index b2adc51ef1..79b8587bae 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlfLfo.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/PlfLfo.java @@ -36,8 +36,6 @@ import static org.apache.logging.log4j.util.Unbox.box; * <p> * Documentation quoted from Page 424 of 621. [MS-DOC] -- v20110315 Word (.doc) * Binary File Format - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public class PlfLfo { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/RevisionMarkAuthorTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/RevisionMarkAuthorTable.java index 2c4bd5521c..3cad305e05 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/RevisionMarkAuthorTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/RevisionMarkAuthorTable.java @@ -28,8 +28,6 @@ import org.apache.poi.util.Internal; /** * String table containing the names of authors of revision marks, e-mails and * comments in this document. - * - * @author Ryan Lauck */ @Internal public final class RevisionMarkAuthorTable { @@ -40,7 +38,7 @@ public final class RevisionMarkAuthorTable { /** * Constructor to read the table from the table stream. - * + * * @param tableStream the table stream. * @param offset the offset into the byte array. * @param size the size of the table in the byte array. @@ -53,16 +51,16 @@ public final class RevisionMarkAuthorTable { /** * Gets the entries. The returned list cannot be modified. - * + * * @return the list of entries. */ public List<String> getEntries() { return Collections.unmodifiableList(Arrays.asList(entries)); } - + /** * Get an author by its index. Returns null if it does not exist. - * + * * @return the revision mark author */ public String getAuthor(int index) { @@ -72,10 +70,10 @@ public final class RevisionMarkAuthorTable { } return auth; } - + /** * Gets the number of entries. - * + * * @return the number of entries. */ public int getSize() { @@ -84,7 +82,7 @@ public final class RevisionMarkAuthorTable { /** * Writes this table to the table stream. - * + * * @param tableStream the table stream to write to. * @throws IOException if an error occurs while writing. */ diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByEntry.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByEntry.java index b6a5796a3d..53cc03b96d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByEntry.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByEntry.java @@ -24,8 +24,6 @@ import org.apache.poi.util.Internal; /** * A single entry in the {@link SavedByTable}. - * - * @author Daniel Noll */ @Internal public final class SavedByEntry diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByTable.java index e8eff88eb1..42d5f76c7f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SavedByTable.java @@ -27,8 +27,6 @@ import org.apache.poi.util.Internal; /** * String table containing the history of the last few revisions ("saves") of * the document. Read-only for the time being. - * - * @author Daniel Noll */ @Internal public final class SavedByTable @@ -40,7 +38,7 @@ public final class SavedByTable /** * Constructor to read the table from the table stream. - * + * * @param tableStream * the table stream. * @param offset @@ -61,7 +59,7 @@ public final class SavedByTable /** * Gets the entries. The returned list cannot be modified. - * + * * @return the list of entries. */ public List<SavedByEntry> getEntries() @@ -71,7 +69,7 @@ public final class SavedByTable /** * Writes this table to the table stream. - * + * * @param tableStream * the table stream to write to. * @throws IOException diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Sttb.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Sttb.java index 85343ee242..20507e7cd1 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Sttb.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Sttb.java @@ -19,6 +19,7 @@ package org.apache.poi.hwpf.model; import java.util.Arrays; import org.apache.logging.log4j.LogManager; +import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; import org.apache.poi.util.LittleEndianConsts; import org.apache.poi.util.StringUtil; @@ -27,18 +28,8 @@ import org.apache.poi.util.StringUtil; * The STTB is a string table that is made up of a header that is followed by an * array of elements. The cData value specifies the number of elements that are * contained in the array. - * <p> - * Class and fields descriptions are quoted from [MS-DOC] -- v20121003 Word - * (.doc) Binary File Format; Copyright (c) 2012 Microsoft Corporation; Release: - * October 8, 2012 - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - * - * @author Sergey Vladimirov; according to [MS-DOC] -- v20121003 Word (.doc) - * Binary File Format; Copyright (c) 2012 Microsoft Corporation; - * Release: October 8, 2012 */ +@Internal public class Sttb { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SttbUtils.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SttbUtils.java index 850d40d509..09247b49fb 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SttbUtils.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SttbUtils.java @@ -23,8 +23,6 @@ import org.apache.poi.util.Internal; /** * Utils class for storing and reading "STring TaBle stored in File" - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Internal class SttbUtils diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleDescription.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleDescription.java index 05b2c04677..01f927a165 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleDescription.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleDescription.java @@ -33,11 +33,6 @@ import org.apache.poi.util.StringUtil; import static org.apache.logging.log4j.util.Unbox.box; -/** - * Comment me - * - * @author Ryan Ackley - */ @Internal public final class StyleDescription { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleSheet.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleSheet.java index ac37396657..18d703c835 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleSheet.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/StyleSheet.java @@ -36,8 +36,6 @@ import org.apache.poi.util.LittleEndianConsts; * <p> * Fields documentation is quotes from Microsoft Office Word 97-2007 Binary File * Format (.doc) Specification, page 36 of 210 - * - * @author Ryan Ackley */ @Internal public final class StyleSheet { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SubdocumentType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SubdocumentType.java index 89d16d2e02..299f8bd8d2 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SubdocumentType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/SubdocumentType.java @@ -20,8 +20,6 @@ import org.apache.poi.util.Internal; /** * Document text parts that can have text pieces (CPs) - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Internal public enum SubdocumentType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/TextPieceTable.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/TextPieceTable.java index cd885b9556..22434de9a2 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/TextPieceTable.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/TextPieceTable.java @@ -38,8 +38,6 @@ import static org.apache.logging.log4j.util.Unbox.box; * The piece table for matching up character positions to bits of text. This * mostly works in bytes, but the TextPieces themselves work in characters. This * does the icky convertion. - * - * @author Ryan Ackley */ @Internal public class TextPieceTable implements CharIndexTranslator { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Xst.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Xst.java index 769786afb8..e68d1bcccf 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Xst.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/Xst.java @@ -24,13 +24,7 @@ import org.apache.poi.util.LittleEndian; import org.apache.poi.util.LittleEndianConsts; /** - * The Xst structure is a string. The string is prepended by its length and is - * not null-terminated. - * <p> - * Documentation quoted from Page 424 of 621. [MS-DOC] -- v20110315 Word (.doc) - * Binary File Format - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) + * The Xst structure is a string. The string is prepended by its length and is not null-terminated. */ public class Xst { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/DOPAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/DOPAbstractType.java index 6ba7a30183..2a92d94fa7 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/DOPAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/DOPAbstractType.java @@ -26,10 +26,6 @@ import org.apache.poi.util.LittleEndian; /** * Document Properties. - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/records/definitions. - * - * @author S. Ryan Ackley */ @Internal public abstract class DOPAbstractType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FFDataBaseAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FFDataBaseAbstractType.java index 33557615f6..2e8efdd50c 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FFDataBaseAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FFDataBaseAbstractType.java @@ -25,23 +25,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The FFData structure specifies form field data for a text - box, check box, or drop-down list box. <p>Class and fields - descriptions are quoted from [MS-DOC] -- v20121003 Word (.doc) Binary - File Format; Copyright (c) 2012 Microsoft Corporation; Release: - October 8, 2012 - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to [MS-DOC] -- v20121003 Word - (.doc) Binary File Format; Copyright (c) 2012 Microsoft Corporation; - Release: October 8, 2012 - + * The FFData structure specifies form field data for a text box, check box, or drop-down list box. */ @Internal public abstract class FFDataBaseAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FLDAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FLDAbstractType.java index 3da59198d9..7be124641a 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FLDAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FLDAbstractType.java @@ -22,15 +22,6 @@ import org.apache.poi.util.Internal; /** * Field Descriptor (FLD). - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format - * - * NOTE: This source is automatically generated please do not modify this file. - * Either subclass or remove the record in src/records/definitions. - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] */ @Internal public abstract class FLDAbstractType @@ -137,7 +128,7 @@ public abstract class FLDAbstractType /** * Type of field boundary the FLD describes: 19 -- field begin mark, 20 -- * field separation mark; 21 -- field end mark - * + * * @return the ch field value. */ public byte getCh() @@ -157,7 +148,7 @@ public abstract class FLDAbstractType /** * Reserved - * + * * @return the reserved field value. */ public byte getReserved() @@ -177,7 +168,7 @@ public abstract class FLDAbstractType /** * Ignored for saved file - * + * * @return the fDiffer field value. */ public boolean isFDiffer() @@ -198,7 +189,7 @@ public abstract class FLDAbstractType /** * ==1 when result still believes this field is an EMBED or LINK field - * + * * @return the fZombieEmbed field value. */ public boolean isFZombieEmbed() @@ -219,7 +210,7 @@ public abstract class FLDAbstractType /** * ==1 when user has edited or formatted the result. == 0 otherwise - * + * * @return the fResultDirty field value. */ public boolean isFResultDirty() @@ -240,7 +231,7 @@ public abstract class FLDAbstractType /** * ==1 when user has inserted text into or deleted text from the result - * + * * @return the fResultEdited field value. */ public boolean isFResultEdited() @@ -260,7 +251,7 @@ public abstract class FLDAbstractType /** * ==1 when field is locked from recalculation - * + * * @return the fLocked field value. */ public boolean isFLocked() @@ -281,7 +272,7 @@ public abstract class FLDAbstractType /** * ==1 whenever the result of the field is never to be shown - * + * * @return the fPrivateResult field value. */ public boolean isFPrivateResult() @@ -302,7 +293,7 @@ public abstract class FLDAbstractType /** * ==1 when field is nested within another field - * + * * @return the fNested field value. */ public boolean isFNested() @@ -322,7 +313,7 @@ public abstract class FLDAbstractType /** * ==1 when field has a field separator - * + * * @return the fHasSep field value. */ public boolean isFHasSep() diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FSPAAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FSPAAbstractType.java index 8d7df40e36..197c16cd19 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FSPAAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FSPAAbstractType.java @@ -23,19 +23,6 @@ import org.apache.poi.util.LittleEndian; /** * File Shape Address (FSPA). - * <p> - * Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - * Binary File Format - * - * <p> - * NOTE: This source is automatically generated please do not modify this file. - * Either subclass or remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - * - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - * File Format Specification [*.doc] */ @Internal public abstract class FSPAAbstractType @@ -370,7 +357,7 @@ public abstract class FSPAAbstractType /** * Sets the fBelowText field value. - * + * */ @Internal public void setFBelowText( boolean value ) @@ -379,7 +366,7 @@ public abstract class FSPAAbstractType } /** - * + * * @return the fBelowText field value. */ @Internal @@ -390,7 +377,7 @@ public abstract class FSPAAbstractType /** * Sets the fAnchorLock field value. - * + * */ @Internal public void setFAnchorLock( boolean value ) @@ -399,7 +386,7 @@ public abstract class FSPAAbstractType } /** - * + * * @return the fAnchorLock field value. */ @Internal diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibBaseAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibBaseAbstractType.java index de588af3d9..65cf36d882 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibBaseAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibBaseAbstractType.java @@ -23,20 +23,7 @@ import org.apache.poi.util.LittleEndian; /** * Base part of the File information Block (FibBase). Holds the core part of the FIB, - from the first 32 bytes. <p>Class and fields descriptions are quoted from Microsoft - Office Word 97-2007 Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File - Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Andrew C. Oliver; Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary - File Format Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * from the first 32 bytes. */ @Internal public abstract class FibBaseAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw95AbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw95AbstractType.java index 45b97641d5..2d5be567f9 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw95AbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw95AbstractType.java @@ -25,16 +25,6 @@ import org.apache.poi.util.LittleEndian; /** * The FibRgLw95 structure is the third section of the FIB for Word95. - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov - */ @Internal public abstract class FibRgLw95AbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw97AbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw97AbstractType.java index 48bfcebfd6..024569129b 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw97AbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgLw97AbstractType.java @@ -23,19 +23,7 @@ import org.apache.poi.util.LittleEndian; /** * The FibRgLw97 structure is the third section of the FIB. This contains an array of - 4-byte values. <p>Class and fields descriptions are quoted from Microsoft Office Word - 97-2007 Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * 4-byte values. */ @Internal public abstract class FibRgLw97AbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgW97AbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgW97AbstractType.java index 21d2e4ae13..d7aa92551e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgW97AbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/FibRgW97AbstractType.java @@ -21,20 +21,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The FibRgW97 structure is a variable-length portion of the Fib. <p>Class and - fields descriptions are quoted from Microsoft Office Word 97-2007 Binary File Format and - [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * The FibRgW97 structure is a variable-length portion of the Fib. */ @Internal public abstract class FibRgW97AbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/GrfhicAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/GrfhicAbstractType.java index ac54a45f20..e968f971fc 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/GrfhicAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/GrfhicAbstractType.java @@ -25,21 +25,8 @@ import org.apache.poi.util.Internal; /** * The grfhic structure is a set of HTML incompatibility flags that specify the HTML - incompatibilities of a list structure. The values specify possible incompatibilities between - an LVL or LVLF and HTML lists. The values do not define list properties. <p>Class and - fields descriptions are quoted from [MS-DOC] -- v20110315 Word (.doc) Binary File Format - specification - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to [MS-DOC] -- v20110315 Word (.doc) Binary File Format - specification - + * incompatibilities of a list structure. The values specify possible incompatibilities between + * an LVL or LVLF and HTML lists. The values do not define list properties. */ @Internal public abstract class GrfhicAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOAbstractType.java index 7f37e95a27..fe5b723330 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOAbstractType.java @@ -23,19 +23,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * List Format Override (LFO). <p>Class and fields descriptions are quoted from - [MS-DOC] --v20110315; Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to [MS-DOC] --v20110315; Word (.doc) Binary File Format; - Copyright (c) Microsoft Corporation - + * List Format Override (LFO). */ @Internal public abstract class LFOAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOLVLBaseAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOLVLBaseAbstractType.java index 81bc72a117..d67798efdb 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOLVLBaseAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LFOLVLBaseAbstractType.java @@ -23,21 +23,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The LFOLVL structure contains information that is used to override the formatting - information of a corresponding LVL. <p>Class and fields descriptions are quoted from - Microsoft Office Word 97-2007 Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary - File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * The LFOLVL structure contains information that is used to override the formatting information of a corresponding LVL. */ @Internal public abstract class LFOLVLBaseAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LSTFAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LSTFAbstractType.java index 2565e1e306..310ea09c6b 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LSTFAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LSTFAbstractType.java @@ -25,19 +25,6 @@ import org.apache.poi.util.LittleEndian; /** * The LSTF structure contains formatting properties that apply to an entire list. - <p>Class and fields descriptions are quoted from Microsoft Office Word 97-2007 Binary - File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - */ @Internal public abstract class LSTFAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LVLFAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LVLFAbstractType.java index 79ade79b26..3e73e35c39 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LVLFAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/LVLFAbstractType.java @@ -25,20 +25,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The LVLF structure contains formatting properties for an individual level in a - list. <p>Class and fields descriptions are quoted from Microsoft Office Word 97-2007 - Binary File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * The LVLF structure contains formatting properties for an individual level in a list. */ @Internal public abstract class LVLFAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/PICFAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/PICFAbstractType.java index 22d4b22dbe..4b3b47ca47 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/PICFAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/PICFAbstractType.java @@ -26,21 +26,7 @@ import org.apache.poi.util.LittleEndian; /** * The PICF structure specifies the type of a picture, as well as the size of the - picture and information about its border. <p>Class and fields descriptions are quoted - from Microsoft Office Word 97-2007 - Binary File Format and [MS-DOC] - v20110608 Word (.doc) - Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * picture and information about its border. */ @Internal public abstract class PICFAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfBaseAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfBaseAbstractType.java index 8282e38933..e9d2a3b483 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfBaseAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfBaseAbstractType.java @@ -22,20 +22,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The StdfBase structure specifies general information about a style. <p>Class - and fields descriptions are quoted from Microsoft Office Word 97-2007 Binary File Format and - [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * The StdfBase structure specifies general information about a style. */ @Internal public abstract class StdfBaseAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfPost2000AbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfPost2000AbstractType.java index 26e5fd68fc..e470e3fbfc 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfPost2000AbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StdfPost2000AbstractType.java @@ -22,19 +22,6 @@ import org.apache.poi.util.LittleEndian; /** * The StdfPost2000 structure specifies general information about a style. - <p>Class and fields descriptions are quoted from Microsoft Office Word 97-2007 Binary - File Format and [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - */ @Internal public abstract class StdfPost2000AbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StshifAbstractType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StshifAbstractType.java index 5b72d2e5c8..448c7f3cdc 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StshifAbstractType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/types/StshifAbstractType.java @@ -22,20 +22,7 @@ import org.apache.poi.util.Internal; import org.apache.poi.util.LittleEndian; /** - * The Stshif structure specifies general stylesheet information. <p>Class and - fields descriptions are quoted from Microsoft Office Word 97-2007 Binary File Format and - [MS-DOC] - v20110608 Word (.doc) Binary File Format - - * <p> - * NOTE: This source is automatically generated please do not modify this file. Either subclass or - * remove the record in src/types/definitions. - * <p> - * This class is internal. It content or properties may change without notice - * due to changes in our knowledge of internal Microsoft Word binary structures. - - * @author Sergey Vladimirov; according to Microsoft Office Word 97-2007 Binary File Format - Specification [*.doc] and [MS-DOC] - v20110608 Word (.doc) Binary File Format - + * The Stshif structure specifies general stylesheet information. */ @Internal public abstract class StshifAbstractType diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/sprm/SprmIterator.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/sprm/SprmIterator.java index dd4ba7962f..9d497acc61 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/sprm/SprmIterator.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/sprm/SprmIterator.java @@ -22,7 +22,6 @@ import org.apache.poi.util.Internal; /** * This class is used to iterate through a list of sprms from a Word 97/2000/XP * document. - * @author Ryan Ackley * @version 1.0 */ @Internal diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmark.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmark.java index 1836d8906c..4102bff294 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmark.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmark.java @@ -18,8 +18,6 @@ package org.apache.poi.hwpf.usermodel; /** * User friendly interface to access information about document bookmarks - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) */ public interface Bookmark { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmarks.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmarks.java index c4dae5e9db..912d660719 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmarks.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Bookmarks.java @@ -21,8 +21,6 @@ import java.util.Map; /** * User-friendly interface to access document bookmarks - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public interface Bookmarks { @@ -50,7 +48,7 @@ public interface Bookmarks /** * Remove bookmark from document (but not the bookmark text) - * + * * @param index * bookmark document index to be removed */ diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/BookmarksImpl.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/BookmarksImpl.java index 7c9d7ad9d7..3905598ae5 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/BookmarksImpl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/BookmarksImpl.java @@ -32,8 +32,6 @@ import org.apache.poi.hwpf.model.PropertyNode; /** * Implementation of user-friendly interface for document bookmarks - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) */ public class BookmarksImpl implements Bookmarks { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldImpl.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldImpl.java index 37131c3e15..73d3dd1d0e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldImpl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldImpl.java @@ -20,11 +20,6 @@ import org.apache.poi.hwpf.model.FieldDescriptor; import org.apache.poi.hwpf.model.PlexOfField; import org.apache.poi.util.Internal; -/** - * TODO: document me - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) - */ @Internal class FieldImpl implements Field { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Fields.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Fields.java index 2db551e5e2..8c26361e49 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Fields.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Fields.java @@ -22,8 +22,6 @@ import org.apache.poi.hwpf.model.FieldsDocumentPart; /** * User-friendly interface to access document {@link Field}s - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public interface Fields { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldsImpl.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldsImpl.java index b57d70ebd7..e826562516 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldsImpl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/FieldsImpl.java @@ -33,8 +33,6 @@ import org.apache.poi.util.Internal; /** * Default implementation of {@link Field} - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ @Internal public class FieldsImpl implements Fields diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/HWPFList.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/HWPFList.java index 2f100bb658..8a2d6d1ba4 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/HWPFList.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/HWPFList.java @@ -35,16 +35,14 @@ import org.apache.poi.hwpf.sprm.ParagraphSprmCompressor; * conjunction with * {@link org.apache.poi.hwpf.HWPFDocument#registerList(HWPFList) registerList} * in {@link org.apache.poi.hwpf.HWPFDocument HWPFDocument}. - * + * * In Word, lists are not ranged entities, meaning you can't actually add one to * the document. Lists only act as properties for list entries. Once you * register a list, you can add list entries to a document that are a part of * the list. - * + * * The only benefit of this that I see, is that you can add a list entry * anywhere in the document and continue numbering from the previous list. - * - * @author Ryan Ackley */ public final class HWPFList { @@ -56,7 +54,7 @@ public final class HWPFList private StyleSheet _styleSheet; /** - * + * * @param numbered * true if the list should be numbered; false if it should be * bulleted. @@ -197,7 +195,7 @@ public final class HWPFList /** * Sets the character properties of the list numbers. - * + * * @param level * the level number that the properties should apply to. * @param chp @@ -215,7 +213,7 @@ public final class HWPFList /** * Sets the paragraph properties for a particular level of the list. - * + * * @param level * The level number. * @param pap diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Notes.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Notes.java index 9e6cf567f3..536b83fc00 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Notes.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Notes.java @@ -18,8 +18,6 @@ package org.apache.poi.hwpf.usermodel; /** * User-friendly interface to access document notes information - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) */ public interface Notes { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/NotesImpl.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/NotesImpl.java index 16c8ada155..5af0a1e65f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/NotesImpl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/NotesImpl.java @@ -23,8 +23,6 @@ import org.apache.poi.hwpf.model.NotesTables; /** * Default implementation of {@link Notes} interface - * - * @author Sergey Vladimirov (vlsergey {at} gmail {doc} com) */ public class NotesImpl implements Notes { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawing.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawing.java index 4bed04e495..9c39de098a 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawing.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawing.java @@ -27,13 +27,11 @@ import org.apache.poi.ddf.EscherContainerRecord; * <li>[MS-ODRAW] -- v20110608; Office Drawing Binary File Format; Copyright (c) * 2011 Microsoft Corporation. * </ul> - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public interface OfficeDrawing { - public enum HorizontalPositioning { + enum HorizontalPositioning { /** * The shape is horizontally offset by an absolute distance from the @@ -72,11 +70,11 @@ public interface OfficeDrawing RIGHT } - public enum HorizontalRelativeElement { + enum HorizontalRelativeElement { CHAR, MARGIN, PAGE, TEXT } - public enum VerticalPositioning { + enum VerticalPositioning { /** * The shape is vertically offset by an absolute distance from the page @@ -112,34 +110,34 @@ public interface OfficeDrawing TOP } - public enum VerticalRelativeElement { + enum VerticalRelativeElement { LINE, MARGIN, PAGE, TEXT } /** * Returns the type of horizontal positioning to use for a shape - * + * * @return the type of horizontal positioning to use for a shape */ - public HorizontalPositioning getHorizontalPositioning(); + HorizontalPositioning getHorizontalPositioning(); /** * Specifies a page element relative to which a shape is horizontally * positioned - * + * * @return a page element relative to which a shape is horizontally * positioned */ - public HorizontalRelativeElement getHorizontalRelative(); + HorizontalRelativeElement getHorizontalRelative(); /** * Returns escher record that represent shape container (record type is - * <tt>0xF004</tt>). Returned record has a child with record type - * <tt>0xF00A</tt> and value of shape id equals to {@link #getShapeId()}. - * - * @return Returns office art shape container or <tt>null</tt> if not found + * {@code 0xF004}). Returned record has a child with record type + * {@code 0xF00A} and value of shape id equals to {@link #getShapeId()}. + * + * @return Returns office art shape container or {@code null} if not found */ - public EscherContainerRecord getOfficeArtSpContainer(); + EscherContainerRecord getOfficeArtSpContainer(); /** * Returns picture data if this shape has (single?) associated picture data @@ -174,17 +172,17 @@ public interface OfficeDrawing /** * Specifies the type of vertical positioning to use for a shape - * + * * @return return the type of vertical positioning to use for a shape */ - public VerticalPositioning getVerticalPositioning(); + VerticalPositioning getVerticalPositioning(); /** * Specifies a page element relative to which a shape is vertically * positioned - * + * * @return a page element relative to which a shape is vertically positioned */ - public VerticalRelativeElement getVerticalRelativeElement(); + VerticalRelativeElement getVerticalRelativeElement(); } diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawings.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawings.java index 58661aa8dd..f4ef4b950e 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawings.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawings.java @@ -20,8 +20,6 @@ import java.util.Collection; /** * User-friendly interface to access document part's office drawings - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public interface OfficeDrawings { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawingsImpl.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawingsImpl.java index ec5477725a..5fefa3478f 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawingsImpl.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/OfficeDrawingsImpl.java @@ -118,6 +118,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings { return new OfficeDrawing() { + @Override public HorizontalPositioning getHorizontalPositioning() { int value = getTertiaryPropertyValue(EscherPropertyTypes.GROUPSHAPE__POSH ); @@ -141,6 +142,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings return HorizontalPositioning.ABSOLUTE; } + @Override public HorizontalRelativeElement getHorizontalRelative() { int value = getTertiaryPropertyValue( EscherPropertyTypes.GROUPSHAPE__POSRELH ); @@ -160,11 +162,13 @@ public class OfficeDrawingsImpl implements OfficeDrawings return HorizontalRelativeElement.TEXT; } + @Override public EscherContainerRecord getOfficeArtSpContainer() { return getEscherShapeRecordContainer( getShapeId() ); } + @Override public byte[] getPictureData() { EscherContainerRecord shapeDescription = getEscherShapeRecordContainer( getShapeId() ); @@ -189,26 +193,31 @@ public class OfficeDrawingsImpl implements OfficeDrawings return escherBlipRecord.getPicturedata(); } + @Override public int getRectangleBottom() { return fspa.getYaBottom(); } + @Override public int getRectangleLeft() { return fspa.getXaLeft(); } + @Override public int getRectangleRight() { return fspa.getXaRight(); } + @Override public int getRectangleTop() { return fspa.getYaTop(); } + @Override public int getShapeId() { return fspa.getSpid(); @@ -230,6 +239,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings return ( escherProperty == null ) ? -1 : escherProperty.getPropertyValue(); } + @Override public VerticalPositioning getVerticalPositioning() { int value = getTertiaryPropertyValue( EscherPropertyTypes.GROUPSHAPE__POSV ); @@ -253,6 +263,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings return VerticalPositioning.ABSOLUTE; } + @Override public VerticalRelativeElement getVerticalRelativeElement() { int value = getTertiaryPropertyValue( EscherPropertyTypes.GROUPSHAPE__POSV ); @@ -280,6 +291,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings }; } + @Override public OfficeDrawing getOfficeDrawingAt( int characterPosition ) { final FSPA fspa = _fspaTable.getFspaFromCp( characterPosition ); @@ -289,6 +301,7 @@ public class OfficeDrawingsImpl implements OfficeDrawings return getOfficeDrawing( fspa ); } + @Override public Collection<OfficeDrawing> getOfficeDrawings() { List<OfficeDrawing> result = new ArrayList<>(); diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Paragraph.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Paragraph.java index 0447624336..d328baccea 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Paragraph.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Paragraph.java @@ -195,8 +195,8 @@ public class Paragraph extends Range implements Duplicatable { } /** - * @return <tt>true</tt>, if table trailer paragraph (last in table row), - * <tt>false</tt> otherwise + * @return {@code true}, if table trailer paragraph (last in table row), + * {@code false} otherwise */ public boolean isTableRowEnd() { @@ -209,8 +209,8 @@ public class Paragraph extends Range implements Duplicatable { } /** - * @return <tt>true</tt>, if the end of paragraph mark is really an end of - * cell mark for a nested table cell, <tt>false</tt> otherwise + * @return {@code true}, if the end of paragraph mark is really an end of + * cell mark for a nested table cell, {@code false} otherwise */ public boolean isEmbeddedCellMark() { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/PictureType.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/PictureType.java index e630925dcd..e1d5753f7d 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/PictureType.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/PictureType.java @@ -18,8 +18,6 @@ package org.apache.poi.hwpf.usermodel; /** * Picture types supported by MS Word format - * - * @author Sergey Vladimirov (vlsergey {at} gmail {dot} com) */ public enum PictureType { diff --git a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Range.java b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Range.java index 0b6cbcb644..ec37019226 100644 --- a/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Range.java +++ b/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/Range.java @@ -626,7 +626,7 @@ public class Range { * @param newText * The text to be replaced with * @param addAfter - * if <tt>true</tt> the text will be added at the end of current + * if {@code true} the text will be added at the end of current * range, otherwise to the beginning */ public void replaceText( String newText, boolean addAfter ) @@ -657,7 +657,7 @@ public class Range { * The replacement text (e.g., "Apache Software Foundation") * @param pOffset * The offset or index where the text to be replaced begins - * (relative to/within this <code>Range</code>) + * (relative to/within this {@code Range}) */ @Internal public void replaceText(String pPlaceHolder, String pValue, int pOffset) { @@ -1056,7 +1056,7 @@ public class Range { /** * Adjust the value of the various FIB character count fields, eg - * <code>FIB.CCPText</code> after an insert or a delete... + * {@code FIB.CCPText} after an insert or a delete... * * Works on all CCP fields from this range onwards * diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/HSLFTestDataSamples.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/HSLFTestDataSamples.java index 0ec92bb6a2..82b3a46091 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/HSLFTestDataSamples.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/HSLFTestDataSamples.java @@ -34,15 +34,15 @@ public class HSLFTestDataSamples { public static InputStream openSampleFileStream(String sampleFileName) { return _inst.openResourceAsStream(sampleFileName); } - + public static File getSampleFile(String sampleFileName) { return _inst.getFile(sampleFileName); } - + public static byte[] getTestDataFileContent(String fileName) { return _inst.readFile(fileName); } - + public static HSLFSlideShow getSlideShow(String fileName) throws IOException { try (InputStream is = openSampleFileStream(fileName)) { return new HSLFSlideShow(is); @@ -50,8 +50,8 @@ public class HSLFTestDataSamples { } /** - * Writes a slideshow to a <tt>ByteArrayOutputStream</tt> and reads it back - * from a <tt>ByteArrayInputStream</tt>.<p> + * Writes a slideshow to a {@code ByteArrayOutputStream} and reads it back + * from a {@code ByteArrayInputStream}.<p> * Useful for verifying that the serialisation round trip */ public static HSLFSlideShowImpl writeOutAndReadBack(HSLFSlideShowImpl original) { @@ -66,8 +66,8 @@ public class HSLFTestDataSamples { } /** - * Writes a slideshow to a <tt>ByteArrayOutputStream</tt> and reads it back - * from a <tt>ByteArrayInputStream</tt>.<p> + * Writes a slideshow to a {@code ByteArrayOutputStream} and reads it back + * from a {@code ByteArrayInputStream}.<p> * Useful for verifying that the serialisation round trip */ public static HSLFSlideShow writeOutAndReadBack(HSLFSlideShow original) { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/TestReWriteSanity.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/TestReWriteSanity.java index 200966fd7a..3aca727bee 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/TestReWriteSanity.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/TestReWriteSanity.java @@ -40,8 +40,6 @@ import org.junit.jupiter.api.Test; /** * Tests that HSLFSlideShow writes the powerpoint bit of data back out * in a sane manner - i.e. records end up in the right place - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestReWriteSanity { // HSLFSlideShow primed on the test data diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestFreeform.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestFreeform.java index 8016278617..f4cadff6cc 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestFreeform.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestFreeform.java @@ -33,8 +33,6 @@ import org.junit.jupiter.api.Test; * The Freeform shape is constructed from java.awt.GeneralPath. * Check that the get/set path accessors are consistent. * (TODO: verification of Bezier curves is more difficult due to rounding error. Figure out a test approach for that) - * - * @author Yegor Kozlov */ public final class TestFreeform { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSetBoldItalic.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSetBoldItalic.java index 9ab28fa66c..e47467c2ba 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSetBoldItalic.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSetBoldItalic.java @@ -27,8 +27,6 @@ import org.junit.jupiter.api.Test; /** * Test setting text properties of newly added TextBoxes - * - * @author Yegor Kozlov */ public final class TestSetBoldItalic { /** diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSheet.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSheet.java index 50fada2805..b640b4f48d 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSheet.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSheet.java @@ -30,10 +30,8 @@ import org.apache.poi.hslf.usermodel.*; import org.junit.jupiter.api.Test; /** - * Test common functionality of the <code>Sheet</code> object. + * Test common functionality of the {@code Sheet} object. * For each ppt in the test directory check that all sheets are properly initialized - * - * @author Yegor Kozlov */ public final class TestSheet { private static final POIDataSamples _slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlideChangeNotes.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlideChangeNotes.java index 7557a8bc17..6d8aaaac6a 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlideChangeNotes.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlideChangeNotes.java @@ -28,8 +28,6 @@ import org.junit.jupiter.api.Test; /** * Tests that changing a slide's idea of what notes sheet is its works right - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestSlideChangeNotes { // SlideShow primed on the test data diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlides.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlides.java index c539a09b03..31713bae88 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlides.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/model/TestSlides.java @@ -30,9 +30,7 @@ import org.junit.jupiter.api.Test; /** * Test adding new slides to a ppt. * - * Note - uses the same empty PPT file as the core "new Slideshow" - * stuff does - * @author Yegor Kozlov + * Note - uses the same empty PPT file as the core "new Slideshow" stuff does */ public final class TestSlides { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000.java index 19a12a95a2..f518b9ffee 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000.java @@ -35,8 +35,6 @@ import org.junit.jupiter.api.Test; /** * Tests that Comment2000 works properly. * TODO: Test Comment200Atom within - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestComment2000 { // From a real file diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000Atom.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000Atom.java index 0568afaef5..59660e4947 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000Atom.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestComment2000Atom.java @@ -31,8 +31,6 @@ import org.junit.jupiter.api.Test; /** * Tests that Comment2000Atom works properly. - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestComment2000Atom { // From a real file diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestCurrentUserAtom.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestCurrentUserAtom.java index 030b954d3c..138e127024 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestCurrentUserAtom.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestCurrentUserAtom.java @@ -33,8 +33,6 @@ import org.junit.jupiter.api.Test; /** * Tests that CurrentUserAtom works properly. - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestCurrentUserAtom { private static final POIDataSamples _slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestDocumentEncryptionAtom.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestDocumentEncryptionAtom.java index ac837fc582..c33507c404 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestDocumentEncryptionAtom.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestDocumentEncryptionAtom.java @@ -26,8 +26,6 @@ import org.junit.jupiter.api.Test; /** * Tests that DocumentEncryptionAtom works properly. - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestDocumentEncryptionAtom { // From a real file diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestExVideoContainer.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestExVideoContainer.java index 2534fddd18..3933965ac2 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestExVideoContainer.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestExVideoContainer.java @@ -29,8 +29,6 @@ import org.junit.jupiter.api.Test; /** * Tests that {@link HeadersFootersAtom} works properly - * - * @author Yegor Kozlov */ public final class TestExVideoContainer { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestStyleTextPropAtom.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestStyleTextPropAtom.java index 887814ab43..3de5c8d131 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestStyleTextPropAtom.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestStyleTextPropAtom.java @@ -39,8 +39,6 @@ import org.junit.jupiter.api.Test; /** * Tests that StyleTextPropAtom works properly - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestStyleTextPropAtom { /** From a real file: a paragraph with 4 different styles */ diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestTextSpecInfoAtom.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestTextSpecInfoAtom.java index 578c6eef89..77ded7d795 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestTextSpecInfoAtom.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/record/TestTextSpecInfoAtom.java @@ -26,8 +26,6 @@ import org.junit.jupiter.api.Test; /** * Tests TextSpecInfoAtom - * - * @author Yegor Kozlov */ public final class TestTextSpecInfoAtom { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestBackground.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestBackground.java index 38bc03bb28..cc3abf76e8 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestBackground.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestBackground.java @@ -39,9 +39,7 @@ import org.junit.jupiter.api.Test; /** - * Test <code>Fill</code> object. - * - * @author Yegor Kozlov + * Test {@code Fill} object. */ public final class TestBackground { private static POIDataSamples _slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList.java index 6591a13ac7..e39ef463f9 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList.java @@ -39,8 +39,6 @@ import org.junit.jupiter.api.Test; /** * Test that checks numbered list functionality. - * - * @author Alex Nikiforov [mailto:anikif@gmail.com] */ public final class TestNumberedList { private static POIDataSamples _slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList3.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList3.java index 6aa90ff6d9..6475d51b5d 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList3.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestNumberedList3.java @@ -43,8 +43,6 @@ import org.junit.jupiter.api.Test; * if a paragraph has autonumber () * @see <a href="http://social.msdn.microsoft.com/Forums/mr-IN/os_binaryfile/thread/650888db-fabd-4b95-88dc-f0455f6e2d28"> * PPT: Missing TextAutoNumberScheme structure providing the style of the number bullets</a> - * - * @author Alex Nikiforov [mailto:anikif@gmail.com] */ public final class TestNumberedList3 { private static final POIDataSamples _slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestPictures.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestPictures.java index a196ed685b..5e50aa9c1f 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestPictures.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestPictures.java @@ -53,8 +53,6 @@ import org.junit.jupiter.api.Test; /** * Test adding/reading pictures - * - * @author Yegor Kozlov */ public final class TestPictures { private static final POIDataSamples slTests = POIDataSamples.getSlideShowInstance(); diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestRecordSetup.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestRecordSetup.java index 0eba4ae56e..962cc7e4d4 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestRecordSetup.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/usermodel/TestRecordSetup.java @@ -28,8 +28,6 @@ import org.junit.jupiter.api.Test; * Tests that the record setup done by SlideShow * has worked correctly * Note: most recent record stuff has its own test - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestRecordSetup { // SlideShow primed on the test data diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hslf/util/TestSystemTimeUtils.java b/poi-scratchpad/src/test/java/org/apache/poi/hslf/util/TestSystemTimeUtils.java index 6572ade892..ba67d2170f 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hslf/util/TestSystemTimeUtils.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hslf/util/TestSystemTimeUtils.java @@ -30,8 +30,6 @@ import org.junit.jupiter.api.Test; /** * Tests that SystemTimeUtils works properly. - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestSystemTimeUtils { // From real files diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hwpf/HWPFTestDataSamples.java b/poi-scratchpad/src/test/java/org/apache/poi/hwpf/HWPFTestDataSamples.java index 142ad026e4..b8f11dc40f 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hwpf/HWPFTestDataSamples.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hwpf/HWPFTestDataSamples.java @@ -93,8 +93,8 @@ public class HWPFTestDataSamples { } } /** - * Writes a spreadsheet to a <tt>ByteArrayOutputStream</tt> and reads it back - * from a <tt>ByteArrayInputStream</tt>.<p> + * Writes a spreadsheet to a {@code ByteArrayOutputStream} and reads it back + * from a {@code ByteArrayInputStream}.<p> * Useful for verifying that the serialisation round trip */ public static HWPFDocument writeOutAndReadBack(HWPFDocument original) { diff --git a/poi-scratchpad/src/test/java/org/apache/poi/hwpf/extractor/TestDifferentRoutes.java b/poi-scratchpad/src/test/java/org/apache/poi/hwpf/extractor/TestDifferentRoutes.java index 1574c3410a..331085ae4a 100644 --- a/poi-scratchpad/src/test/java/org/apache/poi/hwpf/extractor/TestDifferentRoutes.java +++ b/poi-scratchpad/src/test/java/org/apache/poi/hwpf/extractor/TestDifferentRoutes.java @@ -33,8 +33,6 @@ import org.junit.jupiter.api.Test; /** * Test the different routes to extracting text - * - * @author Nick Burch (nick at torchbox dot com) */ public final class TestDifferentRoutes { private static final String[] p_text = new String[] { |