You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by John Keyes <jb...@mac.com> on 2002/08/21 17:59:04 UTC
RE: [VOTE] Addition to the Commons charter: coding conventions (
Take 3)
+1 for the addition.
I wonder is it reasonable to expect each project to have
a checkstyle.properties (or at least reference one).
This would implicitly state the style.
-John K
On Wed, 2002-08-21 at 17:00, Scott Sanders wrote:
> +1.
>
> How do we make sure existing projects add 2.2 to their PROPOSAL?
>
> Scott
>
> > -----Original Message-----
> > From: Morgan Delagrange [mailto:mdelagra@yahoo.com]
> > Sent: Wednesday, August 21, 2002 8:31 AM
> > To: Jakarta Commons Developers List
> > Subject: Re: [VOTE] Addition to the Commons charter: coding
> > conventions ( Take 3)
> >
> >
> > +1
> >
> > --- Martin Cooper <ma...@tumbleweed.com>
> > wrote:
> > > Taking into account Daniel Rall's comment this time.
> > > Sorry about all the
> > > changes, but I'd prefer to refine the text before
> > > most people read it and
> > > cast their votes.
> > >
> > >
> > > John McNally brought up a good point about the
> > > location of the coding
> > > convention specification. Here's a slightly amended
> > > proposal which takes
> > > that into account.
> > >
> > >
> > > From the various threads on this subject, I feel
> > > that we've more or less
> > > reached informal concensus, so I'd like to make a
> > > concrete proposal and call
> > > for a vote.
> > >
> > > I propose to make the following changes to the
> > > Guidelines section of the
> > > Commons charter:
> > >
> > > 1) Replace the 3rd sentence of item 17 with the
> > > following:
> > >
> > > ---------------
> > > Proposals are to identify the rationale for the
> > > package, its scope, its
> > > interaction with other packages and products, the
> > > Commons resources, if any,
> > > to be created, the initial source from which the
> > > package is to be created,
> > > the coding conventions used for the package (if
> > > different from the Sun
> > > coding conventions), and the initial set of
> > > committers.
> > > ---------------
> > >
> > > The only change here is the addition of the item
> > > about coding conventions.
> > >
> > > 2) After the current item 20 (which is about the CVS
> > > repository):
> > >
> > > ---------------
> > > 21. Each Commons component should use an internally consistent and
> > > documented coding style. When the source code for a
> > > component originates in
> > > a pre-existing code base outside of Commons, the
> > > coding style of that code
> > > base may be retained at the discretion of the
> > > initial committers. If a
> > > component does not specify its coding style, the Sun
> > > Coding Convention
> > > guidelines are assumed.
> > > ---------------
> > >
> > > (Acknowledgements to Morgan for most of this
> > > wording.)
> > >
> > > In addition, I propose the following addition to the
> > > Example Package
> > > Proposal of the charter:
> > >
> > > ---------------
> > > (2.2) identify the coding conventions for this
> > > package
> > >
> > > The code uses the conventions from the Jakarta
> > > Turbine package.
> > > ---------------
> > >
> > > The above changes have my +1.
> > >
> > > --
> > > Martin Cooper
> > >
> > >
> > > --
> > > To unsubscribe, e-mail:
> > > <ma...@jakarta.apache.org>
> > > For additional commands, e-mail:
> > > <ma...@jakarta.apache.org>
> > >
> >
> >
> > =====
> > Morgan Delagrange
> > http://jakarta.apache.org/taglibs
> > http://jakarta.apache.org/commons > http://axion.tigris.org
> > http://jakarta.apache.org/watchdog
> >
> >
> >
> > __________________________________________________
> > Do You Yahoo!?
> > HotJobs - Search Thousands of New Jobs
> > http://www.hotjobs.com
> >
> > --
> > To unsubscribe, e-mail:
> > <mailto:commons-dev-> unsubscribe@jakarta.apache.org>
> > For
> > additional commands,
> > e-mail: <ma...@jakarta.apache.org>
> >
> >
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
RE: [VOTE] Addition to the Commons charter: coding conventions (
Take 3)
Posted by John Keyes <jb...@mac.com>.
Point taken.
Of course if we defined a style XML Schema, we could
transform instance documents into the type required
by multiple style checking programs. This doc could
also be transformed to xdoc so it can be published.
-John K
On Wed, 2002-08-21 at 17:22, Morgan Delagrange wrote:
> I don't think that's the kind of thing to enforce in
> the charter. It's one thing to require a documented
> style, but requiring a particular implementation of a
> style-checking program seems like overkill. Same for
> Maven IMO.
>
> --- John Keyes <jb...@mac.com> wrote:
> > +1 for the addition.
> >
> > I wonder is it reasonable to expect each project to
> > have
> > a checkstyle.properties (or at least reference one).
> > This would implicitly state the style.
> >
> > -John K
> >
> > On Wed, 2002-08-21 at 17:00, Scott Sanders wrote:
> > > +1.
> > >
> > > How do we make sure existing projects add 2.2 to
> > their PROPOSAL?
> > >
> > > Scott
> > >
> > > > -----Original Message-----
> > > > From: Morgan Delagrange
> > [mailto:mdelagra@yahoo.com]
> > > > Sent: Wednesday, August 21, 2002 8:31 AM
> > > > To: Jakarta Commons Developers List
> > > > Subject: Re: [VOTE] Addition to the Commons
> > charter: coding
> > > > conventions ( Take 3)
> > > >
> > > >
> > > > +1
> > > >
> > > > --- Martin Cooper <ma...@tumbleweed.com>
> > > > wrote:
> > > > > Taking into account Daniel Rall's comment this
> > time.
> > > > > Sorry about all the
> > > > > changes, but I'd prefer to refine the text
> > before
> > > > > most people read it and
> > > > > cast their votes.
> > > > >
> > > > >
> > > > > John McNally brought up a good point about the
> > > > > location of the coding
> > > > > convention specification. Here's a slightly
> > amended
> > > > > proposal which takes
> > > > > that into account.
> > > > >
> > > > >
> > > > > From the various threads on this subject, I
> > feel
> > > > > that we've more or less
> > > > > reached informal concensus, so I'd like to
> > make a
> > > > > concrete proposal and call
> > > > > for a vote.
> > > > >
> > > > > I propose to make the following changes to the
> > > > > Guidelines section of the
> > > > > Commons charter:
> > > > >
> > > > > 1) Replace the 3rd sentence of item 17 with
> > the
> > > > > following:
> > > > >
> > > > > ---------------
> > > > > Proposals are to identify the rationale for
> > the
> > > > > package, its scope, its
> > > > > interaction with other packages and products,
> > the
> > > > > Commons resources, if any,
> > > > > to be created, the initial source from which
> > the
> > > > > package is to be created,
> > > > > the coding conventions used for the package
> > (if
> > > > > different from the Sun
> > > > > coding conventions), and the initial set of
> > > > > committers.
> > > > > ---------------
> > > > >
> > > > > The only change here is the addition of the
> > item
> > > > > about coding conventions.
> > > > >
> > > > > 2) After the current item 20 (which is about
> > the CVS
> > > > > repository):
> > > > >
> > > > > ---------------
> > > > > 21. Each Commons component should use an
> > internally consistent and
> > > > > documented coding style. When the source code
> > for a
> > > > > component originates in
> > > > > a pre-existing code base outside of Commons,
> > the
> > > > > coding style of that code
> > > > > base may be retained at the discretion of the
> > > > > initial committers. If a
> > > > > component does not specify its coding style,
> > the Sun
> > > > > Coding Convention
> > > > > guidelines are assumed.
> > > > > ---------------
> > > > >
> > > > > (Acknowledgements to Morgan for most of this
> > > > > wording.)
> > > > >
> > > > > In addition, I propose the following addition
> > to the
> > > > > Example Package
> > > > > Proposal of the charter:
> > > > >
> > > > > ---------------
> > > > > (2.2) identify the coding conventions for this
> > > > > package
> > > > >
> > > > > The code uses the conventions from the Jakarta
> > > > > Turbine package.
> > > > > ---------------
> > > > >
> > > > > The above changes have my +1.
> > > > >
> > > > > --
> > > > > Martin Cooper
> > > > >
> > > > >
> > > > > --
> > > > > To unsubscribe, e-mail:
> > > > >
> > <ma...@jakarta.apache.org>
> > > > > For additional commands, e-mail:
> > > > > <ma...@jakarta.apache.org>
> > > > >
> > > >
> > > >
> > > > =====
> > > > Morgan Delagrange
> > > > http://jakarta.apache.org/taglibs
> > > > http://jakarta.apache.org/commons >
> > http://axion.tigris.org
> > > > http://jakarta.apache.org/watchdog
> > > >
> > > >
> > > >
> > > >
> > __________________________________________________
> > > > Do You Yahoo!?
> > > > HotJobs - Search Thousands of New Jobs
> > > > http://www.hotjobs.com
> > > >
> > > > --
> > > > To unsubscribe, e-mail:
> > > > <mailto:commons-dev->
> > unsubscribe@jakarta.apache.org>
> > > > For
> > > > additional commands,
> > > > e-mail:
> > <ma...@jakarta.apache.org>
> > > >
> > > >
> > >
> > > --
> > > To unsubscribe, e-mail:
> > <ma...@jakarta.apache.org>
> > > For additional commands, e-mail:
> > <ma...@jakarta.apache.org>
> > >
> >
> >
> >
> > --
> > To unsubscribe, e-mail:
> > <ma...@jakarta.apache.org>
> > For additional commands, e-mail:
> > <ma...@jakarta.apache.org>
> >
>
>
> =====
> Morgan Delagrange
> http://jakarta.apache.org/taglibs
> http://jakarta.apache.org/commons
> http://axion.tigris.org
> http://jakarta.apache.org/watchdog
>
> __________________________________________________
> Do You Yahoo!?
> HotJobs - Search Thousands of New Jobs
> http://www.hotjobs.com
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
RE: [VOTE] Addition to the Commons charter: coding conventions ( Take 3)
Posted by Morgan Delagrange <md...@yahoo.com>.
I don't think that's the kind of thing to enforce in
the charter. It's one thing to require a documented
style, but requiring a particular implementation of a
style-checking program seems like overkill. Same for
Maven IMO.
--- John Keyes <jb...@mac.com> wrote:
> +1 for the addition.
>
> I wonder is it reasonable to expect each project to
> have
> a checkstyle.properties (or at least reference one).
> This would implicitly state the style.
>
> -John K
>
> On Wed, 2002-08-21 at 17:00, Scott Sanders wrote:
> > +1.
> >
> > How do we make sure existing projects add 2.2 to
> their PROPOSAL?
> >
> > Scott
> >
> > > -----Original Message-----
> > > From: Morgan Delagrange
> [mailto:mdelagra@yahoo.com]
> > > Sent: Wednesday, August 21, 2002 8:31 AM
> > > To: Jakarta Commons Developers List
> > > Subject: Re: [VOTE] Addition to the Commons
> charter: coding
> > > conventions ( Take 3)
> > >
> > >
> > > +1
> > >
> > > --- Martin Cooper <ma...@tumbleweed.com>
> > > wrote:
> > > > Taking into account Daniel Rall's comment this
> time.
> > > > Sorry about all the
> > > > changes, but I'd prefer to refine the text
> before
> > > > most people read it and
> > > > cast their votes.
> > > >
> > > >
> > > > John McNally brought up a good point about the
> > > > location of the coding
> > > > convention specification. Here's a slightly
> amended
> > > > proposal which takes
> > > > that into account.
> > > >
> > > >
> > > > From the various threads on this subject, I
> feel
> > > > that we've more or less
> > > > reached informal concensus, so I'd like to
> make a
> > > > concrete proposal and call
> > > > for a vote.
> > > >
> > > > I propose to make the following changes to the
> > > > Guidelines section of the
> > > > Commons charter:
> > > >
> > > > 1) Replace the 3rd sentence of item 17 with
> the
> > > > following:
> > > >
> > > > ---------------
> > > > Proposals are to identify the rationale for
> the
> > > > package, its scope, its
> > > > interaction with other packages and products,
> the
> > > > Commons resources, if any,
> > > > to be created, the initial source from which
> the
> > > > package is to be created,
> > > > the coding conventions used for the package
> (if
> > > > different from the Sun
> > > > coding conventions), and the initial set of
> > > > committers.
> > > > ---------------
> > > >
> > > > The only change here is the addition of the
> item
> > > > about coding conventions.
> > > >
> > > > 2) After the current item 20 (which is about
> the CVS
> > > > repository):
> > > >
> > > > ---------------
> > > > 21. Each Commons component should use an
> internally consistent and
> > > > documented coding style. When the source code
> for a
> > > > component originates in
> > > > a pre-existing code base outside of Commons,
> the
> > > > coding style of that code
> > > > base may be retained at the discretion of the
> > > > initial committers. If a
> > > > component does not specify its coding style,
> the Sun
> > > > Coding Convention
> > > > guidelines are assumed.
> > > > ---------------
> > > >
> > > > (Acknowledgements to Morgan for most of this
> > > > wording.)
> > > >
> > > > In addition, I propose the following addition
> to the
> > > > Example Package
> > > > Proposal of the charter:
> > > >
> > > > ---------------
> > > > (2.2) identify the coding conventions for this
> > > > package
> > > >
> > > > The code uses the conventions from the Jakarta
> > > > Turbine package.
> > > > ---------------
> > > >
> > > > The above changes have my +1.
> > > >
> > > > --
> > > > Martin Cooper
> > > >
> > > >
> > > > --
> > > > To unsubscribe, e-mail:
> > > >
> <ma...@jakarta.apache.org>
> > > > For additional commands, e-mail:
> > > > <ma...@jakarta.apache.org>
> > > >
> > >
> > >
> > > =====
> > > Morgan Delagrange
> > > http://jakarta.apache.org/taglibs
> > > http://jakarta.apache.org/commons >
> http://axion.tigris.org
> > > http://jakarta.apache.org/watchdog
> > >
> > >
> > >
> > >
> __________________________________________________
> > > Do You Yahoo!?
> > > HotJobs - Search Thousands of New Jobs
> > > http://www.hotjobs.com
> > >
> > > --
> > > To unsubscribe, e-mail:
> > > <mailto:commons-dev->
> unsubscribe@jakarta.apache.org>
> > > For
> > > additional commands,
> > > e-mail:
> <ma...@jakarta.apache.org>
> > >
> > >
> >
> > --
> > To unsubscribe, e-mail:
> <ma...@jakarta.apache.org>
> > For additional commands, e-mail:
> <ma...@jakarta.apache.org>
> >
>
>
>
> --
> To unsubscribe, e-mail:
> <ma...@jakarta.apache.org>
> For additional commands, e-mail:
> <ma...@jakarta.apache.org>
>
=====
Morgan Delagrange
http://jakarta.apache.org/taglibs
http://jakarta.apache.org/commons
http://axion.tigris.org
http://jakarta.apache.org/watchdog
__________________________________________________
Do You Yahoo!?
HotJobs - Search Thousands of New Jobs
http://www.hotjobs.com
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>