> -----Original Message-----
> From: Vincent Massol [mailto:vincent@massol.net]
> Sent: lundi 13 novembre 2006 16:43
> To: 'xwiki-dev(a)objectweb.org'
> Subject: Contributors.txt and @author in license headers
>
> Hi,
>
> Our license headers say: " * Copyright 2006, XpertNet SARL, and
> individual contributors as indicated by the contributors.txt."
>
> There are 3 problems with this that I can see:
>
> 1) It's not really English in that it's either missing a "file" at the
> end or we should remove the "the" before "contributors" ;-)
> 2) I cannot find the contributors.txt file!
> 3) I don't think we should explicitely mention the file name as we'll
> always risk having to rename all headers if we decide to put this file
> somewhere else/name it differently.
> 4) In several of our license headers there are @authors. For example:
>
> /*
> * Copyright 2006, XpertNet SARL, and individual contributors as
> indicated
> * by the contributors.txt.
>
> [snip]
>
> * You should have received a copy of the GNU Lesser General Public
> * License along with this software; if not, write to the Free
> * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
> * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
> *
> * @author ravenees
> * @author jeremi
> */
>
> I thought the authors were supposed to be indicated in the
> contributors.txt file! :-)
>
> Personally I don't like @author tags and especially not in license
> headers (actually it's the first time I ever see them put there, they
> are usually put in the class javadoc). The reason I don't like these
> tags is because:
> * they are always not up to date and there are usually mane more
> authors than the ones listed
> * we never know what the author has worked on in the file and to what
> extent. For example someone could have simply added a missing dot in a
> javdoc.
> * this information is better defined in the SCM which contains the full
> history and what everyone has exactly contributed to.
>
> So I'd be in favor of implementing the contributors.txt file and
> removing all @authors tags from the license headers.
FWIW in cargo, we store contributions in SVN and they're also available on
the web site at http://cargo.codehaus.org/Credits. It's never completely up
to date but it's a good first approach. This is the equivalent of the
contributors.txt file.
-Vincent
___________________________________________________________________________
D�couvrez une nouvelle fa�on d'obtenir des r�ponses � toutes vos questions !
Profitez des connaissances, des opinions et des exp�riences des internautes sur Yahoo! Questions/R�ponses
http://fr.answers.yahoo.com
Hi,
Our license headers say: " * Copyright 2006, XpertNet SARL, and individual
contributors as indicated by the contributors.txt."
There are 3 problems with this that I can see:
1) It's not really English in that it's either missing a "file" at the end
or we should remove the "the" before "contributors" ;-)
2) I cannot find the contributors.txt file!
3) I don't think we should explicitely mention the file name as we'll always
risk having to rename all headers if we decide to put this file somewhere
else/name it differently.
4) In several of our license headers there are @authors. For example:
/*
* Copyright 2006, XpertNet SARL, and individual contributors as indicated
* by the contributors.txt.
[snip]
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*
* @author ravenees
* @author jeremi
*/
I thought the authors were supposed to be indicated in the contributors.txt
file! :-)
Personally I don't like @author tags and especially not in license headers
(actually it's the first time I ever see them put there, they are usually
put in the class javadoc). The reason I don't like these tags is because:
* they are always not up to date and there are usually mane more authors
than the ones listed
* we never know what the author has worked on in the file and to what
extent. For example someone could have simply added a missing dot in a
javdoc.
* this information is better defined in the SCM which contains the full
history and what everyone has exactly contributed to.
So I'd be in favor of implementing the contributors.txt file and removing
all @authors tags from the license headers.
WDYT?
Thanks
-Vincent
___________________________________________________________________________
D�couvrez une nouvelle fa�on d'obtenir des r�ponses � toutes vos questions !
Profitez des connaissances, des opinions et des exp�riences des internautes sur Yahoo! Questions/R�ponses
http://fr.answers.yahoo.com
Hi everyone,
Just to let you know that I have set up TeamCity from JetBrains on
http://laam.xpertnet.biz:8111/
Anyone can log in there as a guest user. If you need an account let me know.
One interesting feature is the ability to run personal builds if you're
using IntelliJ IDEA. To use this feature, install the IDEA plugin
(http://laam.xpertnet.biz:8111/update/buildServerPlugin.zip). Close IDE and
drop it your [...]\.IntelliJIdea60\config\plugins directory (after unzipping
it). When you open IDEA again you'll have a TeamCity menu and the commit
screen will have a "Remote Run" button. You might need an account on the
build server to use this feature.
There are also options to run IDEA inspections and code coverage. I'll play
with those later on.
Caveats:
* This is a trial at this stage
* The location on laam is possibly temporary
* I have requested for an open source license of TC. Dunno if we'll get one.
* I haven't configured the start script so that it is started if the machine
is rebooted so we'll have to do this
* We shouldn't put any build agent on this machine. Right now I've
registered an agent on my laptop. Let me know if you're interested in
providing an agent too. It would be nice if we had at least 3 or so agents.
Otherwise, when my laptop is shutdown there'll be no build agent
available... :-)
* I need to configure the SMTP server so that emails can be sent. Can
someone contact me to let me know which SMTP server I can use on laam?
* TeamCity can also send jabber notifications. Let me know if that's
something you'd like me to configure
* I have installed TC build #1727 1.1 RC1 / November 10, 2006 from
http://www.jetbrains.net/confluence/display/TW/TeamCity+EAP
Let me know what you think.
Thanks
-Vincent
___________________________________________________________________________
D�couvrez une nouvelle fa�on d'obtenir des r�ponses � toutes vos questions !
Profitez des connaissances, des opinions et des exp�riences des internautes sur Yahoo! Questions/R�ponses
http://fr.answers.yahoo.com
