[jira] [Closed] (MJAVADOC-550) Additional update* and add* settings

["Robert Scholte (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/MJAVADOC-550?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Scholte closed MJAVADOC-550.
-----------------------------------
    Resolution: Won't Fix
      Assignee: Robert Scholte

I don't like the idea of update, because it gives a wrong impression.
This implies that the new author has done all the work, where as the original athour should also be rewarded for his work.
Also it is important to set the @since to the value when it was introduced, not when it was touched for the last time.
The @version is used less and less, with Git it makes less sense.
Hence I'll close this as Won't fix.

> Additional update* and add* settings
> ------------------------------------
>
>                 Key: MJAVADOC-550
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-550
>             Project: Maven Javadoc Plugin
>          Issue Type: Sub-task
>          Components: fix, javadoc
>    Affects Versions: 3.0.1
>         Environment: Windows 7 x64
> Apache Maven 3.5.4
>            Reporter: Jesko Jochum
>            Assignee: Robert Scholte
>            Priority: Minor
>
> It would be good to have more settings. 
> The {{default*}} setting, seem to be used if there is no tag yet. The {{defaultVersion}} should be changed to something like:
> {noformat}
> defaultVersion=${project.version}, ${date:YYYY-MM-DD HH:MM:SS}
> {noformat}
> , with the {{$\{date:YYYY-MM-DD HH:MM:SS\}}} to show the build date and time time
> Several {{update*}} settings could be used to replace the old tags with a new ones, especially an {{updateVersion}} setting would be sensible.
> {noformat}
> updateAuthor=${user.name}
> updateVersion=${project.version}, ${date:YYYY-MM-DD HH:MM:SS}
> updateSince=${project.version} // Probably not necessary
> {noformat}
> An {{addAuthor}} settings could be used to append an author to the existing ones, if the existing string does not yet contain the one to add. 
> {noformat}
> addAuthor=${user.name}
> {noformat}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)