[
https://issues.apache.org/jira/browse/JOSHUA-269?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15288473#comment-15288473
]
Lewis John McGibbney commented on JOSHUA-269:
---------------------------------------------
Man this is a beast. I've committed around 75% of that patch but there is still
more to do. It is taking a long time to go through this code and document
everything. For the Javadoc I do not know right now I am just entering TODO as
the documentation and we can address them later.
> Fix Javadoc in JOSHUA-252 branch to comply with JDK1.8 Spec
> -----------------------------------------------------------
>
> Key: JOSHUA-269
> URL: https://issues.apache.org/jira/browse/JOSHUA-269
> Project: Joshua
> Issue Type: Improvement
> Components: documentation
> Affects Versions: 6.0.5
> Reporter: Lewis John McGibbney
> Assignee: Lewis John McGibbney
> Priority: Blocker
> Fix For: 6.1
>
>
> When we build the JOSHUA-252 codebase on Jira, we get the following
> {code}
> [INFO]
> ------------------------------------------------------------------------
> [ERROR] BUILD ERROR
> [INFO]
> ------------------------------------------------------------------------
> [INFO] An error has occurred in JavaDocs report generation:
> Exit code: 1 -
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:629:
> warning: no @param for tbl
> public void get_ngrams(HashMap<String, Integer> tbl, int order,
> ArrayList<Integer> wrds,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:629:
> warning: no @param for order
> public void get_ngrams(HashMap<String, Integer> tbl, int order,
> ArrayList<Integer> wrds,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:629:
> warning: no @param for wrds
> public void get_ngrams(HashMap<String, Integer> tbl, int order,
> ArrayList<Integer> wrds,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:629:
> warning: no @param for ignore_null_equiv_symbol
> public void get_ngrams(HashMap<String, Integer> tbl, int order,
> ArrayList<Integer> wrds,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:45:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com> (Johns Hopkins University)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:45:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com> (Johns Hopkins University)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/OracleExtractionHG.java:91:
> warning: no description for @param
> * @param lm_feat_id_
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/SplitHg.java:33:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com> (Johns Hopkins University)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/oracle/SplitHg.java:33:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com> (Johns Hopkins University)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/browser/Browser.java:77:
> error: @param name not found
> * @param args the paths to the source, reference, and n-best files
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/browser/Browser.java:79:
> warning: no @param for argv
> public static void main(String[] argv) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/browser/Browser.java:79:
> warning: no @throws for java.io.IOException
> public static void main(String[] argv) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:165:
> warning: no @return
> public int size() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:172:
> warning: no @return
> public Node root() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:51:
> error: malformed HTML
> * @author Jonny Weese <jo...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:51:
> error: bad use of '>'
> * @author Jonny Weese <jo...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:105:
> warning: no @param for s
> public Tree(String s) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/ui/tree_visualizer/tree/Tree.java:234:
> warning: no @return
> public String label() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/AlignedSubsampler.java:57:
> warning: no @throws for java.io.IOException
> public void subsample(String filelist, float targetFtoERatio, String extf,
> String exte,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:85:
> warning: no @throws for java.io.IOException
> public void subsample(String filelist, float targetFtoERatio, String extf,
> String exte,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:97:
> warning: no @param for filelist
> protected void subsample(String filelist, float targetFtoERatio,
> PhraseWriter out,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:97:
> warning: no @param for targetFtoERatio
> protected void subsample(String filelist, float targetFtoERatio,
> PhraseWriter out,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:97:
> warning: no @param for out
> protected void subsample(String filelist, float targetFtoERatio,
> PhraseWriter out,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:97:
> warning: no @param for bcFactory
> protected void subsample(String filelist, float targetFtoERatio,
> PhraseWriter out,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:97:
> warning: no @throws for java.io.IOException
> protected void subsample(String filelist, float targetFtoERatio,
> PhraseWriter out,
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/AlignedSubsampler.java:35:
> error: reference not found
> * @see joshua.subsample.Subsampler
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/AlignedSubsampler.java:36:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/AlignedSubsampler.java:36:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Alignment.java:15:
> error: reference not found
> * @see joshua.corpus.alignment.Alignments
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Alignment.java:18:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Alignment.java:18:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:28:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:28:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:43:
> warning: no @param for foreignFileName
> public BiCorpus(String foreignFileName, String nativeFileName) throws
> IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:43:
> warning: no @param for nativeFileName
> public BiCorpus(String foreignFileName, String nativeFileName) throws
> IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:43:
> warning: no @throws for java.io.IOException
> public BiCorpus(String foreignFileName, String nativeFileName) throws
> IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:51:
> warning: no @param for foreignFileName
> public BiCorpus(String foreignFileName, String nativeFileName, String
> alignmentFileName)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:51:
> warning: no @param for nativeFileName
> public BiCorpus(String foreignFileName, String nativeFileName, String
> alignmentFileName)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:51:
> warning: no @param for alignmentFileName
> public BiCorpus(String foreignFileName, String nativeFileName, String
> alignmentFileName)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpus.java:51:
> warning: no @throws for java.io.IOException
> public BiCorpus(String foreignFileName, String nativeFileName, String
> alignmentFileName)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:55:
> warning: no @param for f
> public BiCorpus fromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:55:
> warning: no @return
> public BiCorpus fromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:55:
> warning: no @throws for java.io.IOException
> public BiCorpus fromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:60:
> warning: no @param for f
> public BiCorpus unalignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:60:
> warning: no @return
> public BiCorpus unalignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:60:
> warning: no @throws for java.io.IOException
> public BiCorpus unalignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:65:
> warning: no @param for f
> public BiCorpus alignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:65:
> warning: no @return
> public BiCorpus alignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:65:
> warning: no @throws for java.io.IOException
> public BiCorpus alignedFromFiles(String f) throws IOException {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:29:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/BiCorpusFactory.java:29:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhrasePair.java:18:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhrasePair.java:18:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhraseReader.java:20:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhraseReader.java:20:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhraseWriter.java:30:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/PhraseWriter.java:30:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:30:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/Subsampler.java:30:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:73:
> warning: no @return
> public Options getCliOptions() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:81:
> warning: no @return
> public String getClassName() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:89:
> warning: no @param for testFiles
> public void runSubsampler(String[] testFiles, int maxN, int targetCount,
> float ratio)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:89:
> warning: no @param for maxN
> public void runSubsampler(String[] testFiles, int maxN, int targetCount,
> float ratio)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:89:
> warning: no @param for targetCount
> public void runSubsampler(String[] testFiles, int maxN, int targetCount,
> float ratio)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:89:
> warning: no @param for ratio
> public void runSubsampler(String[] testFiles, int maxN, int targetCount,
> float ratio)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:89:
> warning: no @throws for java.io.IOException
> public void runSubsampler(String[] testFiles, int maxN, int targetCount,
> float ratio)
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:99:
> warning: no @param for args
> public void runMain(String[] args) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:31:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/subsample/SubsamplerCLI.java:31:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:129:
> error: @param name not found
> * @param tail
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:129:
> warning: no description for @param
> * @param tail
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:130:
> error: @param name not found
> * @param head
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:130:
> warning: no description for @param
> * @param head
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:133:
> warning: no @param for arc
> public int distance(Arc<Value> arc) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:144:
> error: @param name not found
> * @param linearChain
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:144:
> warning: no description for @param
> * @param linearChain
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:147:
> warning: no @param for source
> public static Lattice<Token> createTokenLatticeFromString(String source,
> JoshuaConfiguration config) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:147:
> warning: no @param for config
> public static Lattice<Token> createTokenLatticeFromString(String source,
> JoshuaConfiguration config) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:250:
> warning: no @param for config
> public static Lattice<String> createStringLatticeFromString(String data,
> JoshuaConfiguration config) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:332:
> warning: no @return
> public int getShortestDistance() {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:447:
> warning: no description for @param
> * @param i
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:448:
> warning: no description for @param
> * @param j
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:449:
> error: @param name not found
> * @param lattice
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:449:
> warning: no description for @param
> * @param lattice
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:451:
> warning: no @param for newNodes
> public void insert(int i, int j, List<Node<Value>> newNodes) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:42:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:42:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:45:
> error: invalid use of @param
> * @param Label Type of label associated with an arc.
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:77:
> warning: no @param for config
> public Lattice(List<Node<Value>> nodes, JoshuaConfiguration config) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Lattice.java:96:
> warning: no @param for config
> public Lattice(Value[] linearChain, JoshuaConfiguration config) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/lattice/Node.java:59:
> warning: no @param for id
> public Node(int id) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/BLEU.java:175:
> warning: no description for @param
> * @param stats
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/BLEU.java:176:
> warning: no description for @param
> * @param words
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/BLEU.java:177:
> warning: no description for @param
> * @param i
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/EvaluationMetric.java:216:
> warning: no description for @param
> * @param cand_strings
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/EvaluationMetric.java:217:
> warning: no description for @param
> * @param cand_indices
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/metrics/EvaluationMetric.java:218:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/tools/GrammarPacker.java:153:
> warning: no description for @throws
> * @throws IOException
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/tools/LabelPhrases.java:42:
> warning: no description for @throws
> * @throws IOException
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/tools/LabelPhrases.java:43:
> warning: no description for @throws
> * @throws NumberFormatException
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/tools/TestSetFilter.java:110:
> warning: no @param for sourceSide
> public boolean inTestSet(String sourceSide) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/tools/TestSetFilter.java:110:
> warning: no @return
> public boolean inTestSet(String sourceSide) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Phrase.java:97:
> warning: no @param for start
> Phrase subPhrase(int start, int end);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Phrase.java:97:
> warning: no @param for end
> Phrase subPhrase(int start, int end);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Phrase.java:97:
> warning: no @return
> Phrase subPhrase(int start, int end);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/BasicPhrase.java:15:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/BasicPhrase.java:15:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/ContiguousPhrase.java:182:
> warning: no @param for args
> public static void main(String[] args) {
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:39:
> warning: no @param for position
> int getWordID(int position);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:54:
> error: @param name not found
> * @param position Index into the corpus
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:57:
> warning: no @param for positions
> int[] getSentenceIndices(int[] positions);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:67:
> warning: no @param for sentenceID
> int getSentencePosition(int sentenceID);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:76:
> warning: no @param for sentenceID
> int getSentenceEndPosition(int sentenceID);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:125:
> warning: no description for @param
> * @param corpusStart
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:126:
> warning: no description for @param
> * @param phrase
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:127:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:143:
> warning: no description for @param
> * @param startPosition
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:144:
> warning: no description for @param
> * @param endPosition
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Corpus.java:145:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Span.java:93:
> warning: no description for @param
> * @param o
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Span.java:94:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:167:
> warning: nested tag not allowed: <code>
> * or the result of <code>getUnknownWordID<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:167:
> error: element not closed: code
> * or the result of <code>getUnknownWordID<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:167:
> error: element not closed: code
> * or the result of <code>getUnknownWordID<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:170:
> warning: no @param for wordString
> int getID(String wordString);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:194:
> warning: nested tag not allowed: <code>
> * Otherwise, the String returned by <code>getUnknownWord<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:199:
> warning: nested tag not allowed: <code>
> * <code>getUnknownWord</code> if the identifier
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:194:
> error: element not closed: code
> * Otherwise, the String returned by <code>getUnknownWord<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:194:
> error: element not closed: code
> * Otherwise, the String returned by <code>getUnknownWord<code>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:202:
> warning: no @param for wordID
> String getTerminal(int wordID);
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:228:
> warning: no description for @param
> * @param wordIDs
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:229:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:277:
> warning: no description for @param
> * @param id
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:308:
> warning: no description for @param
> * @param id
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:309:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:316:
> warning: no description for @param
> * @param word
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:317:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:324:
> warning: no description for @param
> * @param wordIDs
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:325:
> warning: no description for @param
> * @param ntIndexIncrements
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/SymbolTable.java:326:
> warning: no description for @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/TerminalIterator.java:78:
> warning: no description for @throws
> * @throws UnsupportedOperationException
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/TerminalIterator.java:42:
> error: @param name not found
> * @param vocab
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Vocabulary.java:86:
> error: @param name not found
> * @param file_name
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/corpus/Vocabulary.java:131:
> error: bad use of '>'
> * changing (e.g. OOV) ids. Constant ids could be immutable -> no locking.
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:38:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:38:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:336:
> error: malformed HTML
> * Computes BLEU statistics incurred by a rule. This is (a) all ngram (n <=
> 4) for terminal rules
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:350:
> error: invalid use of @param
> * @param rule the rule being applied
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:351:
> error: invalid use of @param
> * @param spanWidth the width of the span in the input sentence
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:352:
> error: invalid use of @param
> * @param references the reference to compute statistics against
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/BLEU.java:353:
> error: invalid use of @return
> * @return
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:442:
> error: invalid use of @return
> * @return an iterable set of Translation objects
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:83:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:83:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:84:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:84:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:85:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:85:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:86:
> error: malformed HTML
> * @author Lane Schwartz <dowob...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Decoder.java:86:
> error: bad use of '>'
> * @author Lane Schwartz <dowob...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/DecoderThread.java:47:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/DecoderThread.java:47:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/DecoderThread.java:48:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/DecoderThread.java:48:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaConfiguration.java:46:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaConfiguration.java:46:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaConfiguration.java:47:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaConfiguration.java:47:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:42:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:42:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:43:
> error: malformed HTML
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:43:
> error: bad use of '>'
> * @author wren ng thornton <w...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:44:
> error: malformed HTML
> * @author Lane Schwartz <dowob...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/JoshuaDecoder.java:44:
> error: bad use of '>'
> * @author Lane Schwartz <dowob...@users.sourceforge.net>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/NbestMinRiskReranker.java:45:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/NbestMinRiskReranker.java:45:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/StructuredTranslation.java:39:
> error: self-closing element not allowed
> * <br/>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Support.java:24:
> error: malformed HTML
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Support.java:24:
> error: bad use of '>'
> * @author Zhifei Li, <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Translation.java:44:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Translation.java:44:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Translations.java:33:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/Translations.java:33:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:141:
> error: reference not found
> * {@link LanguageModelFF} feature, this returns the new language model
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:152:
> error: @param name not found
> * @param sentID
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:167:
> error: @param name not found
> * @param sentID
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:189:
> error: @param name not found
> * @param sentID
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:210:
> error: @param name not found
> * @param sentID
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:229:
> error: @param name not found
> * @param sentID
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:274:
> error: @param name not found
> * @param rawArgs A string with the raw arguments and their names
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/ArityPhrasePenalty.java:36:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/ArityPhrasePenalty.java:37:
> error: malformed HTML
> * @author Zhifei Li <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/ArityPhrasePenalty.java:37:
> error: bad use of '>'
> * @author Zhifei Li <zhifei.w...@gmail.com>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:48:
> error: reference not found
> * cost (via {@link estimateCost()}); these values are not used in computing
> the
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:64:
> error: malformed HTML
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:64:
> error: bad use of '>'
> * @author Matt Post <p...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:65:
> error: malformed HTML
> * @author Juri Ganitkevich <j...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureFunction.java:65:
> error: bad use of '>'
> * @author Juri Ganitkevich <j...@cs.jhu.edu>
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureVector.java:141:
> error: @param name not found
> * @param names
> ^
> /home/jenkins/jenkins-slave/workspace/joshua_maven/src/main/java/org/apache/joshua/decoder/ff/FeatureVector.java:142:
> error: invalid use of @return
> * @return
> ^
> {code}
> We need to fix this before we can publish artifacts
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
