You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sebb <se...@gmail.com> on 2010/11/14 14:08:28 UTC

[VFS] @since markers missing

Just noticed that there are no @since markers for any of the additions
to the code made since 1.0.

I think these are important, and should be present.

I'm happy to add them to the code-base.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by Ralph Goers <ra...@dslextreme.com>.
On Nov 14, 2010, at 5:41 PM, Gary Gregory wrote:

>> -----Original Message-----
>> From: sebb [mailto:sebbaz@gmail.com]
>> Sent: Sunday, November 14, 2010 17:36
>> To: Commons Developers List
>> Subject: Re: [VFS] @since markers missing
>> 
>> On 15 November 2010 01:32, Gary Gregory <GG...@seagullsoftware.com> wrote:
>>> On Nov 14, 2010, at 17:20, "sebb" <se...@gmail.com> wrote:
>>> 
>>>> On 15 November 2010 01:04, Ralph Goers <ra...@dslextreme.com> wrote:
>>>>> Checkstyle in VFS verifies that author tags are present as that is the
>> default setting. I don't see a checkstyle setting to enforce that they are not
>> present.  However, I believe it can enforce that it match a fixed expression.
>>>>> 
>>>>> As part of cleaning up the checkstyle results I've added @author tags
>> wherever they were missing with
>>>>> @author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS
>> team</a>
>>>>> 
>>>>> I copied this pattern from Commons Configuration as all modules are tagged
>> this way.
>>>> 
>>>> I don't think author tags should be _required_ because it should be
>>>> obvious that ASF code is written by the ASF community.
>>> 
>>> I agree with all of your msg. I like the idea of author tags because it
>> allows automated tool to look at source code and gather said tags. But I do
>> not know of folks who actually do this.
>> 
>> No point, because the author tags are rarely updated.
>> Much better to look at SVN history.
> 
> This following point must have been lost in the back and forth: My POV is that we should have author tags as "Apache Software Foundation" or "Apache Commons [Foo] Team" or a combo. That or nothin'.

See above.

I've changed the checkstyle rule to enforce the "Commons VFS team" author tag.  It looks like 184 of the classes in core don't have those.  Frankly, I haven't been evaluating the checkstyle issues in examples or sandbox since I started with over 10,000 errors in core (it is down to less than 500).

Ralph
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


RE: [VFS] @since markers missing

Posted by Gary Gregory <GG...@seagullsoftware.com>.
> -----Original Message-----
> From: sebb [mailto:sebbaz@gmail.com]
> Sent: Sunday, November 14, 2010 17:36
> To: Commons Developers List
> Subject: Re: [VFS] @since markers missing
> 
> On 15 November 2010 01:32, Gary Gregory <GG...@seagullsoftware.com> wrote:
> > On Nov 14, 2010, at 17:20, "sebb" <se...@gmail.com> wrote:
> >
> >> On 15 November 2010 01:04, Ralph Goers <ra...@dslextreme.com> wrote:
> >>> Checkstyle in VFS verifies that author tags are present as that is the
> default setting. I don't see a checkstyle setting to enforce that they are not
> present.  However, I believe it can enforce that it match a fixed expression.
> >>>
> >>> As part of cleaning up the checkstyle results I've added @author tags
> wherever they were missing with
> >>> @author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS
> team</a>
> >>>
> >>> I copied this pattern from Commons Configuration as all modules are tagged
> this way.
> >>
> >> I don't think author tags should be _required_ because it should be
> >> obvious that ASF code is written by the ASF community.
> >
> > I agree with all of your msg. I like the idea of author tags because it
> allows automated tool to look at source code and gather said tags. But I do
> not know of folks who actually do this.
> 
> No point, because the author tags are rarely updated.
> Much better to look at SVN history.

This following point must have been lost in the back and forth: My POV is that we should have author tags as "Apache Software Foundation" or "Apache Commons [Foo] Team" or a combo. That or nothin'.

GG

> 
> > GG
> >>
> >> See also below.
> >>
> >>> I have not changed modules that had existing author tags but it should be
> easy to do that by changing the checkstyle rule.
> >>>
> >>> Ralph
> >>>
> >>> On Nov 14, 2010, at 4:39 PM, Gary Gregory wrote:
> >>>
> >>>> On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com>
> wrote:
> >>>>
> >>>>> "author tags are officially discouraged"
> >>>>>
> >>>>> The board decided long ago that @author tags were discouraged.  Let's
> >>>>> just remove them.  If you want to credit someone, add their name to
> >>>>> the pom.xml file as a contributor.
> >>>>
> >>
> >> AIUI the board was referring to individual author names, as code is
> >> written by the community.
> >> Also any individual author tags are soon out of date.
> >>
> >>>> Yes I remember that but I thought it was also suggested that all author
> tags be "Apache Software Foundation" instead.
> >>
> >> Using ASF or Commons or some other appropriate collective name seems
> >> fine to me, as it expresses that the code is written by the community.
> >> Also does not get out of date so easily.
> >>
> >>>> GG
> >>>>>
> >>>>> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
> >>>>> <GG...@seagullsoftware.com> wrote:
> >>>>>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
> >>>>>>
> >>>>>>> Just noticed that there are no @since markers for any of the additions
> >>>>>>> to the code made since 1.0.
> >>>>>>>
> >>>>>>> I think these are important, and should be present.
> >>>>>>>
> >>>>>>> I'm happy to add them to the code-base.
> >>>>>>
> >>>>>> +1. How about @author tags with ASF as the author for any files that
> are sans  tag?
> >>>>>>
> >>>>>> GG
> >>>>>>>
> >>>>>>> ---------------------------------------------------------------------
> >>>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >>>>>>> For additional commands, e-mail: dev-help@commons.apache.org
> >>>>>>>
> >>>>>>
> >>>>>> ---------------------------------------------------------------------
> >>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >>>>>> For additional commands, e-mail: dev-help@commons.apache.org
> >>>>>>
> >>>>>>
> >>>>>
> >>>>> ---------------------------------------------------------------------
> >>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >>>>> For additional commands, e-mail: dev-help@commons.apache.org
> >>>>>
> >>>>
> >>>> ---------------------------------------------------------------------
> >>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >>>> For additional commands, e-mail: dev-help@commons.apache.org
> >>>>
> >>>
> >>>
> >>> ---------------------------------------------------------------------
> >>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >>> For additional commands, e-mail: dev-help@commons.apache.org
> >>>
> >>>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> >> For additional commands, e-mail: dev-help@commons.apache.org
> >>
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> > For additional commands, e-mail: dev-help@commons.apache.org
> >
> >
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by sebb <se...@gmail.com>.
On 15 November 2010 01:32, Gary Gregory <GG...@seagullsoftware.com> wrote:
> On Nov 14, 2010, at 17:20, "sebb" <se...@gmail.com> wrote:
>
>> On 15 November 2010 01:04, Ralph Goers <ra...@dslextreme.com> wrote:
>>> Checkstyle in VFS verifies that author tags are present as that is the default setting. I don't see a checkstyle setting to enforce that they are not present.  However, I believe it can enforce that it match a fixed expression.
>>>
>>> As part of cleaning up the checkstyle results I've added @author tags wherever they were missing with
>>> @author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS team</a>
>>>
>>> I copied this pattern from Commons Configuration as all modules are tagged this way.
>>
>> I don't think author tags should be _required_ because it should be
>> obvious that ASF code is written by the ASF community.
>
> I agree with all of your msg. I like the idea of author tags because it allows automated tool to look at source code and gather said tags. But I do not know of folks who actually do this.

No point, because the author tags are rarely updated.
Much better to look at SVN history.

> GG
>>
>> See also below.
>>
>>> I have not changed modules that had existing author tags but it should be easy to do that by changing the checkstyle rule.
>>>
>>> Ralph
>>>
>>> On Nov 14, 2010, at 4:39 PM, Gary Gregory wrote:
>>>
>>>> On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com> wrote:
>>>>
>>>>> "author tags are officially discouraged"
>>>>>
>>>>> The board decided long ago that @author tags were discouraged.  Let's
>>>>> just remove them.  If you want to credit someone, add their name to
>>>>> the pom.xml file as a contributor.
>>>>
>>
>> AIUI the board was referring to individual author names, as code is
>> written by the community.
>> Also any individual author tags are soon out of date.
>>
>>>> Yes I remember that but I thought it was also suggested that all author tags be "Apache Software Foundation" instead.
>>
>> Using ASF or Commons or some other appropriate collective name seems
>> fine to me, as it expresses that the code is written by the community.
>> Also does not get out of date so easily.
>>
>>>> GG
>>>>>
>>>>> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
>>>>> <GG...@seagullsoftware.com> wrote:
>>>>>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>>>>>>
>>>>>>> Just noticed that there are no @since markers for any of the additions
>>>>>>> to the code made since 1.0.
>>>>>>>
>>>>>>> I think these are important, and should be present.
>>>>>>>
>>>>>>> I'm happy to add them to the code-base.
>>>>>>
>>>>>> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>>>>>>
>>>>>> GG
>>>>>>>
>>>>>>> ---------------------------------------------------------------------
>>>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>>>>
>>>>>>
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>>>
>>>>>>
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by Gary Gregory <GG...@seagullsoftware.com>.
On Nov 14, 2010, at 17:20, "sebb" <se...@gmail.com> wrote:

> On 15 November 2010 01:04, Ralph Goers <ra...@dslextreme.com> wrote:
>> Checkstyle in VFS verifies that author tags are present as that is the default setting. I don't see a checkstyle setting to enforce that they are not present.  However, I believe it can enforce that it match a fixed expression.
>> 
>> As part of cleaning up the checkstyle results I've added @author tags wherever they were missing with
>> @author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS team</a>
>> 
>> I copied this pattern from Commons Configuration as all modules are tagged this way.
> 
> I don't think author tags should be _required_ because it should be
> obvious that ASF code is written by the ASF community.

I agree with all of your msg. I like the idea of author tags because it allows automated tool to look at source code and gather said tags. But I do not know of folks who actually do this. 

GG 
> 
> See also below.
> 
>> I have not changed modules that had existing author tags but it should be easy to do that by changing the checkstyle rule.
>> 
>> Ralph
>> 
>> On Nov 14, 2010, at 4:39 PM, Gary Gregory wrote:
>> 
>>> On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com> wrote:
>>> 
>>>> "author tags are officially discouraged"
>>>> 
>>>> The board decided long ago that @author tags were discouraged.  Let's
>>>> just remove them.  If you want to credit someone, add their name to
>>>> the pom.xml file as a contributor.
>>> 
> 
> AIUI the board was referring to individual author names, as code is
> written by the community.
> Also any individual author tags are soon out of date.
> 
>>> Yes I remember that but I thought it was also suggested that all author tags be "Apache Software Foundation" instead.
> 
> Using ASF or Commons or some other appropriate collective name seems
> fine to me, as it expresses that the code is written by the community.
> Also does not get out of date so easily.
> 
>>> GG
>>>> 
>>>> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
>>>> <GG...@seagullsoftware.com> wrote:
>>>>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>>>>> 
>>>>>> Just noticed that there are no @since markers for any of the additions
>>>>>> to the code made since 1.0.
>>>>>> 
>>>>>> I think these are important, and should be present.
>>>>>> 
>>>>>> I'm happy to add them to the code-base.
>>>>> 
>>>>> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>>>>> 
>>>>> GG
>>>>>> 
>>>>>> ---------------------------------------------------------------------
>>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>>> 
>>>>> 
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>> 
>>>>> 
>>>> 
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>> 
>>> 
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>> 
>> 
>> 
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>> 
>> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by sebb <se...@gmail.com>.
On 15 November 2010 01:04, Ralph Goers <ra...@dslextreme.com> wrote:
> Checkstyle in VFS verifies that author tags are present as that is the default setting. I don't see a checkstyle setting to enforce that they are not present.  However, I believe it can enforce that it match a fixed expression.
>
> As part of cleaning up the checkstyle results I've added @author tags wherever they were missing with
> @author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS team</a>
>
> I copied this pattern from Commons Configuration as all modules are tagged this way.

I don't think author tags should be _required_ because it should be
obvious that ASF code is written by the ASF community.

See also below.

> I have not changed modules that had existing author tags but it should be easy to do that by changing the checkstyle rule.
>
> Ralph
>
> On Nov 14, 2010, at 4:39 PM, Gary Gregory wrote:
>
>> On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com> wrote:
>>
>>> "author tags are officially discouraged"
>>>
>>> The board decided long ago that @author tags were discouraged.  Let's
>>> just remove them.  If you want to credit someone, add their name to
>>> the pom.xml file as a contributor.
>>

