You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@jclouds.apache.org by "ASF subversion and git services (JIRA)" <ji...@apache.org> on 2014/06/08 06:44:01 UTC

[jira] [Commented] (JCLOUDS-546) Remove @author from javadocs

    [ https://issues.apache.org/jira/browse/JCLOUDS-546?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14021091#comment-14021091 ] 

ASF subversion and git services commented on JCLOUDS-546:
---------------------------------------------------------

Commit 95472c3b1f3b0863a97e0fa6e7be8290647ad482 in jclouds-chef's branch refs/heads/master from [~gaul]
[ https://git-wip-us.apache.org/repos/asf?p=jclouds-chef.git;h=95472c3 ]

JCLOUDS-546: Remove Javadoc @author annotations

Annotations removed with:

find -name \*.java | xargs sed -i /@author/d

Empty Javadoc removed with multiple iterations of:

find -name \*.java | xargs sed -i -z 's/ \*\n \*\// \*\//'
find -name \*.java | xargs sed -i -z 's/ \* \n \*\// \*\//'
find -name \*.java | xargs sed -i -z 's/\/\*\*\n \*\/\n//'


> Remove @author from javadocs
> ----------------------------
>
>                 Key: JCLOUDS-546
>                 URL: https://issues.apache.org/jira/browse/JCLOUDS-546
>             Project: jclouds
>          Issue Type: Task
>          Components: docs
>            Reporter: Chris Custine
>            Assignee: Andrew Gaul
>            Priority: Trivial
>
> There is a long standing board resolution that discourages use of @author tags in Apache project javadocs.  jclouds source also contains @author tags attributing authorship to people that are not committers (from the Github days).  I know its a pain, but it might be a good task prior to 1.8 and maybe even a 1.7.x release.  
> Hadoop and other projects also have automated checks to flag patches with @author tags so that is something to consider down the road.



--
This message was sent by Atlassian JIRA
(v6.2#6252)