Changeset 34151 in osm for applications/editors/josm


Ignore:
Timestamp:
2018-04-08T15:09:55+02:00 (7 years ago)
Author:
donvip
Message:

fix javadoc warnings

Location:
applications/editors/josm/plugins/opendata
Files:
37 edited

Legend:

Unmodified
Added
Removed
  • applications/editors/josm/plugins/opendata/.settings/org.eclipse.jdt.core.prefs

    r33518 r34151  
    1717org.eclipse.jdt.core.compiler.debug.localVariable=generate
    1818org.eclipse.jdt.core.compiler.debug.sourceFile=generate
     19org.eclipse.jdt.core.compiler.doc.comment.support=enabled
    1920org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
    2021org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
     
    4041org.eclipse.jdt.core.compiler.problem.incompleteEnumSwitch=ignore
    4142org.eclipse.jdt.core.compiler.problem.indirectStaticAccess=ignore
     43org.eclipse.jdt.core.compiler.problem.invalidJavadoc=warning
     44org.eclipse.jdt.core.compiler.problem.invalidJavadocTags=enabled
     45org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsDeprecatedRef=enabled
     46org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsNotVisibleRef=enabled
     47org.eclipse.jdt.core.compiler.problem.invalidJavadocTagsVisibility=public
    4248org.eclipse.jdt.core.compiler.problem.localVariableHiding=ignore
    4349org.eclipse.jdt.core.compiler.problem.methodWithConstructorName=warning
     
    4652org.eclipse.jdt.core.compiler.problem.missingEnumCaseDespiteDefault=disabled
    4753org.eclipse.jdt.core.compiler.problem.missingHashCodeMethod=ignore
     54org.eclipse.jdt.core.compiler.problem.missingJavadocComments=ignore
     55org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsOverriding=disabled
     56org.eclipse.jdt.core.compiler.problem.missingJavadocCommentsVisibility=public
     57org.eclipse.jdt.core.compiler.problem.missingJavadocTagDescription=return_tag
     58org.eclipse.jdt.core.compiler.problem.missingJavadocTags=ignore
     59org.eclipse.jdt.core.compiler.problem.missingJavadocTagsMethodTypeParameters=disabled
     60org.eclipse.jdt.core.compiler.problem.missingJavadocTagsOverriding=disabled
     61org.eclipse.jdt.core.compiler.problem.missingJavadocTagsVisibility=public
    4862org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotation=ignore
    4963org.eclipse.jdt.core.compiler.problem.missingOverrideAnnotationForInterfaceMethodImplementation=enabled
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/MutableSection.java

    r30737 r34151  
    105105     * @param formatID The section's format ID
    106106     *
    107      * @see #setFormatID(byte[])
    108107     * @see Section#getFormatID
    109108     */
     
    142141     * @param value The property's value.
    143142     *
    144      * @see #setProperty(int, String)
    145143     * @see #getProperty
    146144     * @see Variant
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/NoFormatIDException.java

    r28000 r34151  
    2121 * <p>This exception is thrown if a {@link MutablePropertySet} is to be written
    2222 * but does not have a formatID set (see {@link
    23  * MutableSection#setFormatID(ClassID)} or
    24  * {@link org.apache.poi.hpsf.MutableSection#setFormatID(byte[])}.
     23 * MutableSection#setFormatID(ClassID)}.
    2524 *
    2625 * @author Rainer Klute <a
    2726 * href="mailto:klute@rainer-klute.de">&lt;klute@rainer-klute.de&gt;</a>
    2827 */
    29 @SuppressWarnings("serial")
    3028public class NoFormatIDException extends HPSFRuntimeException
    3129{
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/PropertySet.java

    r30737 r34151  
    3838 *
    3939 * <p>{@link PropertySetFactory#create} does its work by calling one
    40  * of the constructors {@link PropertySet#PropertySet(InputStream)} or
    41  * {@link PropertySet#PropertySet(byte[])}. If the constructor's
     40 * of the constructor {@link PropertySet#PropertySet(InputStream)}.
     41 * If the constructor's
    4242 * argument is not in the Horrible Property Set Format, i.e. not a
    4343 * property set stream, or if any other error occurs, an appropriate
     
    111111
    112112
    113  
     113
    114114    /**
    115115     * <p>Specifies the version of the operating system that created
     
    352352    {
    353353        /* FIXME (3): Ensure that at most "length" bytes are read. */
    354        
     354
    355355        /*
    356356         * Read the stream's header fields.
     
    552552     *
    553553     * @param o the object to compare this <code>PropertySet</code> with
    554      * 
     554     *
    555555     * @return <code>true</code> if the objects are equal, <code>false</code>
    556556     * if not
    557557     */
     558    @Override
    558559    public boolean equals(final Object o)
    559560    {
     
    587588     * @see Object#hashCode()
    588589     */
     590    @Override
    589591    public int hashCode()
    590592    {
     
    597599     * @see Object#toString()
    598600     */
     601    @Override
    599602    public String toString()
    600603    {
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/Section.java

    r30737 r34151  
    341341     * <p>Returns the value of the property with the specified ID. If
    342342     * the property is not available, <code>null</code> is returned
    343      * and a subsequent call to {@link #wasNull} will return
     343     * and a subsequent call to {@code #wasNull} will return
    344344     * <code>true</code>.</p>
    345345     *
     
    422422     * was available or not. This information might be important for
    423423     * callers of {@link #getPropertyIntValue} since the latter
    424      * returns 0 if the property does not exist. Using {@link
     424     * returns 0 if the property does not exist. Using {@code
    425425     * #wasNull} the caller can distiguish this case from a property's
    426426     * real value of 0.</p>
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/SpecialPropertySet.java

    r28000 r34151  
    8585     * @see PropertySet#getByteOrder
    8686     */
     87    @Override
    8788    public int getByteOrder()
    8889    {
     
    9596     * @see PropertySet#getFormat
    9697     */
     98    @Override
    9799    public int getFormat()
    98100    {
     
    105107     * @see PropertySet#getOSVersion
    106108     */
     109    @Override
    107110    public int getOSVersion()
    108111    {
     
    115118     * @see PropertySet#getClassID
    116119     */
     120    @Override
    117121    public ClassID getClassID()
    118122    {
     
    125129     * @see PropertySet#getSectionCount
    126130     */
     131    @Override
    127132    public int getSectionCount()
    128133    {
     
    135140     * @see PropertySet#getSections
    136141     */
     142    @Override
    137143    public List<Section> getSections()
    138144    {
     
    145151     * @see PropertySet#isSummaryInformation
    146152     */
     153    @Override
    147154    public boolean isSummaryInformation()
    148155    {
     
    155162     * @see PropertySet#isDocumentSummaryInformation
    156163     */
     164    @Override
    157165    public boolean isDocumentSummaryInformation()
    158166    {
     
    163171
    164172    /**
    165      * @see PropertySet#getSingleSection
    166      */
     173     * @see PropertySet
     174     */
     175    @Override
    167176    public Section getFirstSection()
    168177    {
     
    174183     * @see org.apache.poi.hpsf.MutablePropertySet#addSection(org.apache.poi.hpsf.Section)
    175184     */
     185    @Override
    176186    public void addSection(final Section section)
    177187    {
     
    184194     * @see org.apache.poi.hpsf.MutablePropertySet#clearSections()
    185195     */
     196    @Override
    186197    public void clearSections()
    187198    {
     
    194205     * @see org.apache.poi.hpsf.MutablePropertySet#setByteOrder(int)
    195206     */
     207    @Override
    196208    public void setByteOrder(final int byteOrder)
    197209    {
     
    204216     * @see org.apache.poi.hpsf.MutablePropertySet#setClassID(org.apache.poi.hpsf.ClassID)
    205217     */
     218    @Override
    206219    public void setClassID(final ClassID classID)
    207220    {
     
    214227     * @see org.apache.poi.hpsf.MutablePropertySet#setFormat(int)
    215228     */
     229    @Override
    216230    public void setFormat(final int format)
    217231    {
     
    224238     * @see org.apache.poi.hpsf.MutablePropertySet#setOSVersion(int)
    225239     */
     240    @Override
    226241    public void setOSVersion(final int osVersion)
    227242    {
     
    234249     * @see org.apache.poi.hpsf.MutablePropertySet#toInputStream()
    235250     */
     251    @Override
    236252    public InputStream toInputStream() throws IOException, WritingNotSupportedException
    237253    {
     
    244260     * @see org.apache.poi.hpsf.MutablePropertySet#write(org.apache.poi.poifs.filesystem.DirectoryEntry, java.lang.String)
    245261     */
     262    @Override
    246263    public void write(final DirectoryEntry dir, final String name) throws WritingNotSupportedException, IOException
    247264    {
     
    254271     * @see org.apache.poi.hpsf.MutablePropertySet#write(java.io.OutputStream)
    255272     */
     273    @Override
    256274    public void write(final OutputStream out) throws WritingNotSupportedException, IOException
    257275    {
     
    264282     * @see org.apache.poi.hpsf.PropertySet#equals(java.lang.Object)
    265283     */
     284    @Override
    266285    public boolean equals(final Object o)
    267286    {
     
    274293     * @see org.apache.poi.hpsf.PropertySet#getProperties()
    275294     */
     295    @Override
    276296    public Property[] getProperties() throws NoSingleSectionException
    277297    {
     
    284304     * @see org.apache.poi.hpsf.PropertySet#getProperty(int)
    285305     */
     306    @Override
    286307    protected Object getProperty(final int id) throws NoSingleSectionException
    287308    {
     
    294315     * @see org.apache.poi.hpsf.PropertySet#getPropertyBooleanValue(int)
    295316     */
     317    @Override
    296318    protected boolean getPropertyBooleanValue(final int id) throws NoSingleSectionException
    297319    {
     
    304326     * @see org.apache.poi.hpsf.PropertySet#getPropertyIntValue(int)
    305327     */
     328    @Override
    306329    protected int getPropertyIntValue(final int id) throws NoSingleSectionException
    307330    {
     
    314337     * @see org.apache.poi.hpsf.PropertySet#hashCode()
    315338     */
     339    @Override
    316340    public int hashCode()
    317341    {
     
    324348     * @see org.apache.poi.hpsf.PropertySet#toString()
    325349     */
     350    @Override
    326351    public String toString()
    327352    {
     
    334359     * @see org.apache.poi.hpsf.PropertySet#wasNull()
    335360     */
     361    @Override
    336362    public boolean wasNull() throws NoSingleSectionException
    337363    {
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/model/HSSFFormulaParser.java

    r28000 r34151  
    2424
    2525/**
    26  * HSSF wrapper for the {@link FormulaParser} and {@link FormulaRenderer}
     26 * HSSF wrapper for the {@link FormulaRenderer}
    2727 *
    2828 * @author Josh Micich
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/model/InternalWorkbook.java

    r30737 r34151  
    315315     * use this function to add a Shared String Table to an existing sheet (say
    316316     * generated by a different java api) without an sst....
    317      * @see #createExtendedSST()
    318317     * @see org.apache.poi.hssf.record.SSTRecord
    319318     */
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/BOFRecord.java

    r28000 r34151  
    5555    public BOFRecord() {
    5656    }
    57    
     57
    5858    public BOFRecord(RecordInputStream in) { // NO_UCD
    5959        field_1_version  = in.readShort();
     
    7878    /**
    7979     * Version number - for BIFF8 should be 0x06
    80      * @see #VERSION
    8180     * @param version version to be set
    8281     */
     
    101100    /**
    102101     * build that wrote this file
    103      * @see #BUILD
    104102     * @param build build number to set
    105103     */
     
    110108    /**
    111109     * Year of the build that wrote this file
    112      * @see #BUILD_YEAR
    113110     * @param year build year to set
    114111     */
     
    119116    /**
    120117     * set the history bit mask (not very useful)
    121      * @see #HISTORY_MASK
    122118     * @param bitmask bitmask to set for the history
    123119     */
     
    129125     * set the minimum version required to read this file
    130126     *
    131      * @see #VERSION
    132127     * @param version version to set
    133128     */
     
    138133    /**
    139134     * Version number - for BIFF8 should be 0x06
    140      * @see #VERSION
    141135     * @return version number of the generator of this file
    142136     */
     
    161155    /**
    162156     * get the build that wrote this file
    163      * @see #BUILD
    164157     * @return short build number of the generator of this file
    165158     */
     
    170163    /**
    171164     * Year of the build that wrote this file
    172      * @see #BUILD_YEAR
    173165     * @return short build year of the generator of this file
    174166     */
     
    179171    /**
    180172     * get the history bit mask (not very useful)
    181      * @see #HISTORY_MASK
    182173     * @return int bitmask showing the history of the file (who cares!)
    183174     */
     
    189180     * get the minimum version required to read this file
    190181     *
    191      * @see #VERSION
    192182     * @return int least version that can read the file
    193183     */
     
    196186    }
    197187
     188    @Override
    198189    public String toString() {
    199190        StringBuffer buffer = new StringBuffer();
     
    223214    }
    224215
     216    @Override
    225217    public void serialize(LittleEndianOutput out) {
    226218        out.writeShort(getVersion());
     
    232224    }
    233225
     226    @Override
    234227    protected int getDataSize() {
    235228        return 16;
    236229    }
    237230
     231    @Override
    238232    public short getSid(){
    239233        return sid;
    240234    }
    241235
     236    @Override
    242237    public Object clone() {
    243238      BOFRecord rec = new BOFRecord();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/CalcModeRecord.java

    r28000 r34151  
    1616   limitations under the License.
    1717==================================================================== */
    18        
     18
    1919
    2020package org.apache.poi.hssf.record;
     
    5353     * set the calc mode flag for formulas
    5454     *
    55      * @see #MANUAL
    56      * @see #AUTOMATIC
    57      * @see #AUTOMATIC_EXCEPT_TABLES
    58      *
    5955     * @param calcmode one of the three flags above
    6056     */
     
    6864     * get the calc mode flag for formulas
    6965     *
    70      * @see #MANUAL
    71      * @see #AUTOMATIC
    72      * @see #AUTOMATIC_EXCEPT_TABLES
    73      *
    7466     * @return calcmode one of the three flags above
    7567     */
     
    8072    }
    8173
     74    @Override
    8275    public String toString()
    8376    {
     
    9184    }
    9285
     86    @Override
    9387    public void serialize(LittleEndianOutput out) {
    9488        out.writeShort(getCalcMode());
    9589    }
    9690
     91    @Override
    9792    protected int getDataSize() {
    9893        return 2;
    9994    }
    10095
     96    @Override
    10197    public short getSid()
    10298    {
     
    104100    }
    105101
     102    @Override
    106103    public Object clone() {
    107104      CalcModeRecord rec = new CalcModeRecord();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/DVRecord.java

    r28000 r34151  
    3737public final class DVRecord extends StandardRecord {
    3838        public final static short sid = 0x01BE;
    39        
     39
    4040        /** Option flags */
    4141        private int _option_flags;
     
    6161        /**
    6262         * Option flags field
    63          *
    64          * @see HSSFDataValidation utility class
    6563         */
    6664
     
    9290        }
    9391
    94         public String toString() {
     92        @Override
     93    public String toString() {
    9594                StringBuffer sb = new StringBuffer();
    9695                sb.append("[DV]\n");
     
    129128        private static void appendFormula(StringBuffer sb, String label, Formula f) {
    130129                sb.append(label);
    131                
     130
    132131                if (f == null) {
    133132                        sb.append("<empty>\n");
     
    141140        }
    142141
    143         public void serialize(LittleEndianOutput out) {
     142        @Override
     143    public void serialize(LittleEndianOutput out) {
    144144
    145145                out.writeInt(_option_flags);
    146                
     146
    147147                serializeUnicodeString(_promptTitle, out);
    148148                serializeUnicodeString(_errorTitle, out);
     
    152152                out.writeShort(_not_used_1);
    153153                _formula1.serializeTokens(out);
    154                
     154
    155155                out.writeShort(_formula2.getEncodedTokenSize());
    156156                out.writeShort(_not_used_2);
    157157                _formula2.serializeTokens(out);
    158                
     158
    159159                _regions.serialize(out);
    160160        }
     
    172172        }
    173173
    174         protected int getDataSize() {
     174        @Override
     175    protected int getDataSize() {
    175176                int size = 4+2+2+2+2;//options_field+first_formula_size+first_unused+sec_formula_size+sec+unused;
    176177                size += getUnicodeStringSize(_promptTitle);
     
    184185        }
    185186
    186         public short getSid() {
     187        @Override
     188    public short getSid() {
    187189                return sid;
    188190        }
    189        
     191
    190192        /**
    191193         * Clones the object. Uses serialisation, as the
    192194         *  contents are somewhat complex
    193195         */
    194         public Object clone() {
     196        @Override
     197    public Object clone() {
    195198                return cloneViaReserialise();
    196199        }
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/ExtendedFormatRecord.java

    r28000 r34151  
    1616   limitations under the License.
    1717==================================================================== */
    18        
     18
    1919
    2020package org.apache.poi.hssf.record;
     
    161161     *
    162162     * @return index to the font
    163      * @see org.apache.poi.hssf.record.FontRecord
    164163     */
    165164
     
    245244     *
    246245     * @return index of parent XF
    247      * @see #NULL
    248246     * @see #getCellOptions()
    249247     */
     
    276274     *
    277275     * @return align - how to align the cell (see constants)
    278      * @see #GENERAL
    279      * @see #LEFT
    280      * @see #CENTER
    281      * @see #RIGHT
    282      * @see #FILL
    283      * @see #JUSTIFY
    284      * @see #CENTER_SELECTION
    285276     * @see #getAlignmentOptions()
    286277     */
     
    309300     *
    310301     * @return where to align the text
    311      * @see #VERTICAL_TOP
    312      * @see #VERTICAL_CENTER
    313      * @see #VERTICAL_BOTTOM
    314      * @see #VERTICAL_JUSTIFY
    315302     *
    316303     * @see #getAlignmentOptions()
     
    526513     *
    527514     * @return border - type of border for the left side of the cell
    528      * @see     #NONE
    529      * @see     #THIN
    530      * @see     #MEDIUM
    531      * @see     #DASHED
    532      * @see     #DOTTED
    533      * @see     #THICK
    534      * @see     #DOUBLE
    535      * @see     #HAIR
    536      * @see     #MEDIUM_DASHED
    537      * @see     #DASH_DOT
    538      * @see     #MEDIUM_DASH_DOT
    539      * @see     #DASH_DOT_DOT
    540      * @see     #MEDIUM_DASH_DOT_DOT
    541      * @see     #SLANTED_DASH_DOT
    542515     * @see #getBorderOptions()
    543516     */
     
    553526     *
    554527     * @return  border - type of border for the right side of the cell
    555      * @see     #NONE
    556      * @see     #THIN
    557      * @see     #MEDIUM
    558      * @see     #DASHED
    559      * @see     #DOTTED
    560      * @see     #THICK
    561      * @see     #DOUBLE
    562      * @see     #HAIR
    563      * @see     #MEDIUM_DASHED
    564      * @see     #DASH_DOT
    565      * @see     #MEDIUM_DASH_DOT
    566      * @see     #DASH_DOT_DOT
    567      * @see     #MEDIUM_DASH_DOT_DOT
    568      * @see     #SLANTED_DASH_DOT
    569528     * @see #getBorderOptions()
    570529     */
     
    580539     *
    581540     * @return border - type of border for the top of the cell
    582      * @see     #NONE
    583      * @see     #THIN
    584      * @see     #MEDIUM
    585      * @see     #DASHED
    586      * @see     #DOTTED
    587      * @see     #THICK
    588      * @see     #DOUBLE
    589      * @see     #HAIR
    590      * @see     #MEDIUM_DASHED
    591      * @see     #DASH_DOT
    592      * @see     #MEDIUM_DASH_DOT
    593      * @see     #DASH_DOT_DOT
    594      * @see     #MEDIUM_DASH_DOT_DOT
    595      * @see     #SLANTED_DASH_DOT
    596541     * @see #getBorderOptions()
    597542     */
     
    607552     *
    608553     * @return border - type of border for the bottom of the cell
    609      * @see     #NONE
    610      * @see     #THIN
    611      * @see     #MEDIUM
    612      * @see     #DASHED
    613      * @see     #DOTTED
    614      * @see     #THICK
    615      * @see     #DOUBLE
    616      * @see     #HAIR
    617      * @see     #MEDIUM_DASHED
    618      * @see     #DASH_DOT
    619      * @see     #MEDIUM_DASH_DOT
    620      * @see     #DASH_DOT_DOT
    621      * @see     #MEDIUM_DASH_DOT_DOT
    622      * @see     #SLANTED_DASH_DOT
    623554     * @see #getBorderOptions()
    624555     */
     
    757688     *
    758689     * @return diag - the line style
    759      * @see     #NONE
    760      * @see     #THIN
    761      * @see     #MEDIUM
    762      * @see     #DASHED
    763      * @see     #DOTTED
    764      * @see     #THICK
    765      * @see     #DOUBLE
    766      * @see     #HAIR
    767      * @see     #MEDIUM_DASHED
    768      * @see     #DASH_DOT
    769      * @see     #MEDIUM_DASH_DOT
    770      * @see     #DASH_DOT_DOT
    771      * @see     #MEDIUM_DASH_DOT_DOT
    772      * @see     #SLANTED_DASH_DOT
    773690     * @see #getAdtlPaletteOptions()
    774691     */
     
    783700     * get the additional fill pattern
    784701     *
    785      * @see #NO_FILL
    786      * @see #SOLID_FILL
    787      * @see #FINE_DOTS
    788      * @see #ALT_BARS
    789      * @see #SPARSE_DOTS
    790      * @see #THICK_HORZ_BANDS
    791      * @see #THICK_VERT_BANDS
    792      * @see #THICK_BACKWARD_DIAG
    793      * @see #THICK_FORWARD_DIAG
    794      * @see #BIG_SPOTS
    795      * @see #BRICKS
    796      * @see #THIN_HORZ_BANDS
    797      * @see #THIN_VERT_BANDS
    798      * @see #THIN_BACKWARD_DIAG
    799      * @see #THIN_FORWARD_DIAG
    800      * @see #SQUARES
    801      * @see #DIAMONDS
    802      *
    803702     * @return fill - fill pattern??
    804703     * @see #getAdtlPaletteOptions()
     
    854753    }
    855754
     755    @Override
    856756    public String toString()
    857757    {
     
    961861    }
    962862
     863    @Override
    963864    public void serialize(LittleEndianOutput out) {
    964865        out.writeShort(getFontIndex());
     
    973874    }
    974875
     876    @Override
    975877    protected int getDataSize() {
    976878        return 20;
    977879    }
    978880
     881    @Override
    979882    public short getSid()
    980883    {
    981884        return sid;
    982885    }
    983    
    984 
    985         public int hashCode() {
     886
     887
     888        @Override
     889    public int hashCode() {
    986890                final int prime = 31;
    987891                int result = 1;
     
    1003907         *  that matter are embedded in the records
    1004908         */
    1005         public boolean equals(Object obj) {
     909        @Override
     910    public boolean equals(Object obj) {
    1006911                if (this == obj)
    1007912                        return true;
     
    1032937                return false;
    1033938        }
    1034    
    1035    
     939
     940
    1036941}
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/LabelRecord.java

    r28000 r34151  
    6868 * READ ONLY ACCESS... THIS IS FOR COMPATIBILITY ONLY...USE LABELSST! public
    6969 */
     70    @Override
    7071    public int getRow()
    7172    {
     
    7374    }
    7475
     76    @Override
    7577    public short getColumn()
    7678    {
     
    7880    }
    7981
     82    @Override
    8083    public short getXFIndex()
    8184    {
     
    9699     *
    97100     * @return the text string
    98      * @see #getStringLength()
    99101     */
    100102    public String getValue()
     
    106108     * THROWS A RUNTIME EXCEPTION..  USE LABELSSTRecords.  YOU HAVE NO REASON to use LABELRecord!!
    107109     */
     110    @Override
    108111    public int serialize(int offset, byte [] data) {
    109112        throw new RecordFormatException("Label Records are supported READ ONLY...convert to LabelSST");
    110113    }
     114    @Override
    111115    public int getRecordSize() {
    112116        throw new RecordFormatException("Label Records are supported READ ONLY...convert to LabelSST");
    113117    }
    114118
     119    @Override
    115120    public short getSid()
    116121    {
     
    118123    }
    119124
     125    @Override
    120126    public String toString()
    121127    {
     
    135141         * NO-OP!
    136142         */
     143    @Override
    137144    public void setColumn(short col)
    138145    {
     
    142149     * NO-OP!
    143150     */
     151    @Override
    144152    public void setRow(int row)
    145153    {
     
    149157     * no op!
    150158     */
     159    @Override
    151160    public void setXFIndex(short xf)
    152161    {
    153162    }
    154163
     164    @Override
    155165    public Object clone() {
    156166      LabelRecord rec = new LabelRecord();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/LbsDataSubRecord.java

    r28000 r34151  
    9292     * @param in the stream to read data from
    9393     * @param cbFContinued the seconf short in the record header
    94      * @param cmoOt the containing Obj's {@link CommonObjectDataSubRecord#field_1_objectType}
     94     * @param cmoOt the containing Obj's {@code CommonObjectDataSubRecord#field_1_objectType}
    9595     */
    9696    public LbsDataSubRecord(LittleEndianInput in, int cbFContinued, int cmoOt) {
     
    267267
    268268        /**
    269          *  An unsigned integer that specifies the style of this dropdown. 
     269         *  An unsigned integer that specifies the style of this dropdown.
    270270         */
    271271        private int _wStyle;
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordFactory.java

    r30737 r34151  
    3434 * Description:  Takes a stream and outputs an array of Record objects.<P>
    3535 *
    36  * @see org.apache.poi.hssf.eventmodel.EventRecordFactory
    3736 * @author Andrew C. Oliver (acoliver at apache dot org)
    3837 * @author Marc Johnson (mjohnson at apache dot org)
     
    5453                        _c = c;
    5554                }
    56                 public Record create(RecordInputStream in) {
     55                @Override
     56        public Record create(RecordInputStream in) {
    5757                        Object[] args = { in, };
    5858                        try {
     
    6868                        }
    6969                }
    70                 public Class<? extends Record> getRecordClass() {
     70                @Override
     71        public Class<? extends Record> getRecordClass() {
    7172                        return _c.getDeclaringClass();
    7273                }
     
    8283                        _m = m;
    8384                }
    84                 public Record create(RecordInputStream in) {
     85                @Override
     86        public Record create(RecordInputStream in) {
    8587                        Object[] args = { in, };
    8688                        try {
     
    9496                        }
    9597                }
    96                 @SuppressWarnings("unchecked")
     98                @Override
     99        @SuppressWarnings("unchecked")
    97100                public Class<? extends Record> getRecordClass() {
    98101                        return (Class<? extends Record>) _m.getDeclaringClass();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordFactoryInputStream.java

    r30737 r34151  
    2727 * the data into full records, processing continue records
    2828 * etc.
    29  * Most users should use {@link HSSFEventFactory} /
    30  * {@link HSSFListener} and have new records pushed to
    31  * them, but this does allow for a "pull" style of coding.
    3229 */
    3330public final class RecordFactoryInputStream {
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordInputStream.java

    r28000 r34151  
    4242
    4343        /**
    44          * For use in {@link BiffViewer} which may construct {@link Record}s that don't completely
     44         * For use in {@code BiffViewer} which may construct {@link Record}s that don't completely
    4545         * read all available data.  This exception should never be thrown otherwise.
    4646         */
    47         @SuppressWarnings("serial")
    4847        public static final class LeftoverDataException extends RuntimeException {
    4948                public LeftoverDataException(int sid, int remainingByteCount) {
     
    8584                        _lei = getLEI(in);
    8685                }
    87                 public int available() {
     86                @Override
     87        public int available() {
    8888                        return _lei.available();
    8989                }
    90                 public int readDataSize() {
     90                @Override
     91        public int readDataSize() {
    9192                        return _lei.readUShort();
    9293                }
    93                 public int readRecordSID() {
     94                @Override
     95        public int readRecordSID() {
    9496                        return _lei.readUShort();
    9597                }
     
    119121         * @see #remaining()
    120122         */
    121         public int available() {
     123        @Override
     124    public int available() {
    122125                return remaining();
    123126        }
     
    211214         * Reads an 8 bit, signed value
    212215         */
    213         public byte readByte() {
     216        @Override
     217    public byte readByte() {
    214218                checkRecordPosition(LittleEndian.BYTE_SIZE);
    215219                _currentDataOffset += LittleEndian.BYTE_SIZE;
     
    220224         * Reads a 16 bit, signed value
    221225         */
    222         public short readShort() {
     226        @Override
     227    public short readShort() {
    223228                checkRecordPosition(LittleEndian.SHORT_SIZE);
    224229                _currentDataOffset += LittleEndian.SHORT_SIZE;
     
    227232
    228233        /**
    229          * Reads a 32 bit, signed value
    230          */
    231         public int readInt() {
     234         * Reads a 32 bit, signed value
     235         */
     236        @Override
     237    public int readInt() {
    232238                checkRecordPosition(LittleEndian.INT_SIZE);
    233239                _currentDataOffset += LittleEndian.INT_SIZE;
     
    238244         * Reads a 64 bit, signed value
    239245         */
    240         public long readLong() {
     246        @Override
     247    public long readLong() {
    241248                checkRecordPosition(LittleEndian.LONG_SIZE);
    242249                _currentDataOffset += LittleEndian.LONG_SIZE;
     
    247254         * Reads an 8 bit, unsigned value
    248255         */
    249         public int readUByte() {
     256        @Override
     257    public int readUByte() {
    250258                return readByte() & 0x00FF;
    251259        }
     
    254262         * Reads a 16 bit, unsigned value.
    255263         */
    256         public int readUShort() {
     264        @Override
     265    public int readUShort() {
    257266                checkRecordPosition(LittleEndian.SHORT_SIZE);
    258267                _currentDataOffset += LittleEndian.SHORT_SIZE;
     
    260269        }
    261270
    262         public double readDouble() {
     271        @Override
     272    public double readDouble() {
    263273                long valueLongBits = readLong();
    264274                double result = Double.longBitsToDouble(valueLongBits);
     
    268278                return result;
    269279        }
    270         public void readFully(byte[] buf) {
     280        @Override
     281    public void readFully(byte[] buf) {
    271282                readFully(buf, 0, buf.length);
    272283        }
    273284
    274         public void readFully(byte[] buf, int off, int len) {
     285        @Override
     286    public void readFully(byte[] buf, int off, int len) {
    275287                checkRecordPosition(len);
    276288                _dataInput.readFully(buf, off, len);
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RefModeRecord.java

    r28000 r34151  
    1616   limitations under the License.
    1717==================================================================== */
    18        
     18
    1919
    2020package org.apache.poi.hssf.record;
     
    5151     * @param mode the mode to use
    5252     * @see #USE_A1_MODE
    53      * @see #USE_R1C1_MODE
    5453     *
    5554     */
     
    6463     * @return mode to use
    6564     * @see #USE_A1_MODE
    66      * @see #USE_R1C1_MODE
    6765     */
    6866
     
    7270    }
    7371
     72    @Override
    7473    public String toString()
    7574    {
     
    8382    }
    8483
     84    @Override
    8585    public void serialize(LittleEndianOutput out) {
    8686        out.writeShort(getMode());
    8787    }
    8888
     89    @Override
    8990    protected int getDataSize() {
    9091        return 2;
    9192    }
    9293
     94    @Override
    9395    public short getSid()
    9496    {
     
    9698    }
    9799
     100    @Override
    98101    public Object clone() {
    99102      RefModeRecord rec = new RefModeRecord();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/cont/UnknownLengthRecordOutput.java

    r28000 r34151  
    2424/**
    2525 * Allows the writing of BIFF records when the 'ushort size' header field is not known in advance.
    26  * When the client is finished writing data, it calls {@link #terminate()}, at which point this
     26 * When the client is finished writing data, it calls {@code terminate()}, at which point this
    2727 * class updates the 'ushort size' with its final value.
    2828 *
     
    6969        /**
    7070         * Finishes writing the current record and updates 'ushort size' field.<br/>
    71          * After this method is called, only {@link #getTotalSize()} may be called.
     71         * After this method is called, only {@code getTotalSize()} may be called.
    7272         */
    7373        public void terminate() {
     
    8484        }
    8585
    86         public void write(byte[] b) {
     86        @Override
     87    public void write(byte[] b) {
    8788                _out.write(b);
    8889                _size += b.length;
    8990        }
    90         public void write(byte[] b, int offset, int len) {
     91        @Override
     92    public void write(byte[] b, int offset, int len) {
    9193                _out.write(b, offset, len);
    9294                _size += len;
    9395        }
    94         public void writeByte(int v) {
     96        @Override
     97    public void writeByte(int v) {
    9598                _out.writeByte(v);
    9699                _size += 1;
    97100        }
    98         public void writeDouble(double v) {
     101        @Override
     102    public void writeDouble(double v) {
    99103                _out.writeDouble(v);
    100104                _size += 8;
    101105        }
    102         public void writeInt(int v) {
     106        @Override
     107    public void writeInt(int v) {
    103108                _out.writeInt(v);
    104109                _size += 4;
    105110        }
    106         public void writeLong(long v) {
     111        @Override
     112    public void writeLong(long v) {
    107113                _out.writeLong(v);
    108114                _size += 8;
    109115        }
    110         public void writeShort(int v) {
     116        @Override
     117    public void writeShort(int v) {
    111118                _out.writeShort(v);
    112119                _size += 2;
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/formula/SheetNameFormatter.java

    r28000 r34151  
    2626/**
    2727 * Formats sheet names for use in formula expressions.
    28  * 
     28 *
    2929 * @author Josh Micich
    3030 */
    3131public final class SheetNameFormatter {
    32        
     32
    3333        private static final char DELIMITER = '\'';
    34        
     34
    3535        /**
    3636         * Matches a single cell ref with no absolute ('$') markers
     
    4141                // no instances of this class
    4242        }
    43        
    44        
    45         /**
    46          * Convenience method for ({@link #format(String)}) when a StringBuffer is already available.
    47          * 
    48          * @param out - sheet name will be appended here possibly with delimiting quotes 
     43
     44
     45        /**
     46         * Convenience method for ({@code #format(String)}) when a StringBuffer is already available.
     47         *
     48         * @param out - sheet name will be appended here possibly with delimiting quotes
    4949         */
    5050        public static void appendFormat(StringBuffer out, String rawSheetName) {
     
    104104                if(Character.isLetter(rawSheetName.charAt(0))
    105105                                && Character.isDigit(rawSheetName.charAt(len-1))) {
    106                         // note - values like "A$1:$C$20" don't get this far 
     106                        // note - values like "A$1:$C$20" don't get this far
    107107                        if(nameLooksLikePlainCellReference(rawSheetName)) {
    108108                                return true;
     
    116116                return false;
    117117        }
    118        
     118
    119119        private static boolean nameLooksLikeBooleanLiteral(String rawSheetName) {
    120120                switch(rawSheetName.charAt(0)) {
     
    127127        }
    128128        /**
    129          * @return <code>true</code> if the presence of the specified character in a sheet name would 
    130          * require the sheet name to be delimited in formulas.  This includes every non-alphanumeric 
     129         * @return <code>true</code> if the presence of the specified character in a sheet name would
     130         * require the sheet name to be delimited in formulas.  This includes every non-alphanumeric
    131131         * character besides underscore '_' and dot '.'.
    132132         */
     
    143143                        case '\r':
    144144                        case '\t':
    145                                 throw new RuntimeException("Illegal character (0x" 
     145                                throw new RuntimeException("Illegal character (0x"
    146146                                                + Integer.toHexString(ch) + ") found in sheet name");
    147147                }
    148148                return true;
    149149        }
    150        
    151 
    152         /**
    153          * Used to decide whether sheet names like 'AB123' need delimiting due to the fact that they 
     150
     151
     152        /**
     153         * Used to decide whether sheet names like 'AB123' need delimiting due to the fact that they
    154154         * look like cell references.
    155155         * <p/>
    156156         * This code is currently being used for translating formulas represented with <code>Ptg</code>
    157          * tokens into human readable text form.  In formula expressions, a sheet name always has a 
    158          * trailing '!' so there is little chance for ambiguity.  It doesn't matter too much what this 
     157         * tokens into human readable text form.  In formula expressions, a sheet name always has a
     158         * trailing '!' so there is little chance for ambiguity.  It doesn't matter too much what this
    159159         * method returns but it is worth noting the likely consumers of these formula text strings:
    160160         * <ol>
     
    165165         * <li>Some third party formula parser</li>
    166166         * </ol>
    167          * 
     167         *
    168168         * At the time of writing, POI's formula parser tolerates cell-like sheet names in formulas
    169          * with or without delimiters.  The same goes for Excel(2007), both manual and automated entry. 
     169         * with or without delimiters.  The same goes for Excel(2007), both manual and automated entry.
    170170         * <p/>
    171171         * For better or worse this implementation attempts to replicate Excel's formula renderer.
     
    179179
    180180        /**
    181          * Note - this method assumes the specified rawSheetName has only letters and digits.  It 
     181         * Note - this method assumes the specified rawSheetName has only letters and digits.  It
    182182         * cannot be used to match absolute or range references (using the dollar or colon char).
    183183         * <p/>
    184184         * Some notable cases:
    185          *    <blockquote><table border="0" cellpadding="1" cellspacing="0" 
     185         *    <blockquote><table border="0" cellpadding="1" cellspacing="0"
    186186         *                 summary="Notable cases.">
    187187         *      <tr><th>Input&nbsp;</th><th>Result&nbsp;</th><th>Comments</th></tr>
     
    196196         *                      <td>Still needs delimiting even though well out of range</td></tr>
    197197         *    </table></blockquote>
    198          * 
     198         *
    199199         * @return <code>true</code> if there is any possible ambiguity that the specified rawSheetName
    200200         * could be interpreted as a valid cell name.
     
    205205                        return false;
    206206                }
    207                
     207
    208208                // rawSheetName == "Sheet1" gets this far.
    209209                String lettersPrefix = matcher.group(1);
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCell.java

    r28000 r34151  
    7878     * @return the HSSFSheet that owns this cell
    7979     */
     80    @Override
    8081    public HSSFSheet getSheet() {
    8182        return _sheet;
     
    8788     * @return the HSSFRow that owns this cell
    8889     */
     90    @Override
    8991    public HSSFRow getRow() {
    9092        int rowIndex = getRowIndex();
     
    179181     * @return the (zero based) index of the row containing this cell
    180182     */
     183    @Override
    181184    public int getRowIndex() {
    182185        return _record.getRow();
    183186    }
    184187
     188    @Override
    185189    public int getColumnIndex() {
    186190        return _record.getColumn() & 0xFFFF;
     
    196200     * @see #CELL_TYPE_ERROR
    197201     */
     202    @Override
    198203    public void setCellType(int cellType) {
    199204        notifyFormulaChanging();
     
    365370     */
    366371
     372    @Override
    367373    public int getCellType()
    368374    {
     
    381387    }
    382388
     389    @Override
    383390    public String getCellFormula() {
    384391        if (!(_record instanceof FormulaRecordAggregate)) {
     
    420427     * For strings we throw an exception.
    421428     * For blank cells we return a 0.
    422      * See {@link HSSFDataFormatter} for turning this
    423429     *  number into a string similar to that which
    424430     *  Excel would render this number as.
    425431     */
     432    @Override
    426433    public double getNumericCellValue() {
    427434
     
    445452     * For strings we throw an exception.
    446453     * For blank cells we return a null.
    447      * See {@link HSSFDataFormatter} for formatting
    448454     *  this date into a string similar to how excel does.
    449455     */
     456    @Override
    450457    public Date getDateCellValue() {
    451458
     
    465472     * For formulaCells that are not string Formulas, we throw an exception
    466473     */
     474    @Override
    467475    public String getStringCellValue()
    468476    {
     
    476484     * For formulaCells that are not string Formulas, we throw an exception
    477485     */
     486    @Override
    478487    public HSSFRichTextString getRichStringCellValue() {
    479488
     
    569578     * For blank cells we return a false.
    570579     */
     580    @Override
    571581    public boolean getBooleanCellValue() {
    572582
     
    597607     * get the style for the cell.  This is a reference to a cell style contained in the workbook
    598608     * object.
    599      * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#getCellStyleAt(short)
    600      */
     609     * @see org.apache.poi.hssf.usermodel.HSSFWorkbook
     610     */
     611    @Override
    601612    public HSSFCellStyle getCellStyle()
    602613    {
     
    641652     * Errors are displayed as #ERR&lt;errIdx&gt;
    642653     */
     654    @Override
    643655    public String toString() {
    644656        switch (getCellType()) {
     
    665677    }
    666678
     679    @Override
    667680    public CellRangeAddress getArrayFormulaRange() {
    668681        if (_cellType != CELL_TYPE_FORMULA) {
     
    674687    }
    675688
     689    @Override
    676690    public boolean isPartOfArrayFormulaGroup() {
    677691        if (_cellType != CELL_TYPE_FORMULA) {
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCellStyle.java

    r28000 r34151  
    2828 * @author  Andrew C. Oliver (acoliver at apache dot org)
    2929 * @author Jason Height (jheight at chariot dot net dot au)
    30  * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#createCellStyle()
    31  * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#getCellStyleAt(short)
    3230 * @see org.apache.poi.hssf.usermodel.HSSFCell#setCellStyle(HSSFCellStyle)
    3331 */
     
    5553     *  unless you're comparing which one is which)
    5654     */
     55    @Override
    5756    public short getIndex()
    5857    {
     
    6564     */
    6665
     66    @Override
    6767    public short getDataFormat()
    6868    {
     
    7676     * @return the format string or "General" if not found
    7777     */
     78    @Override
    7879    public String getDataFormatString() {
    7980        return getDataFormatString(_workbook);
     
    107108
    108109
    109         public int hashCode() {
     110        @Override
     111    public int hashCode() {
    110112                final int prime = 31;
    111113                int result = 1;
     
    115117        }
    116118
    117         public boolean equals(Object obj) {
     119        @Override
     120    public boolean equals(Object obj) {
    118121                if (this == obj) return true;
    119122                if (obj == null) return false;
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFSheet.java

    r30737 r34151  
    142142     * @return High level HSSFRow object representing a row in the sheet
    143143     * @see org.apache.poi.hssf.usermodel.HSSFRow
    144      * @see #removeRow(org.apache.poi.ss.usermodel.Row)
    145      */
     144     */
     145    @Override
    146146    public HSSFRow createRow(int rownum)
    147147    {
     
    198198     * @return HSSFRow representing the row number or null if its not defined on the sheet
    199199     */
     200    @Override
    200201    public HSSFRow getRow(int rowIndex) {
    201202        return _rows.get(Integer.valueOf(rowIndex));
     
    206207     * @return the number of the first logical row on the sheet, zero based
    207208     */
     209    @Override
    208210    public int getFirstRowNum() {
    209211        return _firstrow;
     
    217219     *  are zero rows on the sheet, or one at
    218220     *  position zero. For that case, additionally
    219      *  call {@link #getPhysicalNumberOfRows()} to
     221     *  call {@code #getPhysicalNumberOfRows()} to
    220222     *  tell if there is a row at position zero
    221223     *  or not.
    222224     * @return the number of the last row contained in this sheet, zero based.
    223225     */
     226    @Override
    224227    public int getLastRowNum() {
    225228        return _lastrow;
     
    231234     * Call getRowNum() on each row if you care which one it is.
    232235     */
     236    @Override
    233237    public Iterator<Row> rowIterator() {
    234238        @SuppressWarnings("unchecked") // can this clumsy generic syntax be improved?
     
    240244     *  foreach loops
    241245     */
     246    @Override
    242247    public Iterator<Row> iterator() {
    243248        return rowIterator();
     
    281286    }
    282287
     288    @Override
    283289    public CellRange<HSSFCell> removeArrayFormula(Cell cell) {
    284290        if (cell.getSheet() != this) {
     
    300306        return result;
    301307    }
    302    
     308
    303309
    304310}
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/poifs/storage/SmallDocumentBlock.java

    r30737 r34151  
    5353        _data = new byte[ _block_size ];
    5454    }
    55    
     55
    5656    private static int getBlocksPerBigBlock(final POIFSBigBlockSize bigBlockSize)
    5757    {
     
    146146    {
    147147        int _blocks_per_big_block = getBlocksPerBigBlock(bigBlockSize);
    148        
     148
    149149        List<SmallDocumentBlock> sdbs = new ArrayList<>();
    150150
     
    193193     *            stream
    194194     */
     195    @Override
    195196    public void writeBlocks(OutputStream stream)
    196197        throws IOException
     
    203204     *
    204205     * @return the block's data as a byte array
    205      *
    206      * @exception IOException if there is no data
    207      */
     206     */
     207    @Override
    208208    public byte [] getData() {
    209209        return _data;
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/format/CellFormatter.java

    r28000 r34151  
    3535
    3636    /**
    37      * Creates a new formatter object, storing the format in {@link #format}.
     37     * Creates a new formatter object, storing the format in {@code #format}.
    3838     *
    3939     * @param format The format.
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Cell.java

    r28000 r34151  
    150150     * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CELL_TYPE_STRING
    151151     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
    152      * @see DataFormatter for turning this number into a string similar to that which Excel would render this number as.
    153152     */
    154153    double getNumericCellValue();
     
    162161     * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CELL_TYPE_STRING
    163162     * @exception NumberFormatException if the cell value isn't a parsable <code>double</code>.
    164      * @see DataFormatter for formatting  this date into a string similar to how excel does.
    165163     */
    166164    Date getDateCellValue();
     
    202200     * @return the cell's style. Always not-null. Default cell style has zero index and can be obtained as
    203201     * <code>workbook.getCellStyleAt(0)</code>
    204      * @see Workbook#getCellStyleAt(short)
    205202     */
    206203    CellStyle getCellStyle();
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Sheet.java

    r28000 r34151  
    3636     * @param rownum  row number
    3737     * @return high level Row object representing a row in the sheet
    38      * @see #removeRow(Row)
    3938     */
    4039    Row createRow(int rownum);
     
    8079     */
    8180    CellRange<? extends Cell> removeArrayFormula(Cell cell);
    82    
    83    
     81
     82
    8483}
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/ExpandedDouble.java

    r28000 r34151  
    2727 * Does not handle negative numbers or zero
    2828 * <p/>
    29  * The value of a {@link ExpandedDouble} is given by<br/>
     29 * The value of a {@code ExpandedDouble} is given by<br/>
    3030 * <tt> a &times; 2<sup>b</sup></tt>
    3131 * <br/>
     
    6767
    6868        /**
    69          * Convert to an equivalent {@link NormalisedDecimal} representation having 15 decimal digits of precision in the
     69         * Convert to an equivalent {@code NormalisedDecimal} representation having 15 decimal digits of precision in the
    7070         * non-fractional bits of the significand.
    7171         */
  • applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/NormalisedDecimal.java

    r28000 r34151  
    3434 * This class does not handle negative numbers or zero.
    3535 * <p/>
    36  * The value of a {@link NormalisedDecimal} is given by<br/>
     36 * The value of a {@code NormalisedDecimal} is given by<br/>
    3737 * <tt> significand &times; 10<sup>decimalExponent</sup></tt>
    3838 * <br/>
  • applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/ODPackage.java

    r30568 r34151  
    11/*
    22 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    3  * 
     3 *
    44 * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved.
    5  * 
     5 *
    66 * The contents of this file are subject to the terms of the GNU
    7  * General Public License Version 3 only ("GPL"). 
    8  * You may not use this file except in compliance with the License. 
     7 * General Public License Version 3 only ("GPL").
     8 * You may not use this file except in compliance with the License.
    99 * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html
    1010 * See the License for the specific language governing permissions and limitations under the License.
    11  * 
     11 *
    1212 * When distributing the software, include this License Header Notice in each file.
    13  * 
     13 *
    1414 */
    1515
     
    1717
    1818import java.io.File;
    19 import java.io.IOException;
    2019import java.util.HashMap;
    2120import java.util.HashSet;
     
    2423
    2524import org.jdom.Document;
    26 import org.jdom.JDOMException;
    2725import org.jopendocument.util.CopyUtils;
    2826import org.jopendocument.util.FileUtils;
     
    3028/**
    3129 * An OpenDocument package, ie a zip containing XML documents and their associated files.
    32  * 
     30 *
    3331 * @author ILM Informatique 2 août 2004
    3432 */
     
    7674     * The version of this package, <code>null</code> if it cannot be found (eg this package is
    7775     * empty, or contains no xml).
    78      * 
     76     *
    7977     * @return the version of this package, can be <code>null</code>.
    8078     */
     
    130128    }
    131129
    132     /** 
     130    /**
    133131     * Return an XML document.
    134      * 
     132     *
    135133     * @param xmlEntry the filename, eg "styles.xml".
    136134     * @return the matching document, or <code>null</code> if there's none.
    137      * @throws JDOMException if error about the XML.
    138      * @throws IOException if an error occurs while reading the file.
    139135     */
    140136    public Document getDocument(String xmlEntry) {
  • applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/spreadsheet/Cell.java

    r30568 r34151  
    11/*
    22 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    3  * 
     3 *
    44 * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved.
    5  * 
     5 *
    66 * The contents of this file are subject to the terms of the GNU
    7  * General Public License Version 3 only ("GPL"). 
    8  * You may not use this file except in compliance with the License. 
     7 * General Public License Version 3 only ("GPL").
     8 * You may not use this file except in compliance with the License.
    99 * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html
    1010 * See the License for the specific language governing permissions and limitations under the License.
    11  * 
     11 *
    1212 * When distributing the software, include this License Header Notice in each file.
    13  * 
     13 *
    1414 */
    1515
     
    3535/**
    3636 * A cell in a calc document. If you want to change a cell value you must obtain a MutableCell.
    37  * 
     37 *
    3838 * @author Sylvain
    3939 * @param <D> type of document
     
    4444    private static final Pattern multiSpacePattern = Pattern.compile("[\t\r\n ]+");
    4545    private static boolean OO_MODE = true;
    46 
    47     /**
    48      * Set whether {@link #getTextValue()} parses strings using the standard way or using the
    49      * OpenOffice.org way.
    50      *
    51      * @param ooMode <code>true</code> if strings should be parsed the OO way.
    52      * @see #getTextValue(boolean)
    53      */
    54     /*public static void setTextValueMode(boolean ooMode) {
    55         OO_MODE = ooMode;
    56     }*/
    5746
    5847    public static boolean getTextValueMode() {
     
    118107    /**
    119108     * Calls {@link #getTextValue(boolean)} using {@link #getTextValueMode()}.
    120      * 
     109     *
    121110     * @return a string for the content of this cell.
    122111     */
     
    131120     * OO way (as of 3.1) and the OpenDocument way see section 5.1.1 White-space Characters of
    132121     * OpenDocument-v1.0-os and OpenDocument-v1.2-part1. In essence OpenOffice never trim strings.
    133      * 
     122     *
    134123     * @param ooMode whether to use the OO way or the standard way.
    135124     * @return a string for the content of this cell.
  • applications/editors/josm/plugins/opendata/includes/org/jopendocument/util/CollectionUtils.java

    r31942 r34151  
    11/*
    22 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    3  * 
     3 *
    44 * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved.
    5  * 
     5 *
    66 * The contents of this file are subject to the terms of the GNU
    7  * General Public License Version 3 only ("GPL"). 
    8  * You may not use this file except in compliance with the License. 
     7 * General Public License Version 3 only ("GPL").
     8 * You may not use this file except in compliance with the License.
    99 * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html
    1010 * See the License for the specific language governing permissions and limitations under the License.
    11  * 
     11 *
    1212 * When distributing the software, include this License Header Notice in each file.
    13  * 
     13 *
    1414 */
    1515
     
    2626/**
    2727 * Une classe regroupant des méthodes utilitaires pour les collections.
    28  * 
     28 *
    2929 * @author ILM Informatique 30 sept. 2004
    3030 */
     
    3434     * Concatene une collection. Cette méthode va appliquer un transformation sur chaque élément
    3535     * avant d'appeler toString(). join([-1, 3, 0], " ,", doubleTransformer) == "-2, 6, 0"
    36      * 
     36     *
    3737     * @param <E> type of items
    3838     * @param c la collection a concaténer.
     
    6969    /**
    7070     * Concatene une collection en appelant simplement toString() sur chaque élément.
    71      * 
     71     *
    7272     * @param <T> type of collection
    7373     * @param c la collection a concaténer.
    7474     * @param sep le séparateur entre chaque élément.
    7575     * @return la chaine composée de chacun des éléments séparés par <code>sep</code>.
    76      * @see #join(Collection, String, ITransformer)
    7776     */
    7877    static public <T> String join(Collection<T> c, String sep) {
  • applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleDownloadTask.java

    r33518 r34151  
    1717
    1818import org.openstreetmap.josm.data.Version;
     19import org.openstreetmap.josm.gui.PleaseWaitDialog;
    1920import org.openstreetmap.josm.gui.PleaseWaitRunnable;
    2021import org.openstreetmap.josm.gui.progress.NullProgressMonitor;
     
    2829 * Asynchronous task for downloading a collection of modules.
    2930 *
    30  * When the task is finished {@see #getDownloadedModules()} replies the list of downloaded modules
    31  * and {@see #getFailedModules()} replies the list of failed modules.
     31 * When the task is finished {@link #getDownloadedModules()} replies the list of downloaded modules
     32 * and {@link #getFailedModules()} replies the list of failed modules.
    3233 *
    3334 */
     
    4344     * Creates the download task
    4445     *
    45      * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed
     46     * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed
    4647     * @param toUpdate a collection of module descriptions for modules to update/download. Must not be null.
    47      * @param title the title to display in the {@see PleaseWaitDialog}
     48     * @param title the title to display in the {@link PleaseWaitDialog}
    4849     * @throws IllegalArgumentException thrown if toUpdate is null
    4950     */
     
    5758     * Creates the task
    5859     *
    59      * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     60     * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    6061     * @param toUpdate a collection of module descriptions for modules to update/download. Must not be null.
    61      * @param title the title to display in the {@see PleaseWaitDialog}
     62     * @param title the title to display in the {@link PleaseWaitDialog}
    6263     * @throws IllegalArgumentException thrown if toUpdate is null
    6364     */
  • applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleHandler.java

    r33790 r34151  
    266266     *
    267267     * @param modules the list of modules
    268      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     268     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    269269     */
    270270    public static void loadModules(Component parent, Collection<ModuleInformation> modules, ProgressMonitor monitor) {
     
    302302     * module lists.
    303303     *
    304      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     304     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    305305     * @return the list of locally available module information
    306306     *
     
    416416     * @param parent the parent window for message boxes
    417417     * @param modules the collection of modules to update. Must not be null.
    418      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null.
     418     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null.
    419419     * @throws IllegalArgumentException thrown if modules is null
    420420     */
     
    622622    }*/
    623623
    624     /**
     624    /*
    625625     * Replies the module which most likely threw the exception <code>ex</code>.
    626626     *
     
    647647    }*/
    648648
    649     /**
     649    /*
    650650     * Checks whether the exception <code>e</code> was thrown by a module. If so,
    651651     * conditionally deactivates the module, but asks the user first.
  • applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleInformation.java

    r33518 r34151  
    221221     * Load and instantiate the module
    222222     *
    223      * @param the module class
     223     * @param klass the module class
    224224     * @return the instantiated and initialized module
    225225     */
  • applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadLocalModuleInformationTask.java

    r33518 r34151  
    1717import org.openstreetmap.josm.gui.progress.ProgressMonitor;
    1818import org.openstreetmap.josm.io.OsmTransferException;
     19import org.openstreetmap.josm.plugins.opendata.OdPlugin;
    1920import org.openstreetmap.josm.tools.ImageProvider;
    2021import org.openstreetmap.josm.tools.Logging;
     
    2526 * in the local module repositories.
    2627 *
    27  * It scans the files in the local modules repository (see {@see Preferences#getModulesDirectory()}
     28 * It scans the files in the local modules repository (see {@link OdPlugin#getModulesDirectory()}
    2829 * and extracts module information from three kind of files:
    2930 * <ul>
  • applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadRemoteModuleInformationTask.java

    r33518 r34151  
    6969     * Creates the task
    7070     *
    71      * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null
     71     * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null
    7272     * @param sites the collection of download sites. Defaults to the empty collection if null.
    7373     */
Note: See TracChangeset for help on using the changeset viewer.