On Sat, 2004-10-16 at 14:13, Martin Cooper wrote:
> On Sat, 16 Oct 2004 14:09:59 -0400, Paul Speed <[EMAIL PROTECTED]> wrote:
> > It is kind of nice to have revision information in the javadocs though,
> > isn't it? I've at least found it useful in my own projects.
>
> The thing is that in Subversion, the revision numbers are
> repository-wide, and not file specific. So making a change to a file
> might cause the revision number to change from 55123 to 56456. IMHO,
> the value of including that information in JavaDocs is dubious.
-1 -- knowing the build number associated with the javadoc you are
looking at is so important (even if it is the same number on all files
in that javadoc). The fact that subversion uses atomic build numbers
for the entire commit (instant tags) is awesome, and only enhances the
presence of the revision number in javadocs. Especially with all these
automated reports that projects are using. Have you ever looked at a
javadoc only to realize that the version you are using and the doc you
are reading is different? Not the end of the world, but say you really
wanted to use that api and no tag info was given in the javadoc, you
would have to go to cvs and see what was the last tag / branch that this
revision was included in. Subversion makes this instant knowledge. "oh
- I need build 55123 and I'm using 55121. I wonder what else changed
between those revisions. Looks like I can upgrade smoothly. I'm doing
it." :-)
>
> --
> Martin Cooper
>
>
> >
> > -Paul
> >
> >
> >
> > Martin Cooper wrote:
> >
> > > I would suggest just taking this line out...
> > >
> > > --
> > > Martin Cooper
> > >
> > >
> > > On 16 Oct 2004 16:09:27 -0000, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
> > >
> > >>Author: germuska
> > >>Date: Sat Oct 16 09:09:25 2004
> > >>New Revision: 54927
> > >>
> > >>Modified:
> > >> struts/trunk/src/test/org/apache/struts/action/TestActionMessages.java
> > >> (contents, props changed)
> > >>Log:
> > >>try again with keywords 'date author id rev' and change keyword to 'Rev' after
> > >>testing on local SVN server
> > >>
> > >>Modified: struts/trunk/src/test/org/apache/struts/action/TestActionMessages.java
> > >>==============================================================================
> > >>--- struts/trunk/src/test/org/apache/struts/action/TestActionMessages.java
> > >>(original)
> > >>+++ struts/trunk/src/test/org/apache/struts/action/TestActionMessages.java
> > >>Sat Oct 16 09:09:25 2004
> > >>@@ -27,7 +27,7 @@
> > >>/**
> > >> * Unit tests for the <code>org.apache.struts.action.ActionMessages</code> class.
> > >> *
> > >>- * @version $Revision: 1.7 $ $Date$
> > >>+ * @version $Rev$ $Date$
> > >> */
> > >>
> > >>public class TestActionMessages extends TestCase {
> > >>
> > >>---------------------------------------------------------------------
> > >>To unsubscribe, e-mail: [EMAIL PROTECTED]
> > >>For additional commands, e-mail: [EMAIL PROTECTED]
> > >>
> > >>
> > >
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> > ---------------------------------------------------------------------
> >
> >
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
