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)