Abnaxos / markdown-doclet

A Doclet that allows the use of Markdown in JavaDoc comments.
GNU General Public License v3.0
318 stars 40 forks source link

Doclet doesn't support generic type arguments (@param <T>) #22

Closed pron closed 8 years ago

pron commented 10 years ago

It says warning - @param argument "T" is not a parameter name.

Abnaxos commented 10 years ago

I can't reproduce this. Can you post an example? Are you sure that there's no such warning when using the standard doclet? Because the pegdown doclet never prints such a warning, so it must be from the standard doclet.

pron commented 10 years ago

Hmm. This may be due to the standard doclet pegdown-doclet uses, and the fact that it requires tools.jar in maven's system scope, and I'm using Gradle. I'll look into that.

daschl commented 9 years ago

For what it's worth I'm seeing the same thing.

warning - @param argument "T" is not a parameter name.

docblock looks like

     *
     * @param <T> the type returned.
     * @param observable the source {@link Observable}
     * @param timeout the maximum timeout before an exception is thrown.
     * @param tu the timeout unit.
     * @return the extracted value from the {@link Observable} or throws in an error case.
     */
    public static <T> T blockForSingle(final Observable<? extends T> observable, final long timeout,
        final TimeUnit tu) {
richard-melvin commented 9 years ago

I have same issue: generic arguments to a type are ok, it's a generic argument to an individual method that gets the warning, Not seen the same thing with the standard doclet.

slovdahl commented 8 years ago

If you think the fix in my pull request is ok I would really appreciate a new release with the fix included. I would really like to avoid building my own version of the pegdown-doclet library. Thanks in advance!