Skip to content

log4j-docgen cannot convert method references with multiple arguments in Javadoc to AsciiDoc #110

@vy

Description

@vy

The following Javadoc copied from org.apache.logging.log4j.core.filter.AbstractFilter

Garbage-free note: the methods with unrolled varargs by default delegate to the
{@link #filter(Logger, Level, Marker, String, Object...) filter method with vararg parameters}.
Subclasses that want to be garbage-free should override these methods to implement the appropriate filtering
without creating a vararg array.

gets converted to

Garbage-free note: the methods with unrolled varargs by default delegate to the apiref:org.apache.logging.log4j.core.filter.AbstractFilter#filter(Logger, Level, Marker, String, Object...)[filter method with vararg parameters].

This AsciiDoc is invalid due to the whitespace in between method arguments. As a result, AsciiDoctor doesn't even recognize the apiref:... snippet as an inline macro, and consequently, don't call ApirefMacro.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions