Details

    • Type: Bug Bug
    • Status: Closed Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 1.6
    • Labels:
      None
    • Number of attachments :
      0

      Description

      I have a coulple of

      {@link package-name}

      tags in my javadocs, however, the javadoc plugin can resolve them to an URL.

      For instance: http://www.dom4j.org/xref/org/dom4j/DocumentType.html has links to the "org.dom4j.dtd" package. But if I generate the javadoc with maven, I receive this warning: "src\java\org\dom4j\DocumentType.java:52: warning - Tag @link: reference not found: org.dom4j.dtd".

      But if I generate the javadocs with the Ant javadoc task myself, these links are resolved correctly!!

      For instance: http://www.dom4j.org/dom4j-1.4/apidocs/org/dom4j/DocumentType.html is the javadoc generated by the build.xml of dom4j which does only call the javadoc task provided by Ant.

      Maarten

        Activity

        Hide
        Arnaud Heritier added a comment -

        I think that this problem is due to the fact that we use a list of files and not a directory and a package as input for the javadoc.
        We need to implement a flag that check if sourceModification is used. If there's no sourceModification in the project we must use the package name and the directory.

        Show
        Arnaud Heritier added a comment - I think that this problem is due to the fact that we use a list of files and not a directory and a package as input for the javadoc. We need to implement a flag that check if sourceModification is used. If there's no sourceModification in the project we must use the package name and the directory.
        Hide
        Arnaud Heritier added a comment -

        Brett, will you try to resolve this bug ?

        Show
        Arnaud Heritier added a comment - Brett, will you try to resolve this bug ?
        Hide
        Brett Porter added a comment -

        not for a little bit... if you have an idea of how to fix it, feel free to reassign to yourself.

        Show
        Brett Porter added a comment - not for a little bit... if you have an idea of how to fix it, feel free to reassign to yourself.
        Hide
        Arnaud Heritier added a comment -

        I partially fixed this bug.
        I re-introduce the use of a <sourcepath> instead of a <fileset> when $

        {pom.build.sourceModifications}

        aren't defined.
        The bug will persist if you use sourceModifications AND link to package names at the same time.

        Show
        Arnaud Heritier added a comment - I partially fixed this bug. I re-introduce the use of a <sourcepath> instead of a <fileset> when $ {pom.build.sourceModifications} aren't defined. The bug will persist if you use sourceModifications AND link to package names at the same time.
        Hide
        Maarten Coene added a comment -

        Thanks,

        can you tell me how to disable these sourceModifications when generating the javadocs?

        Maarten

        Show
        Maarten Coene added a comment - Thanks, can you tell me how to disable these sourceModifications when generating the javadocs? Maarten
        Hide
        Arnaud Heritier added a comment -

        Actually it's not possible to configure it.
        If you define in your project.xml some sourceModifications, then the javadoc plugin will use it.
        I will propose today on the dev list a modification to choose if we must add a flag (with a new property) or if we must remove the use of sourceModifications in the plugin.

        Show
        Arnaud Heritier added a comment - Actually it's not possible to configure it. If you define in your project.xml some sourceModifications, then the javadoc plugin will use it. I will propose today on the dev list a modification to choose if we must add a flag (with a new property) or if we must remove the use of sourceModifications in the plugin.
        Hide
        Arnaud Heritier added a comment -

        use of sourceModifications is removed.

        Show
        Arnaud Heritier added a comment - use of sourceModifications is removed.

          People

          • Assignee:
            Arnaud Heritier
            Reporter:
            Maarten Coene
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: