Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-549 Version tag comes and goes on several javadoc:fix goal runs
  3. MJAVADOC-552

Author tag is removed, even though it should be excluded using the fixTags-setting

    XMLWordPrintableJSON

Details

    • Sub-task
    • Status: Closed
    • Critical
    • Resolution: Fixed
    • 3.0.1
    • 3.1.0
    • fix
    • None
    • Windows 7 x64
      Apache Maven 3.5.4

    Description

      The javadoc:fix goal overrides the @author tag(s) by default, which is a pity if several developers deserve credit

      /**
       * Class developed by several authors.
       * 
       * @author Developer, One
       * @author Developer, Two
       * @author Developer, Three
       * @version 1.0.9, 2018-12-19
       * @since 0.0.1
       */
      

      for the work.

      That is why I tried to specifically exclude the @author tag by adding the configuration:

      <!-- Exclude the @author tag from editing, else several author tags of the same class will be replaced by one single @author tag. -->
      <fixTags>version,since,param,return,throws,link</fixTags>
      

      Instead of ignoring the @author tag, i.e. leaving it as it is, it is completely removed!

      This effectively makes the javadoc:fix goal unusable to me.

      Attachments

        Activity

          People

            rfscholte Robert Scholte
            jejo86 Je Jo
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: