Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
vy opened this issue Mar 28, 2024 · 0 comments
Labels

Comments

@vy
Copy link
Member

vy commented Mar 28, 2024

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.

@vy vy added the bug label Mar 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant