[Netarchivesuite-devel] Errors in javadoc. Please fix the errors now

[Colin Rosenthal]

Søren Vejrup Carlsen wrote:
> Hi all.
> The following errors are shown when generating the javadoc for the NetarchiveSuite:
>
> [javadoc] Building tree for all the packages and classes...
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/archive/bitarchive/distribute/BitarchiveClient.java:222: warning - @param argument "msg" is not a parameter name.
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/archive/checksum/ChecksumArchive.java:74: warning - @param argument "incorrectChecksum" is not a parameter name.
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/archive/checksum/FileChecksumArchive.java:634: warning - @param argument "rf" is not a parameter name.
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/archive/checksum/FileChecksumArchive.java:634: warning - @param argument "incorrectChecksum" is not a parameter name.
>   
This is a good example of why it would be expensive to maintain the 
copycode package. I will fix these javadoc warnings, and mark the 
package as deprecated.

>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see:illegal character: "58" in "http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax"
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see:illegal character: "47" in "http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax"
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see:illegal character: "47" in "http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax"
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see:illegal character: "47" in "http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax"
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see:illegal character: "47" in "http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax"
>   [javadoc] /home/svc/workspace/netarchivesuite/src/dk/netarkivet/wayback/batch/copycode/NetarchiveSuiteUURIFactory.java:547: warning - Tag @see: reference not found: http://www.faqs.org/rfcs/rfc1738.html Section 3.1. Common Internet
>   [javadoc]  Scheme Syntax
>   [javadoc] Building index for all the packages and classes...
>   [javadoc] Building index for all classes...
>   [javadoc] Generating /home/svc/workspace/netarchivesuite/docs/apidocs/stylesheet.css...
>   [javadoc] 11 warnings
>
> Could the authors of the last changes please fix these errors now!
>
> Regards
>
> Søren Vejrup Carlsen, QA
> _______________________________________________
> Netarchivesuite-devel mailing list
> Netarchivesuite-devel at lists.gforge.statsbiblioteket.dk
> https://lists.gforge.statsbiblioteket.dk/mailman/listinfo/netarchivesuite-devel
>