tags 1026608 patch thanksSee the attached patch which resolves the HTML errors to generate the JavaDoc and make the package build successfully.
-- mvh / best regards Hans Joachim Desserud http://desserud.org
Description: Fix HTML errors in Javadoc causing build failures Remove <tt> tags, not part of HTML5 Replace <> wrapping author emails Drop <> around generic T which is mistaken for HTML tag Resolved based on how it was solved upstream: https://github.com/cbeust/jcommander/commit/c31f983ae8f56a5b06f502009dfb32baa2be96f1 https://github.com/cbeust/jcommander/commit/7b46f253f625c91b47ef7e0780c01ffd357f4cd2 --- Origin: upstream, Forwarded: not-needed Last-Update: 2022-12-21 --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/Parameter.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/Parameter.java @@ -69,15 +69,15 @@ public @interface Parameter { boolean password() default false; /** - * The string converter to use for this field. If the field is of type <tt>List</tt> - * and not <tt>listConverter</tt> attribute was specified, JCommander will split + * The string converter to use for this field. If the field is of type List + * and not listConverter attribute was specified, JCommander will split * the input in individual values and convert each of them separately. */ Class<? extends IStringConverter<?>> converter() default NoConverter.class; /** * The list string converter to use for this field. If it's specified, the - * field has to be of type <tt>List</tt> and the converter needs to return + * field has to be of type List and the converter needs to return * a List that's compatible with that type. */ Class<? extends IStringConverter<?>> listConverter() default NoConverter.class; @@ -103,7 +103,7 @@ public @interface Parameter { boolean variableArity() default false; /** - * What splitter to use (applicable only on fields of type <tt>List</tt>). By default, + * What splitter to use (applicable only on fields of type List). By default, * a comma separated splitter will be used. */ Class<? extends IParameterSplitter> splitter() default CommaParameterSplitter.class; --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/IParameterValidator.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/IParameterValidator.java @@ -21,7 +21,7 @@ package com.beust.jcommander; /** * The class used to validate parameters. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ public interface IParameterValidator { --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/IStringConverter.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/IStringConverter.java @@ -33,7 +33,7 @@ package com.beust.jcommander; */ public interface IStringConverter<T> { /** - * @return an object of type <T> created from the parameter value. + * @return an object of type T created from the parameter value. */ T convert(String value); } --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/JCommander.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/JCommander.java @@ -42,7 +42,7 @@ import java.util.concurrent.CopyOnWriteA * or an instance of Iterable. In the case of an array or Iterable, JCommander will collect * the \@Parameter annotations from all the objects passed in parameter. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ public class JCommander { public static final String DEBUG_PROPERTY = "jcommander.debug"; --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/MissingCommandException.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/MissingCommandException.java @@ -21,7 +21,7 @@ package com.beust.jcommander; /** * Thrown when a command was expected. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ @SuppressWarnings("serial") public class MissingCommandException extends ParameterException { --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/ParameterException.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/ParameterException.java @@ -22,7 +22,7 @@ package com.beust.jcommander; * The main exception that JCommand will throw when something goes wrong while * parsing parameters. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ @SuppressWarnings("serial") public class ParameterException extends RuntimeException { --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/ResourceBundle.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/ResourceBundle.java @@ -26,7 +26,7 @@ import java.lang.annotation.Target; /** * @deprecated use @Parameters * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ @Retention(java.lang.annotation.RetentionPolicy.RUNTIME) @Target({ TYPE }) --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/SubParameter.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/SubParameter.java @@ -7,7 +7,7 @@ import static java.lang.annotation.Eleme import static java.lang.annotation.ElementType.METHOD; /** - * @author Cedric Beust <ced...@refresh.io> + * @author Cedric Beust <ced...@beust.com> * @since 02 12, 2017 */ @Retention(java.lang.annotation.RetentionPolicy.RUNTIME) --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/validators/NoValidator.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/validators/NoValidator.java @@ -24,7 +24,7 @@ import com.beust.jcommander.ParameterExc /** * This is the default value of the validateWith attribute. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ public class NoValidator implements IParameterValidator { --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/validators/NoValueValidator.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/validators/NoValueValidator.java @@ -24,7 +24,7 @@ import com.beust.jcommander.ParameterExc /** * This is the default value of the validateValueWith attribute. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ public class NoValueValidator<T> implements IValueValidator<T> { --- jcommander-1.71.orig/src/main/java/com/beust/jcommander/validators/PositiveInteger.java +++ jcommander-1.71/src/main/java/com/beust/jcommander/validators/PositiveInteger.java @@ -24,7 +24,7 @@ import com.beust.jcommander.ParameterExc /** * A validator that makes sure the value of the parameter is a positive integer. * - * @author Cedric Beust <ced...@beust.com> + * @author Cedric Beust <ced...@beust.com> */ public class PositiveInteger implements IParameterValidator {