AIUI the board was referring to individual author names, as code is
written by the community.
Also any individual author tags are soon out of date.

>> Yes I remember that but I thought it was also suggested that all author tags be "Apache Software Foundation" instead.

Using ASF or Commons or some other appropriate collective name seems
fine to me, as it expresses that the code is written by the community.
Also does not get out of date so easily.

>> GG
>>>
>>> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
>>> <GG...@seagullsoftware.com> wrote:
>>>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>>>>
>>>>> Just noticed that there are no @since markers for any of the additions
>>>>> to the code made since 1.0.
>>>>>
>>>>> I think these are important, and should be present.
>>>>>
>>>>> I'm happy to add them to the code-base.
>>>>
>>>> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>>>>
>>>> GG
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>>
>>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by Ralph Goers <ra...@dslextreme.com>.
Checkstyle in VFS verifies that author tags are present as that is the default setting. I don't see a checkstyle setting to enforce that they are not present.  However, I believe it can enforce that it match a fixed expression.

As part of cleaning up the checkstyle results I've added @author tags wherever they were missing with
@author <a href="http://commons.apache.org/vfs/team-list.html">Commons VFS team</a>

I copied this pattern from Commons Configuration as all modules are tagged this way.

I have not changed modules that had existing author tags but it should be easy to do that by changing the checkstyle rule.

Ralph

On Nov 14, 2010, at 4:39 PM, Gary Gregory wrote:

> On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com> wrote:
> 
>> "author tags are officially discouraged"
>> 
>> The board decided long ago that @author tags were discouraged.  Let's
>> just remove them.  If you want to credit someone, add their name to
>> the pom.xml file as a contributor.
> 
> Yes I remember that but I thought it was also suggested that all author tags be "Apache Software Foundation" instead. 
> 
> GG 
>> 
>> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
>> <GG...@seagullsoftware.com> wrote:
>>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>>> 
>>>> Just noticed that there are no @since markers for any of the additions
>>>> to the code made since 1.0.
>>>> 
>>>> I think these are important, and should be present.
>>>> 
>>>> I'm happy to add them to the code-base.
>>> 
>>> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>>> 
>>> GG
>>>> 
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>>> For additional commands, e-mail: dev-help@commons.apache.org
>>>> 
>>> 
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>> 
>>> 
>> 
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by Gary Gregory <GG...@seagullsoftware.com>.
On Nov 14, 2010, at 16:28, "James Carman" <ja...@carmanconsulting.com> wrote:

> "author tags are officially discouraged"
> 
> The board decided long ago that @author tags were discouraged.  Let's
> just remove them.  If you want to credit someone, add their name to
> the pom.xml file as a contributor.

Yes I remember that but I thought it was also suggested that all author tags be "Apache Software Foundation" instead. 

GG 
> 
> On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
> <GG...@seagullsoftware.com> wrote:
>> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>> 
>>> Just noticed that there are no @since markers for any of the additions
>>> to the code made since 1.0.
>>> 
>>> I think these are important, and should be present.
>>> 
>>> I'm happy to add them to the code-base.
>> 
>> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>> 
>> GG
>>> 
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>> 
>> 
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>> 
>> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by James Carman <ja...@carmanconsulting.com>.
"author tags are officially discouraged"

The board decided long ago that @author tags were discouraged.  Let's
just remove them.  If you want to credit someone, add their name to
the pom.xml file as a contributor.

On Sun, Nov 14, 2010 at 7:05 PM, Gary Gregory
<GG...@seagullsoftware.com> wrote:
> On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:
>
>> Just noticed that there are no @since markers for any of the additions
>> to the code made since 1.0.
>>
>> I think these are important, and should be present.
>>
>> I'm happy to add them to the code-base.
>
> +1. How about @author tags with ASF as the author for any files that are sans  tag?
>
> GG
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [VFS] @since markers missing

Posted by Gary Gregory <GG...@seagullsoftware.com>.
On Nov 14, 2010, at 5:09, "sebb" <se...@gmail.com> wrote:

> Just noticed that there are no @since markers for any of the additions
> to the code made since 1.0.
> 
> I think these are important, and should be present.
> 
> I'm happy to add them to the code-base.

+1. How about @author tags with ASF as the author for any files that are sans  tag?

GG 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org