Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Phil Steitz
On Nov 25, 2011, at 5:16 AM, Sébastien Brisard wrote: >> >> One more point on this. "Consistency" as some sort of independent goal by >> itself has no place in open source software. We need to keep our eyes on >> the prize, which is making it easy for users to understand and use the >>

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Gilles Sadowski
On Fri, Nov 25, 2011 at 12:16:31PM +0100, Sébastien Brisard wrote: > > > > One more point on this.  "Consistency" as some sort of independent goal by > > itself has no place in open source software.  We need to keep our eyes on > > the prize, which is making it easy for users to understand and us

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Bruno P. Kinoshita
e too. Have a nice weekend, Bruno P. Kinoshita De: Sébastien Brisard Para: Commons Developers List Enviadas: Sexta-feira, 25 de Novembro de 2011 9:16 Assunto: Re: [math] javadoc implicit formatting rules > > One more point on this.  "Consisten

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Sébastien Brisard
> > One more point on this.  "Consistency" as some sort of independent goal by > itself has no place in open source software.  We need to keep our eyes on the > prize, which is making it easy for users to understand and use the software > and for volunteers to get involved.  To the extent that c

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Phil Steitz
One more point on this. "Consistency" as some sort of independent goal by itself has no place in open source software. We need to keep our eyes on the prize, which is making it easy for users to understand and use the software and for volunteers to get involved. To the extent that consistent

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Sébastien Brisard
OK, now I feel ashamed for raising such a trivial issue ;). Sébastien - To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Phil Steitz
On Nov 25, 2011, at 3:49 AM, Luc Maisonobe wrote: > Le 25/11/2011 08:13, Sébastien Brisard a écrit : >> Hi, >> here are a few questions about the implicit rules in use in CM for >> formatting Javadoc comments, that I've wanted to post for a long time. >> Since I'm now reviewing other people's

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Sébastien Brisard
> > It seems really a detail to me (your mileage may vary), the content of > the javadoc being far more important than its form. > > Luc > That's the kind of answer I wanted to read, but I just wanted to check. So when committing someone else's work, I won't worry about that point. Thanks, Sébastie

Re: [math] javadoc implicit formatting rules

2011-11-25 Thread Luc Maisonobe
Le 25/11/2011 08:13, Sébastien Brisard a écrit : > Hi, > here are a few questions about the implicit rules in use in CM for > formatting Javadoc comments, that I've wanted to post for a long time. > Since I'm now reviewing other people's patches, I think it's high time > to clear these questions up

[math] javadoc implicit formatting rules

2011-11-24 Thread Sébastien Brisard
Hi, here are a few questions about the implicit rules in use in CM for formatting Javadoc comments, that I've wanted to post for a long time. Since I'm now reviewing other people's patches, I think it's high time to clear these questions up. If I'm not mistaken, (1) every @param tag should start wi