This exception is thrown if a {@link MutablePropertySet} is to be written * but does not have a formatID set (see {@link - * MutableSection#setFormatID(ClassID)} or - * {@link org.apache.poi.hpsf.MutableSection#setFormatID(byte[])}. + * MutableSection#setFormatID(ClassID)}. * * @author Rainer Klute <klute@rainer-klute.de> */ -@SuppressWarnings("serial") public class NoFormatIDException extends HPSFRuntimeException { Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/PropertySet.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/PropertySet.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/PropertySet.java (revision 34151) @@ -38,6 +38,6 @@ * *
{@link PropertySetFactory#create} does its work by calling one - * of the constructors {@link PropertySet#PropertySet(InputStream)} or - * {@link PropertySet#PropertySet(byte[])}. If the constructor's + * of the constructor {@link PropertySet#PropertySet(InputStream)}. + * If the constructor's * argument is not in the Horrible Property Set Format, i.e. not a * property set stream, or if any other error occurs, an appropriate @@ -111,5 +111,5 @@ - + /** *
Specifies the version of the operating system that created
@@ -352,5 +352,5 @@
{
/* FIXME (3): Ensure that at most "length" bytes are read. */
-
+
/*
* Read the stream's header fields.
@@ -552,8 +552,9 @@
*
* @param o the object to compare this PropertySet with
- *
+ *
* @return true if the objects are equal, false
* if not
*/
+ @Override
public boolean equals(final Object o)
{
@@ -587,4 +588,5 @@
* @see Object#hashCode()
*/
+ @Override
public int hashCode()
{
@@ -597,4 +599,5 @@
* @see Object#toString()
*/
+ @Override
public String toString()
{
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/Section.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/Section.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hpsf/Section.java (revision 34151)
@@ -341,5 +341,5 @@
*
Returns the value of the property with the specified ID. If
* the property is not available, null is returned
- * and a subsequent call to {@link #wasNull} will return
+ * and a subsequent call to {@code #wasNull} will return
* true.
*
- * @see org.apache.poi.hssf.eventmodel.EventRecordFactory
* @author Andrew C. Oliver (acoliver at apache dot org)
* @author Marc Johnson (mjohnson at apache dot org)
@@ -54,5 +53,6 @@
_c = c;
}
- public Record create(RecordInputStream in) {
+ @Override
+ public Record create(RecordInputStream in) {
Object[] args = { in, };
try {
@@ -68,5 +68,6 @@
}
}
- public Class getRecordClass() {
+ @Override
+ public Class getRecordClass() {
return _c.getDeclaringClass();
}
@@ -82,5 +83,6 @@
_m = m;
}
- public Record create(RecordInputStream in) {
+ @Override
+ public Record create(RecordInputStream in) {
Object[] args = { in, };
try {
@@ -94,5 +96,6 @@
}
}
- @SuppressWarnings("unchecked")
+ @Override
+ @SuppressWarnings("unchecked")
public Class getRecordClass() {
return (Class) _m.getDeclaringClass();
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordFactoryInputStream.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordFactoryInputStream.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordFactoryInputStream.java (revision 34151)
@@ -27,7 +27,4 @@
* the data into full records, processing continue records
* etc.
- * Most users should use {@link HSSFEventFactory} /
- * {@link HSSFListener} and have new records pushed to
- * them, but this does allow for a "pull" style of coding.
*/
public final class RecordFactoryInputStream {
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordInputStream.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordInputStream.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RecordInputStream.java (revision 34151)
@@ -42,8 +42,7 @@
/**
- * For use in {@link BiffViewer} which may construct {@link Record}s that don't completely
+ * For use in {@code BiffViewer} which may construct {@link Record}s that don't completely
* read all available data. This exception should never be thrown otherwise.
*/
- @SuppressWarnings("serial")
public static final class LeftoverDataException extends RuntimeException {
public LeftoverDataException(int sid, int remainingByteCount) {
@@ -85,11 +84,14 @@
_lei = getLEI(in);
}
- public int available() {
+ @Override
+ public int available() {
return _lei.available();
}
- public int readDataSize() {
+ @Override
+ public int readDataSize() {
return _lei.readUShort();
}
- public int readRecordSID() {
+ @Override
+ public int readRecordSID() {
return _lei.readUShort();
}
@@ -119,5 +121,6 @@
* @see #remaining()
*/
- public int available() {
+ @Override
+ public int available() {
return remaining();
}
@@ -211,5 +214,6 @@
* Reads an 8 bit, signed value
*/
- public byte readByte() {
+ @Override
+ public byte readByte() {
checkRecordPosition(LittleEndian.BYTE_SIZE);
_currentDataOffset += LittleEndian.BYTE_SIZE;
@@ -220,5 +224,6 @@
* Reads a 16 bit, signed value
*/
- public short readShort() {
+ @Override
+ public short readShort() {
checkRecordPosition(LittleEndian.SHORT_SIZE);
_currentDataOffset += LittleEndian.SHORT_SIZE;
@@ -227,7 +232,8 @@
/**
- * Reads a 32 bit, signed value
- */
- public int readInt() {
+ * Reads a 32 bit, signed value
+ */
+ @Override
+ public int readInt() {
checkRecordPosition(LittleEndian.INT_SIZE);
_currentDataOffset += LittleEndian.INT_SIZE;
@@ -238,5 +244,6 @@
* Reads a 64 bit, signed value
*/
- public long readLong() {
+ @Override
+ public long readLong() {
checkRecordPosition(LittleEndian.LONG_SIZE);
_currentDataOffset += LittleEndian.LONG_SIZE;
@@ -247,5 +254,6 @@
* Reads an 8 bit, unsigned value
*/
- public int readUByte() {
+ @Override
+ public int readUByte() {
return readByte() & 0x00FF;
}
@@ -254,5 +262,6 @@
* Reads a 16 bit, unsigned value.
*/
- public int readUShort() {
+ @Override
+ public int readUShort() {
checkRecordPosition(LittleEndian.SHORT_SIZE);
_currentDataOffset += LittleEndian.SHORT_SIZE;
@@ -260,5 +269,6 @@
}
- public double readDouble() {
+ @Override
+ public double readDouble() {
long valueLongBits = readLong();
double result = Double.longBitsToDouble(valueLongBits);
@@ -268,9 +278,11 @@
return result;
}
- public void readFully(byte[] buf) {
+ @Override
+ public void readFully(byte[] buf) {
readFully(buf, 0, buf.length);
}
- public void readFully(byte[] buf, int off, int len) {
+ @Override
+ public void readFully(byte[] buf, int off, int len) {
checkRecordPosition(len);
_dataInput.readFully(buf, off, len);
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RefModeRecord.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RefModeRecord.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/RefModeRecord.java (revision 34151)
@@ -16,5 +16,5 @@
limitations under the License.
==================================================================== */
-
+
package org.apache.poi.hssf.record;
@@ -51,5 +51,4 @@
* @param mode the mode to use
* @see #USE_A1_MODE
- * @see #USE_R1C1_MODE
*
*/
@@ -64,5 +63,4 @@
* @return mode to use
* @see #USE_A1_MODE
- * @see #USE_R1C1_MODE
*/
@@ -72,4 +70,5 @@
}
+ @Override
public String toString()
{
@@ -83,12 +82,15 @@
}
+ @Override
public void serialize(LittleEndianOutput out) {
out.writeShort(getMode());
}
+ @Override
protected int getDataSize() {
return 2;
}
+ @Override
public short getSid()
{
@@ -96,4 +98,5 @@
}
+ @Override
public Object clone() {
RefModeRecord rec = new RefModeRecord();
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/cont/UnknownLengthRecordOutput.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/cont/UnknownLengthRecordOutput.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/cont/UnknownLengthRecordOutput.java (revision 34151)
@@ -24,5 +24,5 @@
/**
* Allows the writing of BIFF records when the 'ushort size' header field is not known in advance.
- * When the client is finished writing data, it calls {@link #terminate()}, at which point this
+ * When the client is finished writing data, it calls {@code terminate()}, at which point this
* class updates the 'ushort size' with its final value.
*
@@ -69,5 +69,5 @@
/**
* Finishes writing the current record and updates 'ushort size' field.
- * After this method is called, only {@link #getTotalSize()} may be called.
+ * After this method is called, only {@code getTotalSize()} may be called.
*/
public void terminate() {
@@ -84,29 +84,36 @@
}
- public void write(byte[] b) {
+ @Override
+ public void write(byte[] b) {
_out.write(b);
_size += b.length;
}
- public void write(byte[] b, int offset, int len) {
+ @Override
+ public void write(byte[] b, int offset, int len) {
_out.write(b, offset, len);
_size += len;
}
- public void writeByte(int v) {
+ @Override
+ public void writeByte(int v) {
_out.writeByte(v);
_size += 1;
}
- public void writeDouble(double v) {
+ @Override
+ public void writeDouble(double v) {
_out.writeDouble(v);
_size += 8;
}
- public void writeInt(int v) {
+ @Override
+ public void writeInt(int v) {
_out.writeInt(v);
_size += 4;
}
- public void writeLong(long v) {
+ @Override
+ public void writeLong(long v) {
_out.writeLong(v);
_size += 8;
}
- public void writeShort(int v) {
+ @Override
+ public void writeShort(int v) {
_out.writeShort(v);
_size += 2;
Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/formula/SheetNameFormatter.java
===================================================================
--- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/formula/SheetNameFormatter.java (revision 34150)
+++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/record/formula/SheetNameFormatter.java (revision 34151)
@@ -26,11 +26,11 @@
/**
* Formats sheet names for use in formula expressions.
- *
+ *
* @author Josh Micich
*/
public final class SheetNameFormatter {
-
+
private static final char DELIMITER = '\'';
-
+
/**
* Matches a single cell ref with no absolute ('$') markers
@@ -41,10 +41,10 @@
// no instances of this class
}
-
-
- /**
- * Convenience method for ({@link #format(String)}) when a StringBuffer is already available.
- *
- * @param out - sheet name will be appended here possibly with delimiting quotes
+
+
+ /**
+ * Convenience method for ({@code #format(String)}) when a StringBuffer is already available.
+ *
+ * @param out - sheet name will be appended here possibly with delimiting quotes
*/
public static void appendFormat(StringBuffer out, String rawSheetName) {
@@ -104,5 +104,5 @@
if(Character.isLetter(rawSheetName.charAt(0))
&& Character.isDigit(rawSheetName.charAt(len-1))) {
- // note - values like "A$1:$C$20" don't get this far
+ // note - values like "A$1:$C$20" don't get this far
if(nameLooksLikePlainCellReference(rawSheetName)) {
return true;
@@ -116,5 +116,5 @@
return false;
}
-
+
private static boolean nameLooksLikeBooleanLiteral(String rawSheetName) {
switch(rawSheetName.charAt(0)) {
@@ -127,6 +127,6 @@
}
/**
- * @return true if the presence of the specified character in a sheet name would
- * require the sheet name to be delimited in formulas. This includes every non-alphanumeric
+ * @return true if the presence of the specified character in a sheet name would
+ * require the sheet name to be delimited in formulas. This includes every non-alphanumeric
* character besides underscore '_' and dot '.'.
*/
@@ -143,18 +143,18 @@
case '\r':
case '\t':
- throw new RuntimeException("Illegal character (0x"
+ throw new RuntimeException("Illegal character (0x"
+ Integer.toHexString(ch) + ") found in sheet name");
}
return true;
}
-
-
- /**
- * Used to decide whether sheet names like 'AB123' need delimiting due to the fact that they
+
+
+ /**
+ * Used to decide whether sheet names like 'AB123' need delimiting due to the fact that they
* look like cell references.
*
Ptg
- * tokens into human readable text form. In formula expressions, a sheet name always has a
- * trailing '!' so there is little chance for ambiguity. It doesn't matter too much what this
+ * tokens into human readable text form. In formula expressions, a sheet name always has a
+ * trailing '!' so there is little chance for ambiguity. It doesn't matter too much what this
* method returns but it is worth noting the likely consumers of these formula text strings:
*
*
- * + * * @return@@ -196,5 +196,5 @@ * Input Result Comments Still needs delimiting even though well out of range *trueif there is any possible ambiguity that the specified rawSheetName * could be interpreted as a valid cell name. @@ -205,5 +205,5 @@ return false; } - + // rawSheetName == "Sheet1" gets this far. String lettersPrefix = matcher.group(1); Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCell.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCell.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCell.java (revision 34151) @@ -78,4 +78,5 @@ * @return the HSSFSheet that owns this cell */ + @Override public HSSFSheet getSheet() { return _sheet; @@ -87,4 +88,5 @@ * @return the HSSFRow that owns this cell */ + @Override public HSSFRow getRow() { int rowIndex = getRowIndex(); @@ -179,8 +181,10 @@ * @return the (zero based) index of the row containing this cell */ + @Override public int getRowIndex() { return _record.getRow(); } + @Override public int getColumnIndex() { return _record.getColumn() & 0xFFFF; @@ -196,4 +200,5 @@ * @see #CELL_TYPE_ERROR */ + @Override public void setCellType(int cellType) { notifyFormulaChanging(); @@ -365,4 +370,5 @@ */ + @Override public int getCellType() { @@ -381,4 +387,5 @@ } + @Override public String getCellFormula() { if (!(_record instanceof FormulaRecordAggregate)) { @@ -420,8 +427,8 @@ * For strings we throw an exception. * For blank cells we return a 0. - * See {@link HSSFDataFormatter} for turning this * number into a string similar to that which * Excel would render this number as. */ + @Override public double getNumericCellValue() { @@ -445,7 +452,7 @@ * For strings we throw an exception. * For blank cells we return a null. - * See {@link HSSFDataFormatter} for formatting * this date into a string similar to how excel does. */ + @Override public Date getDateCellValue() { @@ -465,4 +472,5 @@ * For formulaCells that are not string Formulas, we throw an exception */ + @Override public String getStringCellValue() { @@ -476,4 +484,5 @@ * For formulaCells that are not string Formulas, we throw an exception */ + @Override public HSSFRichTextString getRichStringCellValue() { @@ -569,4 +578,5 @@ * For blank cells we return a false. */ + @Override public boolean getBooleanCellValue() { @@ -597,6 +607,7 @@ * get the style for the cell. This is a reference to a cell style contained in the workbook * object. - * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#getCellStyleAt(short) - */ + * @see org.apache.poi.hssf.usermodel.HSSFWorkbook + */ + @Override public HSSFCellStyle getCellStyle() { @@ -641,4 +652,5 @@ * Errors are displayed as #ERR<errIdx> */ + @Override public String toString() { switch (getCellType()) { @@ -665,4 +677,5 @@ } + @Override public CellRangeAddress getArrayFormulaRange() { if (_cellType != CELL_TYPE_FORMULA) { @@ -674,4 +687,5 @@ } + @Override public boolean isPartOfArrayFormulaGroup() { if (_cellType != CELL_TYPE_FORMULA) { Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCellStyle.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCellStyle.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFCellStyle.java (revision 34151) @@ -28,6 +28,4 @@ * @author Andrew C. Oliver (acoliver at apache dot org) * @author Jason Height (jheight at chariot dot net dot au) - * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#createCellStyle() - * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#getCellStyleAt(short) * @see org.apache.poi.hssf.usermodel.HSSFCell#setCellStyle(HSSFCellStyle) */ @@ -55,4 +53,5 @@ * unless you're comparing which one is which) */ + @Override public short getIndex() { @@ -65,4 +64,5 @@ */ + @Override public short getDataFormat() { @@ -76,4 +76,5 @@ * @return the format string or "General" if not found */ + @Override public String getDataFormatString() { return getDataFormatString(_workbook); @@ -107,5 +108,6 @@ - public int hashCode() { + @Override + public int hashCode() { final int prime = 31; int result = 1; @@ -115,5 +117,6 @@ } - public boolean equals(Object obj) { + @Override + public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFSheet.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFSheet.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/hssf/usermodel/HSSFSheet.java (revision 34151) @@ -142,6 +142,6 @@ * @return High level HSSFRow object representing a row in the sheet * @see org.apache.poi.hssf.usermodel.HSSFRow - * @see #removeRow(org.apache.poi.ss.usermodel.Row) - */ + */ + @Override public HSSFRow createRow(int rownum) { @@ -198,4 +198,5 @@ * @return HSSFRow representing the row number or null if its not defined on the sheet */ + @Override public HSSFRow getRow(int rowIndex) { return _rows.get(Integer.valueOf(rowIndex)); @@ -206,4 +207,5 @@ * @return the number of the first logical row on the sheet, zero based */ + @Override public int getFirstRowNum() { return _firstrow; @@ -217,9 +219,10 @@ * are zero rows on the sheet, or one at * position zero. For that case, additionally - * call {@link #getPhysicalNumberOfRows()} to + * call {@code #getPhysicalNumberOfRows()} to * tell if there is a row at position zero * or not. * @return the number of the last row contained in this sheet, zero based. */ + @Override public int getLastRowNum() { return _lastrow; @@ -231,4 +234,5 @@ * Call getRowNum() on each row if you care which one it is. */ + @Override public IteratorrowIterator() { @SuppressWarnings("unchecked") // can this clumsy generic syntax be improved? @@ -240,4 +244,5 @@ * foreach loops */ + @Override public Iterator
iterator() { return rowIterator(); @@ -281,4 +286,5 @@ } + @Override public CellRange
removeArrayFormula(Cell cell) { if (cell.getSheet() != this) { @@ -300,5 +306,5 @@ return result; } - + } Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/poifs/storage/SmallDocumentBlock.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/poifs/storage/SmallDocumentBlock.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/poifs/storage/SmallDocumentBlock.java (revision 34151) @@ -53,5 +53,5 @@ _data = new byte[ _block_size ]; } - + private static int getBlocksPerBigBlock(final POIFSBigBlockSize bigBlockSize) { @@ -146,5 +146,5 @@ { int _blocks_per_big_block = getBlocksPerBigBlock(bigBlockSize); - + List sdbs = new ArrayList<>(); @@ -193,4 +193,5 @@ * stream */ + @Override public void writeBlocks(OutputStream stream) throws IOException @@ -203,7 +204,6 @@ * * @return the block's data as a byte array - * - * @exception IOException if there is no data - */ + */ + @Override public byte [] getData() { return _data; Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/format/CellFormatter.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/format/CellFormatter.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/format/CellFormatter.java (revision 34151) @@ -35,5 +35,5 @@ /** - * Creates a new formatter object, storing the format in {@link #format}. + * Creates a new formatter object, storing the format in {@code #format}. * * @param format The format. Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Cell.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Cell.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Cell.java (revision 34151) @@ -150,5 +150,4 @@ * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CELL_TYPE_STRING * @exception NumberFormatException if the cell value isn't a parsable double. - * @see DataFormatter for turning this number into a string similar to that which Excel would render this number as. */ double getNumericCellValue(); @@ -162,5 +161,4 @@ * @throws IllegalStateException if the cell type returned by {@link #getCellType()} is CELL_TYPE_STRING * @exception NumberFormatException if the cell value isn't a parsabledouble. - * @see DataFormatter for formatting this date into a string similar to how excel does. */ Date getDateCellValue(); @@ -202,5 +200,4 @@ * @return the cell's style. Always not-null. Default cell style has zero index and can be obtained as *workbook.getCellStyleAt(0)- * @see Workbook#getCellStyleAt(short) */ CellStyle getCellStyle(); Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Sheet.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Sheet.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/usermodel/Sheet.java (revision 34151) @@ -36,5 +36,4 @@ * @param rownum row number * @return high level Row object representing a row in the sheet - * @see #removeRow(Row) */ Row createRow(int rownum); @@ -80,5 +79,5 @@ */ CellRange removeArrayFormula(Cell cell); - - + + } Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/ExpandedDouble.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/ExpandedDouble.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/ExpandedDouble.java (revision 34151) @@ -27,5 +27,5 @@ * Does not handle negative numbers or zero * - * The value of a {@link ExpandedDouble} is given by
+ * The value of a {@code ExpandedDouble} is given by
* a × 2b *
@@ -67,5 +67,5 @@ /** - * Convert to an equivalent {@link NormalisedDecimal} representation having 15 decimal digits of precision in the + * Convert to an equivalent {@code NormalisedDecimal} representation having 15 decimal digits of precision in the * non-fractional bits of the significand. */ Index: /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/NormalisedDecimal.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/NormalisedDecimal.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/apache/poi/ss/util/NormalisedDecimal.java (revision 34151) @@ -34,5 +34,5 @@ * This class does not handle negative numbers or zero. * - * The value of a {@link NormalisedDecimal} is given by
+ * The value of a {@code NormalisedDecimal} is given by
* significand × 10decimalExponent *
Index: /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/ODPackage.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/ODPackage.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/ODPackage.java (revision 34151) @@ -1,15 +1,15 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. - * + * * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved. - * + * * The contents of this file are subject to the terms of the GNU - * General Public License Version 3 only ("GPL"). - * You may not use this file except in compliance with the License. + * General Public License Version 3 only ("GPL"). + * You may not use this file except in compliance with the License. * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html * See the License for the specific language governing permissions and limitations under the License. - * + * * When distributing the software, include this License Header Notice in each file. - * + * */ @@ -17,5 +17,4 @@ import java.io.File; -import java.io.IOException; import java.util.HashMap; import java.util.HashSet; @@ -24,5 +23,4 @@ import org.jdom.Document; -import org.jdom.JDOMException; import org.jopendocument.util.CopyUtils; import org.jopendocument.util.FileUtils; @@ -30,5 +28,5 @@ /** * An OpenDocument package, ie a zip containing XML documents and their associated files. - * + * * @author ILM Informatique 2 août 2004 */ @@ -76,5 +74,5 @@ * The version of this package,nullif it cannot be found (eg this package is * empty, or contains no xml). - * + * * @return the version of this package, can benull. */ @@ -130,11 +128,9 @@ } - /** + /** * Return an XML document. - * + * * @param xmlEntry the filename, eg "styles.xml". * @return the matching document, ornullif there's none. - * @throws JDOMException if error about the XML. - * @throws IOException if an error occurs while reading the file. */ public Document getDocument(String xmlEntry) { Index: /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/spreadsheet/Cell.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/spreadsheet/Cell.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/jopendocument/dom/spreadsheet/Cell.java (revision 34151) @@ -1,15 +1,15 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. - * + * * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved. - * + * * The contents of this file are subject to the terms of the GNU - * General Public License Version 3 only ("GPL"). - * You may not use this file except in compliance with the License. + * General Public License Version 3 only ("GPL"). + * You may not use this file except in compliance with the License. * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html * See the License for the specific language governing permissions and limitations under the License. - * + * * When distributing the software, include this License Header Notice in each file. - * + * */ @@ -35,5 +35,5 @@ /** * A cell in a calc document. If you want to change a cell value you must obtain a MutableCell. - * + * * @author Sylvain * @paramtype of document @@ -44,15 +44,4 @@ private static final Pattern multiSpacePattern = Pattern.compile("[\t\r\n ]+"); private static boolean OO_MODE = true; - - /** - * Set whether {@link #getTextValue()} parses strings using the standard way or using the - * OpenOffice.org way. - * - * @param ooMode trueif strings should be parsed the OO way. - * @see #getTextValue(boolean) - */ - /*public static void setTextValueMode(boolean ooMode) { - OO_MODE = ooMode; - }*/ public static boolean getTextValueMode() { @@ -118,5 +107,5 @@ /** * Calls {@link #getTextValue(boolean)} using {@link #getTextValueMode()}. - * + * * @return a string for the content of this cell. */ @@ -131,5 +120,5 @@ * OO way (as of 3.1) and the OpenDocument way see section 5.1.1 White-space Characters of * OpenDocument-v1.0-os and OpenDocument-v1.2-part1. In essence OpenOffice never trim strings. - * + * * @param ooMode whether to use the OO way or the standard way. * @return a string for the content of this cell. Index: /applications/editors/josm/plugins/opendata/includes/org/jopendocument/util/CollectionUtils.java =================================================================== --- /applications/editors/josm/plugins/opendata/includes/org/jopendocument/util/CollectionUtils.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/includes/org/jopendocument/util/CollectionUtils.java (revision 34151) @@ -1,15 +1,15 @@ /* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. - * + * * Copyright 2008 jOpenDocument, by ILM Informatique. All rights reserved. - * + * * The contents of this file are subject to the terms of the GNU - * General Public License Version 3 only ("GPL"). - * You may not use this file except in compliance with the License. + * General Public License Version 3 only ("GPL"). + * You may not use this file except in compliance with the License. * You can obtain a copy of the License at http://www.gnu.org/licenses/gpl-3.0.html * See the License for the specific language governing permissions and limitations under the License. - * + * * When distributing the software, include this License Header Notice in each file. - * + * */ @@ -26,5 +26,5 @@ /** * Une classe regroupant des méthodes utilitaires pour les collections. - * + * * @author ILM Informatique 30 sept. 2004 */ @@ -34,5 +34,5 @@ * Concatene une collection. Cette méthode va appliquer un transformation sur chaque élément * avant d'appeler toString(). join([-1, 3, 0], " ,", doubleTransformer) == "-2, 6, 0" - * + * * @paramtype of items * @param c la collection a concaténer. @@ -69,10 +69,9 @@ /** * Concatene une collection en appelant simplement toString() sur chaque élément. - * + * * @param type of collection * @param c la collection a concaténer. * @param sep le séparateur entre chaque élément. * @return la chaine composée de chacun des éléments séparés par sep. - * @see #join(Collection, String, ITransformer) */ static publicString join(Collection c, String sep) { Index: /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleDownloadTask.java =================================================================== --- /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleDownloadTask.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleDownloadTask.java (revision 34151) @@ -17,4 +17,5 @@ import org.openstreetmap.josm.data.Version; +import org.openstreetmap.josm.gui.PleaseWaitDialog; import org.openstreetmap.josm.gui.PleaseWaitRunnable; import org.openstreetmap.josm.gui.progress.NullProgressMonitor; @@ -28,6 +29,6 @@ * Asynchronous task for downloading a collection of modules. * - * When the task is finished {@see #getDownloadedModules()} replies the list of downloaded modules - * and {@see #getFailedModules()} replies the list of failed modules. + * When the task is finished {@link #getDownloadedModules()} replies the list of downloaded modules + * and {@link #getFailedModules()} replies the list of failed modules. * */ @@ -43,7 +44,7 @@ * Creates the download task * - * @param parent the parent component relative to which the {@see PleaseWaitDialog} is displayed + * @param parent the parent component relative to which the {@link PleaseWaitDialog} is displayed * @param toUpdate a collection of module descriptions for modules to update/download. Must not be null. - * @param title the title to display in the {@see PleaseWaitDialog} + * @param title the title to display in the {@link PleaseWaitDialog} * @throws IllegalArgumentException thrown if toUpdate is null */ @@ -57,7 +58,7 @@ * Creates the task * - * @param monitor a progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null + * @param monitor a progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null * @param toUpdate a collection of module descriptions for modules to update/download. Must not be null. - * @param title the title to display in the {@see PleaseWaitDialog} + * @param title the title to display in the {@link PleaseWaitDialog} * @throws IllegalArgumentException thrown if toUpdate is null */ Index: /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleHandler.java =================================================================== --- /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleHandler.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleHandler.java (revision 34151) @@ -266,5 +266,5 @@ * * @param modules the list of modules - * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null. + * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null. */ public static void loadModules(Component parent, Collection modules, ProgressMonitor monitor) { @@ -302,5 +302,5 @@ * module lists. * - * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null. + * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null. * @return the list of locally available module information * @@ -416,5 +416,5 @@ * @param parent the parent window for message boxes * @param modules the collection of modules to update. Must not be null. - * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null. + * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null. * @throws IllegalArgumentException thrown if modules is null */ @@ -622,5 +622,5 @@ }*/ - /** + /* * Replies the module which most likely threw the exception ex. * @@ -647,5 +647,5 @@ }*/ - /** + /* * Checks whether the exceptionewas thrown by a module. If so, * conditionally deactivates the module, but asks the user first. Index: /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleInformation.java =================================================================== --- /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleInformation.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ModuleInformation.java (revision 34151) @@ -221,5 +221,5 @@ * Load and instantiate the module * - * @param the module class + * @param klass the module class * @return the instantiated and initialized module */ Index: /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadLocalModuleInformationTask.java =================================================================== --- /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadLocalModuleInformationTask.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadLocalModuleInformationTask.java (revision 34151) @@ -17,4 +17,5 @@ import org.openstreetmap.josm.gui.progress.ProgressMonitor; import org.openstreetmap.josm.io.OsmTransferException; +import org.openstreetmap.josm.plugins.opendata.OdPlugin; import org.openstreetmap.josm.tools.ImageProvider; import org.openstreetmap.josm.tools.Logging; @@ -25,5 +26,5 @@ * in the local module repositories. * - * It scans the files in the local modules repository (see {@see Preferences#getModulesDirectory()} + * It scans the files in the local modules repository (see {@link OdPlugin#getModulesDirectory()} * and extracts module information from three kind of files: *Index: /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadRemoteModuleInformationTask.java =================================================================== --- /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadRemoteModuleInformationTask.java (revision 34150) +++ /applications/editors/josm/plugins/opendata/src/org/openstreetmap/josm/plugins/opendata/core/modules/ReadRemoteModuleInformationTask.java (revision 34151) @@ -69,5 +69,5 @@ * Creates the task * - * @param monitor the progress monitor. Defaults to {@see NullProgressMonitor#INSTANCE} if null + * @param monitor the progress monitor. Defaults to {@link NullProgressMonitor#INSTANCE} if null * @param sites the collection of download sites. Defaults to the empty collection if null. */