Author: mostarda
Date: Sat Mar 24 20:21:03 2012
New Revision: 1304906

URL: http://svn.apache.org/viewvc?rev=1304906&view=rev
Log:
Removed javadoc warnings. Commit related to issue #ANY23-66 .

Modified:
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/annotations/package-info.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataExtractor.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/package-info.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdf/TriXExtractor.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
    
incubator/any23/trunk/core/src/main/java/org/apache/any23/util/StringUtils.java
    incubator/any23/trunk/core/src/main/java/org/apache/any23/vocab/CSV.java
    
incubator/any23/trunk/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
    
incubator/any23/trunk/plugins/html-scraper/src/main/java/org/apache/any23/plugin/htmlscraper/package-info.java
    
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/plugin/officescraper/ExcelExtractor.java
    
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/vocab/Excel.java

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -45,7 +45,7 @@ import java.util.Arrays;
  * It automatically detects fields <i>delimiter</i>. If not able uses
  * the one provided in the <i>Any23</i> configuration.
  *
- * @see {@link CSVReaderBuilder}
+ * @see CSVReaderBuilder
  * @author Davide Palmisano ( [email protected] )
  */
 public class CSVExtractor implements Extractor.ContentExtractor {

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
 Sat Mar 24 20:21:03 2012
@@ -74,7 +74,8 @@ public class CSVReaderBuilder {
      * Checks whether the given input stream is a CSV or not.
      *
      * @param is input stream to be verified.
-     * @return
+     * @return <code>true</code> if the given <code>is</code> input stream 
contains a <i>CSV</i> content.
+     *         <code>false</code> otherwise.
      * @throws IOException
      */
     public static boolean isCSV(InputStream is) throws IOException {

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -61,9 +61,6 @@ public class HTMLMetaExtractor implement
 
     private String documentLang;
 
-    /**
-     * {@inheritDoc}
-     */
     public final static ExtractorFactory<HTMLMetaExtractor> factory =
             SimpleExtractorFactory.create(
                     NAME,

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -243,7 +243,7 @@ public abstract class MicroformatExtract
      * This method checks if there is a native nesting relationship between two
      * {@link MicroformatExtractor}.
      *
-     * @see {@link org.apache.any23.extractor.html.annotations.Includes}
+     * @see org.apache.any23.extractor.html.annotations.Includes
      * @param including the including {@link MicroformatExtractor}
      * @param included the included {@link MicroformatExtractor}
      * @return <code>true</code> if there is a declared nesting relationship

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/annotations/package-info.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/annotations/package-info.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/annotations/package-info.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/html/annotations/package-info.java
 Sat Mar 24 20:21:03 2012
@@ -19,6 +19,6 @@
  *  This package contains the annotations needed to describe the
  *  single nesting relations among different <a 
href="http://microformats.org/";>Microformats</a>.
  *
- *  @see {@link org.apache.any23.extractor.html.MicroformatExtractor}
+ *  @see org.apache.any23.extractor.html.MicroformatExtractor
  */
 package org.apache.any23.extractor.html.annotations;
\ No newline at end of file

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataExtractor.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -54,7 +54,7 @@ import java.util.Set;
 
 /**
  * Default implementation of <a 
href="http://www.w3.org/TR/microdata/";>Microdata</a> extractor,
- * based on {@link TagSoupDOMExtractor}.
+ * based on {@link org.apache.any23.extractor.Extractor.TagSoupDOMExtractor}.
  *
  * @author Michele Mostarda ([email protected])
  * @author Davide Palmisano ( [email protected] )

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
 Sat Mar 24 20:21:03 2012
@@ -168,8 +168,9 @@ public class MicrodataParser {
      * @param document document to be processed.
      * @param errorMode error management policy.
      * @return list of <b>itemscope</b> items.
-     * @throws MicrodataParserException if <code>errorMode == {@link 
ErrorMode#StopAtFirstError}</code>
-     *                                  and an error occurs.
+     * @throws MicrodataParserException if
+     *         <code>errorMode == {@link 
org.apache.any23.extractor.microdata.MicrodataParser.ErrorMode#StopAtFirstError}</code>
+     *         and an error occurs.
      */
     public static MicrodataParserReport getMicrodata(Document document, 
ErrorMode errorMode)
     throws MicrodataParserException {

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/package-info.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/package-info.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/package-info.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/package-info.java
 Sat Mar 24 20:21:03 2012
@@ -16,6 +16,6 @@
  */
 
 /**
- * This package contains classes and interfaces modeling the {@link Extractor} 
<i>API</i>.
+ * This package contains classes and interfaces modeling the {@link 
org.apache.any23.extractor.Extractor} <i>API</i>.
  */
 package org.apache.any23.extractor;
\ No newline at end of file

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdf/TriXExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdf/TriXExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdf/TriXExtractor.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdf/TriXExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -27,7 +27,7 @@ import org.openrdf.rio.helpers.RDFParser
 import java.util.Arrays;
 
 /**
- * Concrete implementation of {@link ContentExtractor}
+ * Concrete implementation of {@link 
org.apache.any23.extractor.Extractor.ContentExtractor}
  * to perform extraction on <a href="http://www.w3.org/2004/03/trix/";>TriX</a> 
documents.
  *
  * @author Michele Mostarda ([email protected])

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
 (original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
 Sat Mar 24 20:21:03 2012
@@ -119,7 +119,7 @@ public class RDFa11Parser {
      * normalizing blanks where present.
      *
      * @param prefixesDeclaration
-     * @return
+     * @return list of extracted prefixes.
      */
     protected static String[] extractPrefixSections(String 
prefixesDeclaration) {
         final String[] parts = prefixesDeclaration.split("\\s");
@@ -317,7 +317,7 @@ public class RDFa11Parser {
      *
      * @param n current node.
      * @param curieOrURIList list of CURIE/URI.
-     * @return
+     * @return list of resolved URIs.
      * @throws URISyntaxException
      */
     protected URI[] resolveCurieOrURIList(Node n, String curieOrURIList, 
boolean termAllowed)
@@ -341,8 +341,8 @@ public class RDFa11Parser {
     /**
      * Resolves a URI string as URI.
      *
-     * @param uriStr
-     * @return
+     * @param uriStr (partial) URI string to be resolved.
+     * @return the resolved URI.
      */
     protected URI resolveURI(String uriStr) {
         return

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/util/StringUtils.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/util/StringUtils.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/main/java/org/apache/any23/util/StringUtils.java 
(original)
+++ 
incubator/any23/trunk/core/src/main/java/org/apache/any23/util/StringUtils.java 
Sat Mar 24 20:21:03 2012
@@ -81,7 +81,8 @@ public class StringUtils {
      *
      * @param candidatePrefix
      * @param container
-     * @return
+     * @return <code>true</code> if <code>candidatePrefix</code> is prefix of 
<code>container</code>,
+     *         <code>false</code> otherwise.
      */
     public static boolean isPrefix(String candidatePrefix, String container) {
         if(candidatePrefix == null || container == null) {
@@ -103,7 +104,8 @@ public class StringUtils {
      *
      * @param candidateSuffix
      * @param container
-     * @return
+     * @return <code>true</code> if <code>candidateSuffix</code> is prefix of 
<code>container</code>,
+     *         <code>false</code> otherwise.
      */
     public static boolean isSuffix(String candidateSuffix, String container) {
         if(candidateSuffix == null || container == null) {

Modified: 
incubator/any23/trunk/core/src/main/java/org/apache/any23/vocab/CSV.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/main/java/org/apache/any23/vocab/CSV.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- incubator/any23/trunk/core/src/main/java/org/apache/any23/vocab/CSV.java 
(original)
+++ incubator/any23/trunk/core/src/main/java/org/apache/any23/vocab/CSV.java 
Sat Mar 24 20:21:03 2012
@@ -91,7 +91,7 @@ public class CSV extends Vocabulary {
     /**
      *
      * @param localName
-     * @return
+     * @return the new URI instance.
      */
     public URI createProperty(String localName) {
         return createProperty(NS, localName);

Modified: 
incubator/any23/trunk/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
 (original)
+++ 
incubator/any23/trunk/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
 Sat Mar 24 20:21:03 2012
@@ -149,7 +149,7 @@ public class SingleDocumentExtractionTes
      * since {@link org.apache.any23.extractor.html.HCardExtractor} declared a 
native nesting
      * with the {@link org.apache.any23.extractor.html.AdrExtractor}.
      *
-     * @see {@link org.apache.any23.extractor.html.annotations.Includes}
+     * @see org.apache.any23.extractor.html.annotations.Includes
      * @throws IOException
      * @throws ExtractionException
      * @throws RepositoryException

Modified: 
incubator/any23/trunk/plugins/html-scraper/src/main/java/org/apache/any23/plugin/htmlscraper/package-info.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/plugins/html-scraper/src/main/java/org/apache/any23/plugin/htmlscraper/package-info.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/plugins/html-scraper/src/main/java/org/apache/any23/plugin/htmlscraper/package-info.java
 (original)
+++ 
incubator/any23/trunk/plugins/html-scraper/src/main/java/org/apache/any23/plugin/htmlscraper/package-info.java
 Sat Mar 24 20:21:03 2012
@@ -16,7 +16,7 @@
  */
 
 /**
- * The {@link HTMLScraperExtractor} is a special extractor
+ * The {@link org.apache.any23.plugin.htmlscraper.HTMLScraperExtractor} is a 
special extractor
  * to scrape textual content from a generic <i>HTML</i> pages.
  */
 package org.apache.any23.plugin.htmlscraper;

Modified: 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/plugin/officescraper/ExcelExtractor.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/plugin/officescraper/ExcelExtractor.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/plugin/officescraper/ExcelExtractor.java
 (original)
+++ 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/plugin/officescraper/ExcelExtractor.java
 Sat Mar 24 20:21:03 2012
@@ -42,7 +42,7 @@ import java.io.InputStream;
 import java.util.Arrays;
 
 /**
- * Implementation of {@link ContentExtractor} able to process
+ * Implementation of {@link 
org.apache.any23.extractor.Extractor.ContentExtractor} able to process
  * a <i>MS Excel 97-2007+</i> file format <i>.xls/.xlsx</i> and
  * convert the detected content to triples.
  * This extractor is based on

Modified: 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/vocab/Excel.java
URL: 
http://svn.apache.org/viewvc/incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/vocab/Excel.java?rev=1304906&r1=1304905&r2=1304906&view=diff
==============================================================================
--- 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/vocab/Excel.java
 (original)
+++ 
incubator/any23/trunk/plugins/office-scraper/src/main/java/org/apache/any23/vocab/Excel.java
 Sat Mar 24 20:21:03 2012
@@ -125,7 +125,7 @@ public class Excel extends Vocabulary {
     /**
      *
      * @param localName
-     * @return
+     * @return the new URI instance.
      */
     public URI createProperty(String localName) {
         return createProperty(NS, localName);


Reply via email to