Author: yegor
Date: Wed Oct 6 08:55:30 2010
New Revision: 1004934
URL: http://svn.apache.org/viewvc?rev=1004934&view=rev
Log:
cleaned javadoc warnings
Removed:
poi/trunk/src/contrib/src/org/apache/
Modified:
poi/trunk/src/java/org/apache/poi/hssf/record/BoundSheetRecord.java
poi/trunk/src/java/org/apache/poi/hssf/record/DVRecord.java
poi/trunk/src/java/org/apache/poi/hssf/usermodel/DVConstraint.java
poi/trunk/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/IBody.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeader.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyle.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyles.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTable.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableCell.java
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableRow.java
poi/trunk/src/scratchpad/src/org/apache/poi/hwpf/model/CharIndexTranslator.java
Modified: poi/trunk/src/java/org/apache/poi/hssf/record/BoundSheetRecord.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/hssf/record/BoundSheetRecord.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/java/org/apache/poi/hssf/record/BoundSheetRecord.java
(original)
+++ poi/trunk/src/java/org/apache/poi/hssf/record/BoundSheetRecord.java Wed Oct
6 08:55:30 2010
@@ -85,7 +85,7 @@ public final class BoundSheetRecord exte
/**
* Set the sheetname for this sheet. (this appears in the tabs at the
bottom)
* @param sheetName the name of the sheet
- * @see {...@link
org.apache.poi.ss.util.WorkbookUtil#createSafeSheetName(String nameProposal)}
+ * @see org.apache.poi.ss.util.WorkbookUtil#createSafeSheetName(String
nameProposal)
* for a safe way to create valid names
* @throws IllegalArgumentException if sheet name will cause excel to
crash.
*/
Modified: poi/trunk/src/java/org/apache/poi/hssf/record/DVRecord.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/hssf/record/DVRecord.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/java/org/apache/poi/hssf/record/DVRecord.java (original)
+++ poi/trunk/src/java/org/apache/poi/hssf/record/DVRecord.java Wed Oct 6
08:55:30 2010
@@ -133,7 +133,7 @@ public final class DVRecord extends Stan
// --> start option flags
/**
* @return the condition data type
- * @see org.apache.poi.hssf.usermodel.DVConstraint.ValidationType
+ * @see
org.apache.poi.ss.usermodel.DataValidationConstraint.ValidationType
*/
public int getDataType() {
return opt_data_type.getValue(_option_flags);
@@ -141,7 +141,7 @@ public final class DVRecord extends Stan
/**
* @return the condition error style
- * @see org.apache.poi.hssf.usermodel.HSSFDataValidation.ErrorStyle
+ * @see org.apache.poi.ss.usermodel.DataValidation.ErrorStyle
*/
public int getErrorStyle() {
return opt_error_style.getValue(_option_flags);
Modified: poi/trunk/src/java/org/apache/poi/hssf/usermodel/DVConstraint.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/hssf/usermodel/DVConstraint.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/java/org/apache/poi/hssf/usermodel/DVConstraint.java
(original)
+++ poi/trunk/src/java/org/apache/poi/hssf/usermodel/DVConstraint.java Wed Oct
6 08:55:30 2010
@@ -90,9 +90,11 @@ public class DVConstraint implements Dat
* can be either standard Excel formulas or formatted number values. If
the expression starts
* with '=' it is parsed as a formula, otherwise it is parsed as a
formatted number.
*
- * @param validationType one of {...@link ValidationType#ANY},
{...@link ValidationType#DECIMAL},
- * {...@link ValidationType#INTEGER}, {...@link
ValidationType#TEXT_LENGTH}
- * @param comparisonOperator any constant from {...@link OperatorType}
enum
+ * @param validationType one of {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.ValidationType#ANY},
+ * {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.ValidationType#DECIMAL},
+ * {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.ValidationType#INTEGER},
+ * {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.ValidationType#TEXT_LENGTH}
+ * @param comparisonOperator any constant from {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.OperatorType} enum
* @param expr1 date formula (when first char is '=') or formatted
number value
* @param expr2 date formula (when first char is '=') or formatted
number value
*/
@@ -140,7 +142,7 @@ public class DVConstraint implements Dat
* formatted times, two formats are supported: "HH:MM" or "HH:MM:SS".
This is contrary to
* Excel which uses the default time format from the OS.
*
- * @param comparisonOperator constant from {...@link OperatorType} enum
+ * @param comparisonOperator constant from {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.OperatorType} enum
* @param expr1 date formula (when first char is '=') or formatted time
value
* @param expr2 date formula (when first char is '=') or formatted time
value
*/
@@ -166,7 +168,7 @@ public class DVConstraint implements Dat
* the same convention). To parse formatted dates, a date format needs
to be specified. This
* is contrary to Excel which uses the default short date format from
the OS.
*
- * @param comparisonOperator constant from {...@link OperatorType} enum
+ * @param comparisonOperator constant from {...@link
org.apache.poi.ss.usermodel.DataValidationConstraint.OperatorType} enum
* @param expr1 date formula (when first char is '=') or formatted date
value
* @param expr2 date formula (when first char is '=') or formatted date
value
* @param dateFormat ignored if both expr1 and expr2 are formulas.
Default value is "YYYY/MM/DD"
Modified: poi/trunk/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
(original)
+++ poi/trunk/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java Wed Oct
6 08:55:30 2010
@@ -326,7 +326,8 @@ public final class HSSFWorkbook extends
* contained strings will be written to the Shared String tabel
(SSTRecord) within
* the Workbook.
*
- * @param wb sheet's matching low level Workbook structure containing the
SSTRecord.
+ * @param records a collection of sheet's records.
+ * @param offset the offset to search at
* @see org.apache.poi.hssf.record.LabelRecord
* @see org.apache.poi.hssf.record.LabelSSTRecord
* @see org.apache.poi.hssf.record.SSTRecord
@@ -727,8 +728,8 @@ public final class HSSFWorkbook extends
*
* @param sheetname the name for the new sheet. Note - certain length
limits
* apply. See {...@link #setSheetName(int, String)}.
- * @see {...@link
org.apache.poi.ss.util.WorkbookUtil#createSafeSheetName(String nameProposal)}
- * for a safe way to create valid names
+ * @see org.apache.poi.ss.util.WorkbookUtil#createSafeSheetName(String
nameProposal)
+ * for a safe way to create valid names
* @return HSSFSheet representing the new sheet.
* @throws IllegalArgumentException
* if there is already a sheet present with a case-insensitive
Modified: poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/IBody.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/IBody.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/IBody.java (original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/IBody.java Wed Oct
6 08:55:30 2010
@@ -40,14 +40,14 @@ public interface IBody {
* returns the Part, to which the body belongs, which you need for
adding relationship to other parts
* Actually it is needed of the class XWPFTableCell. Because you have
to know to which part the tableCell
* belongs.
- * @return
+ * @return the Part, to which the body belongs
*/
IBody getPart();
/**
* get the PartType of the body, for example
* DOCUMENT, HEADER, FOOTER, FOOTNOTE,
- * @return
+ * @return the PartType of the body
*/
BodyType getPartType();
@@ -86,7 +86,6 @@ public interface IBody {
* the method will return this table
* if there is no corresponding {...@link XWPFTable} the method will
return null
* @param ctTable
- * @return
*/
public XWPFTable getTable(CTTbl ctTable);
@@ -103,14 +102,12 @@ public interface IBody {
/**
*inserts a new paragraph at position of the cursor
* @param cursor
- * @return
*/
public XWPFParagraph insertNewParagraph(XmlCursor cursor);
/**
* inserts a new Table at the cursor position.
* @param cursor
- * @return
*/
public XWPFTable insertNewTbl(XmlCursor cursor);
@@ -124,7 +121,6 @@ public interface IBody {
/**
* returns the TableCell to which the Table belongs
* @param cell
- * @return
*/
XWPFTableCell getTableCell(CTTc cell);
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFDocument.java
Wed Oct 6 08:55:30 2010
@@ -280,7 +280,6 @@ public class XWPFDocument extends POIXML
/**
* returns an Iterator with paragraphs and tables
* @see org.apache.poi.xwpf.usermodel.IBody#getBodyElements()
- * @return
*/
public List<IBodyElement> getBodyElements(){
return Collections.unmodifiableList(bodyElements);
@@ -295,7 +294,6 @@ public class XWPFDocument extends POIXML
/**
* @see org.apache.poi.xwpf.usermodel.IBody#getTables()
- * @return
*/
public List<XWPFTable> getTables(){
return Collections.unmodifiableList(tables);
@@ -313,52 +311,32 @@ public class XWPFDocument extends POIXML
/**
*
- * @return
+ * @return the list of footers
*/
public List<XWPFFooter> getFooterList(){
return Collections.unmodifiableList(footers);
}
- /**
- *
- * @param pos
- * @return
- */
public XWPFFooter getFooterArray(int pos){
return footers.get(pos);
}
/**
*
- * @return
+ * @return the list of headers
*/
public List<XWPFHeader> getHeaderList(){
return Collections.unmodifiableList(headers);
}
- /**
- *
- * @param pos
- * @return
- */
public XWPFHeader getHeaderArray(int pos){
return headers.get(pos);
}
- /**
- *
- * @param table
- * @return
- */
public String getTblStyle(XWPFTable table){
return table.getStyleID();
}
- /**
- *
- * @param id
- * @return
- */
public XWPFHyperlink getHyperlinkByID(String id) {
Iterator<XWPFHyperlink> iter = hyperlinks.iterator();
while(iter.hasNext())
@@ -371,36 +349,18 @@ public class XWPFDocument extends POIXML
return null;
}
- /**
- *
- * @param id
- * @return
- */
public XWPFFootnote getFootnoteByID(int id) {
return footnotes.get(id);
}
- /**
- *
- * @param id
- * @return
- */
public XWPFFootnote getEndnoteByID(int id) {
return endnotes.get(id);
}
- /**
- *
- * @return
- */
public Collection<XWPFFootnote> getFootnotes() {
return Collections.unmodifiableCollection(footnotes == null ? new
ArrayList<XWPFFootnote>() : footnotes.values());
}
- /**
- *
- * @return
- */
public XWPFHyperlink[] getHyperlinks() {
return hyperlinks.toArray(
new XWPFHyperlink[hyperlinks.size()]
@@ -547,7 +507,6 @@ public class XWPFDocument extends POIXML
/**
* add a new paragraph at position of the cursor
* @param cursor
- * @return
*/
public XWPFParagraph insertNewParagraph(XmlCursor cursor){
if(isCursorInBody(cursor)){
@@ -583,11 +542,6 @@ public class XWPFDocument extends POIXML
return null;
}
- /**
- *
- * @param cursor
- * @return
- */
public XWPFTable insertNewTbl(XmlCursor cursor) {
if(isCursorInBody(cursor)){
String uri = CTTbl.type.getName().getNamespaceURI();
@@ -626,7 +580,6 @@ public class XWPFDocument extends POIXML
/**
* verifies that cursor is on the right position
* @param cursor
- * @return
*/
private boolean isCursorInBody(XmlCursor cursor) {
XmlCursor verify = cursor.newCursor();
@@ -642,7 +595,6 @@ public class XWPFDocument extends POIXML
/**
* get position of the paragraph
* @param p
- * @return
*/
public Integer getPosOfParagraph(XWPFParagraph p){
int i, pos = 0;
@@ -740,8 +692,7 @@ public class XWPFDocument extends POIXML
}
/**
- * get the LastParagraph of the document
- * @return
+ * @return the LastParagraph of the document
*/
public XWPFParagraph getLastParagraph(){
int lastPos = paragraphs.toArray().length - 1;
@@ -787,8 +738,9 @@ public class XWPFDocument extends POIXML
}
}
- /**Replace content of table in array tables at position pos with a
- * @param pos, table
+ /**Replace content of table in array tables at position pos with a
+ * @param pos
+ * @param table
*/
public void setTable(int pos, XWPFTable table){
tables.set(pos, table);
@@ -938,7 +890,7 @@ public class XWPFDocument extends POIXML
/**
* inserts an existing XWPFTable to the arrays bodyElements and tables
- * @param i
+ * @param pos
* @param table
*/
public void insertTable(int pos, XWPFTable table) {
@@ -953,10 +905,6 @@ public class XWPFDocument extends POIXML
tables.add(i, table);
}
- /**
- *
- * @return
- */
public List<XWPFPictureData> getAllPictures() {
if(pictures == null){
pictures = new ArrayList<XWPFPictureData>();
@@ -970,8 +918,7 @@ public class XWPFDocument extends POIXML
}
/**
- * get all Pictures in this package
- * @return
+ * @return all Pictures in this package
*/
public List<XWPFPictureData> getAllPackagePictures(){
List<XWPFPictureData> pkgpictures = new ArrayList<XWPFPictureData>();
@@ -1006,7 +953,7 @@ public class XWPFDocument extends POIXML
/**
* Adds a picture to the document.
*
- * @param is The stream to read image from
+ * @param pictureData The bytes to read image from
* @param format The format of the picture.
*
* @return the index to this picture (0 based), the added picture can be
obtained from {...@link #getAllPictures()} .
@@ -1023,7 +970,7 @@ public class XWPFDocument extends POIXML
/**
* get the next free ImageNumber
* @param format
- * @return
+ * @return the next free ImageNumber
* @throws InvalidFormatException
*/
public int getNextPicNameNumber(int format) throws InvalidFormatException{
@@ -1067,7 +1014,7 @@ public class XWPFDocument extends POIXML
/**
* get Styles
- * @return
+ * @return styles for this document
*/
public XWPFStyles getStyles(){
return styles;
@@ -1075,8 +1022,9 @@ public class XWPFDocument extends POIXML
/**
* get the paragraph with the CTP class p
+ *
* @param p
- * @return
+ * @return the paragraph with the CTP class p
*/
public XWPFParagraph getParagraph(CTP p){
for(int i=0; i<getParagraphs().size(); i++){
@@ -1089,7 +1037,7 @@ public class XWPFDocument extends POIXML
* get a table by its CTTbl-Object
* @param ctTbl
* @see
org.apache.poi.xwpf.usermodel.IBody#getTable(org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTbl)
- * @return
+ * @return a table by its CTTbl-Object or null
*/
public XWPFTable getTable(CTTbl ctTbl) {
for(int i=0; i<tables.size(); i++){
@@ -1132,8 +1080,8 @@ public class XWPFDocument extends POIXML
/**
* get the PartType of the body, for example
- * DOCUMENT, HEADER, FOOTER, FOOTNOTE,
- * @return
+ * DOCUMENT, HEADER, FOOTER, FOOTNOTE,
+ *
* @see org.apache.poi.xwpf.usermodel.IBody#getPartType()
*/
public BodyType getPartType() {
@@ -1142,8 +1090,7 @@ public class XWPFDocument extends POIXML
/**
* get the TableCell which belongs to the TableCell
- * @param o
- * @return
+ * @param cell
*/
public XWPFTableCell getTableCell(CTTc cell) {
XmlCursor cursor = cell.newCursor();
Modified: poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeader.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeader.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeader.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeader.java Wed
Oct 6 08:55:30 2010
@@ -103,7 +103,6 @@ public class XWPFHeader extends XWPFHead
/**
* reads the document
- * @overide onDocumentRead of class {...@link POIXMLDocumentPart}
*/
@Override
protected void onDocumentRead(){
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
---
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java
(original)
+++
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFHeaderFooter.java
Wed Oct 6 08:55:30 2010
@@ -142,7 +142,6 @@ public abstract class XWPFHeaderFooter e
* the method will return this table
* if there is no corresponding {...@link XWPFTable} the method will
return null
* @param ctTable
- * @return
*/
public XWPFTable getTable(CTTbl ctTable){
for (XWPFTable table : tables) {
@@ -202,7 +201,7 @@ public abstract class XWPFHeaderFooter e
/**
* get all Pictures in this package
- * @return
+ * @return all Pictures in this package
*/
public List<XWPFPictureData> getAllPackagePictures(){
List<XWPFPictureData> pkgpictures = new ArrayList<XWPFPictureData>();
@@ -237,7 +236,7 @@ public abstract class XWPFHeaderFooter e
/**
* Adds a picture to the document.
*
- * @param is The stream to read image from
+ * @param pictureData The picture bytes
* @param format The format of the picture.
*
* @return the index to this picture (0 based), the added picture can be
obtained from {...@link #getAllPictures()} .
@@ -260,7 +259,7 @@ public abstract class XWPFHeaderFooter e
/**
* get the next free ImageNumber
* @param format
- * @return
+ * @return the next free ImageNumber
*/
public int getNextPicNameNumber(int format){
int img = getAllPackagePictures().size()+1;
@@ -301,7 +300,8 @@ public abstract class XWPFHeaderFooter e
/**
* Add the picture to drawing relations
*
- * @param img the PictureData of the Picture,
+ * @param pictureData the picture bytes
+ * @param format the picture format
*/
public PackageRelationship addPictureReference(byte[] pictureData, int
format){
int imageNumber = getNextPicNameNumber(format);
@@ -322,7 +322,7 @@ public abstract class XWPFHeaderFooter e
/**
* Add the picture to drawing relations
*
- * @param img the PictureData of the Picture,
+ * @param is the stream to read picture data from
*/
public PackageRelationship addPictureReference(InputStream is, int
format){
@@ -345,7 +345,7 @@ public abstract class XWPFHeaderFooter e
/**
* add a new paragraph at position of the cursor
* @param cursor
- * @return
+ * @return the inserted paragraph
*/
public XWPFParagraph insertNewParagraph(XmlCursor cursor){
if(isCursorInHdrF(cursor)){
@@ -385,7 +385,7 @@ public abstract class XWPFHeaderFooter e
/**
*
* @param cursor
- * @return
+ * @return the inserted table
*/
public XWPFTable insertNewTbl(XmlCursor cursor) {
if(isCursorInHdrF(cursor)){
@@ -425,7 +425,6 @@ public abstract class XWPFHeaderFooter e
/**
* verifies that cursor is on the right position
* @param cursor
- * @return
*/
private boolean isCursorInHdrF(XmlCursor cursor) {
XmlCursor verify = cursor.newCursor();
@@ -455,7 +454,7 @@ public abstract class XWPFHeaderFooter e
/**
* inserts an existing XWPFTable to the arrays bodyElements and tables
- * @param i
+ * @param pos
* @param table
*/
public void insertTable(int pos, XWPFTable table) {
@@ -497,8 +496,7 @@ public abstract class XWPFHeaderFooter e
/**
* get the TableCell which belongs to the TableCell
- * @param o
- * @return
+ * @param cell
*/
public XWPFTableCell getTableCell(CTTc cell) {
XmlCursor cursor = cell.newCursor();
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFNumbering.java
Wed Oct 6 08:55:30 2010
@@ -232,7 +232,7 @@ public class XWPFNumbering extends POIXM
*return the abstractNumID
*If the AbstractNumID not exists
*return null
- * @param num
+ * @param numID
* @return abstractNumID
*/
public BigInteger getAbstractNumID(BigInteger numID){
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
Wed Oct 6 08:55:30 2010
@@ -1106,8 +1106,7 @@ public class XWPFParagraph implements IB
* If it finds the string, it will return true and the position of the
String
* will be saved in the parameter startPos.
* @param searched
- * @param pos
- * @return
+ * @param startPos
*/
public TextSegement searchText(String searched,PositionInParagraph
startPos){
@@ -1172,7 +1171,7 @@ public class XWPFParagraph implements IB
/**
* insert a new Run in RunArray
* @param pos
- * @return
+ * @return the inserted run
*/
public XWPFRun insertNewRun(int pos){
if (pos >= 0 && pos <= paragraph.sizeOfRArray()) {
@@ -1188,8 +1187,7 @@ public class XWPFParagraph implements IB
/**
* get a Text
- * @param posList
- * @return
+ * @param segment
*/
public String getText(TextSegement segment){
int runBegin = segment.getBeginRun();
@@ -1223,7 +1221,7 @@ public class XWPFParagraph implements IB
/**
* removes a Run at the position pos in the paragraph
* @param pos
- * @return
+ * @return true if the run was removed
*/
public boolean removeRun(int pos){
if (pos >= 0 && pos < paragraph.sizeOfRArray()){
@@ -1263,8 +1261,6 @@ public class XWPFParagraph implements IB
/**
* adds a new Run to the Paragraph
- * @param r
- * @return
*/
public void addRun(XWPFRun r){
runs.add(r);
@@ -1272,8 +1268,6 @@ public class XWPFParagraph implements IB
/**
* return the XWPFRun-Element which owns the CTR run-Element
- * @param r
- * @return
*/
public XWPFRun getRun(CTR r){
for(int i=0; i < getRuns().size(); i++){
Modified: poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyle.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyle.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyle.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyle.java Wed
Oct 6 08:55:30 2010
@@ -109,7 +109,6 @@ public class XWPFStyle {
/**
* get StyleID of the linked Style
- * @return
*/
public String getLinkStyleID(){
if (ctStyle.getLink()!=null)
@@ -120,7 +119,6 @@ public class XWPFStyle {
/**
* get StyleID of the next style
- * @return
*/
public String getNextStyleID(){
if(ctStyle.getNext()!=null)
@@ -138,7 +136,6 @@ public class XWPFStyle {
/**
* compares the names of the Styles
* @param compStyle
- * @return
*/
public boolean hasSameName(XWPFStyle compStyle){
CTStyle ctCompStyle = compStyle.getCTStyle();
Modified: poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyles.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyles.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyles.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFStyles.java Wed
Oct 6 08:55:30 2010
@@ -177,7 +177,6 @@ public class XWPFStyles extends POIXMLDo
/**
* get latentstyles
- * @return
*/
public XWPFLatentStyles getLatentStyles() {
return latentStyles;
@@ -186,8 +185,6 @@ public class XWPFStyles extends POIXMLDo
/**
* get the style with the same name
* if this style is not existing, return null
- * @param style
- * @return
*/
public XWPFStyle getStyleWithSameName(XWPFStyle style){
for (XWPFStyle ownStyle : listStyle) {
Modified: poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTable.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTable.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTable.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTable.java Wed
Oct 6 08:55:30 2010
@@ -250,7 +250,7 @@ public class XWPFTable implements IBodyE
/**
* inserts a new tablerow
* @param pos
- * @return
+ * @return the inserted row
*/
public XWPFTableRow insertNewTableRow(int pos){
if(pos >= 0 && pos <= tableRows.size()){
@@ -276,11 +276,6 @@ public class XWPFTable implements IBodyE
return false;
}
- /**
- *
- * @param pos
- * @return
- */
public List<XWPFTableRow> getRows() {
return tableRows;
}
@@ -318,8 +313,6 @@ public class XWPFTable implements IBodyE
/**
* returns the XWPFRow which belongs to the CTRow row
* if this row is not existing in the table null will be returned
- * @param row
- * @return
*/
public XWPFTableRow getRow(CTRow row) {
for(int i=0; i<getRows().size(); i++){
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableCell.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableCell.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableCell.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableCell.java
Wed Oct 6 08:55:30 2010
@@ -77,7 +77,6 @@ public class XWPFTableCell implements IB
/**
* returns an Iterator with paragraphs and tables
* @see org.apache.poi.xwpf.usermodel.IBody#getBodyElements()
- * @return
*/
public List<IBodyElement> getBodyElements(){
return Collections.unmodifiableList(bodyElements);
@@ -92,7 +91,6 @@ public class XWPFTableCell implements IB
/**
* returns a list of paragraphs
- * @return
*/
public List<XWPFParagraph> getParagraphs(){
return paragraphs;
@@ -155,7 +153,7 @@ public class XWPFTableCell implements IB
/**
* add a new paragraph at position of the cursor
* @param cursor
- * @return
+ * @return the inserted paragraph
*/
public XWPFParagraph insertNewParagraph(XmlCursor cursor){
if(!isCursorInTableCell(cursor))
@@ -191,11 +189,6 @@ public class XWPFTableCell implements IB
return newP;
}
- /**
- *
- * @param cursor
- * @return
- */
public XWPFTable insertNewTbl(XmlCursor cursor) {
if(isCursorInTableCell(cursor)){
String uri = CTTbl.type.getName().getNamespaceURI();
@@ -233,8 +226,6 @@ public class XWPFTableCell implements IB
/**
* verifies that cursor is on the right position
- * @param cursor
- * @return
*/
private boolean isCursorInTableCell(XmlCursor cursor) {
XmlCursor verify = cursor.newCursor();
@@ -290,7 +281,7 @@ public class XWPFTableCell implements IB
/**
- * @see org.apache.poi.xwpf.usermodel.IBodyPart#getTableArray(int)
+ * @see org.apache.poi.xwpf.usermodel.IBody#getTableArray(int)
*/
public XWPFTable getTableArray(int pos) {
if(pos > 0 && pos < tables.size()){
@@ -301,7 +292,7 @@ public class XWPFTableCell implements IB
/**
- * @see org.apache.poi.xwpf.usermodel.IBodyPart#getTables()
+ * @see org.apache.poi.xwpf.usermodel.IBody#getTables()
*/
public List<XWPFTable> getTables() {
return Collections.unmodifiableList(tables);
@@ -335,8 +326,6 @@ public class XWPFTableCell implements IB
/**
* get the TableCell which belongs to the TableCell
- * @param o
- * @return
*/
public XWPFTableCell getTableCell(CTTc cell) {
XmlCursor cursor = cell.newCursor();
Modified:
poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableRow.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableRow.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
--- poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableRow.java
(original)
+++ poi/trunk/src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFTableRow.java
Wed Oct 6 08:55:30 2010
@@ -57,10 +57,6 @@ public class XWPFTableRow {
return tableCell;
}
- /**
- * @param pos
- * @return
- */
public XWPFTableCell getCell(int pos) {
if (pos >= 0 && pos < ctRow.sizeOfTcArray()) {
return getTableCells().get(pos);
@@ -70,7 +66,6 @@ public class XWPFTableRow {
/**
* adds a new TableCell at the end of this tableRow
- * @return
*/
public XWPFTableCell addNewTableCell(){
CTTc cell = ctRow.addNewTc();
@@ -138,8 +133,6 @@ public class XWPFTableRow {
/**
* returns the XWPFTableCell which belongs to the CTTC cell
* if there is no XWPFTableCell which belongs to the parameter CTTc
cell null will be returned
- * @param cell
- * @return
*/
public XWPFTableCell getTableCell(CTTc cell) {
for(int i=0; i<tableCells.size(); i++){
Modified:
poi/trunk/src/scratchpad/src/org/apache/poi/hwpf/model/CharIndexTranslator.java
URL:
http://svn.apache.org/viewvc/poi/trunk/src/scratchpad/src/org/apache/poi/hwpf/model/CharIndexTranslator.java?rev=1004934&r1=1004933&r2=1004934&view=diff
==============================================================================
---
poi/trunk/src/scratchpad/src/org/apache/poi/hwpf/model/CharIndexTranslator.java
(original)
+++
poi/trunk/src/scratchpad/src/org/apache/poi/hwpf/model/CharIndexTranslator.java
Wed Oct 6 08:55:30 2010
@@ -50,7 +50,7 @@ public interface CharIndexTranslator {
* Return first index >= bytePos that is in table
*
* @param bytePos
- * @return
+ * @return first index greater or equal to bytePos that is in table
*/
public int lookIndexForward(int bytePos);
@@ -58,7 +58,7 @@ public interface CharIndexTranslator {
* Return last index <= bytePos that is in table
*
* @param bytePos
- * @return
+ * @return last index less of equal to bytePos that is in table
*/
public int lookIndexBackward(int bytePos);
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
