You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@directory.apache.org by Emmanuel Lecharny <el...@iktek.com> on 2006/11/03 00:57:23 UTC
Coding standards
Hi guys,
I have drafted some doco about the current coding standards we are
(supposed) to follow :
http://cwiki.apache.org/confluence/display/DIRxSRVx10/ApacheDS+v1.0+Developers%27s+Guide
Please correct me if I'm wrong, and add anything which may be MIA :)
Note : This is just what I collected from the current code base. It
doesn't express any of my personnal taste in matter of coding. Don't
take it as a personnal offense if you dislike the rules. And please, no
thread about pros/cons of having a '{' at the end of a line or at the
beginning of the next line, or such things that have been definitively
stated back in the last century ;)
Emmanuel
Re: Coding standards
Posted by Ersin Er <er...@gmail.com>.
Hi,
Just a suggestion for the sake of Confluence instance:
On 11/3/06, Emmanuel Lecharny <el...@iktek.com> wrote:
> Hi guys,
>
> I have drafted some doco about the current coding standards we are
> (supposed) to follow :
> http://cwiki.apache.org/confluence/display/DIRxSRVx10/ApacheDS+v1.0+Developers%27s+Guide
Let's work with the static URLs:
http://cwiki.apache.org/DIRxSRVx10/apacheds-v10-developerss-guide.html
> Please correct me if I'm wrong, and add anything which may be MIA :)
>
> Note : This is just what I collected from the current code base. It
> doesn't express any of my personnal taste in matter of coding. Don't
> take it as a personnal offense if you dislike the rules. And please, no
> thread about pros/cons of having a '{' at the end of a line or at the
> beginning of the next line, or such things that have been definitively
> stated back in the last century ;)
>
> Emmanuel
>
>
>
--
Ersin
Re: Coding standards
Posted by Ceki Gülcü <li...@qos.ch>.
Some ASF members, including directors (names withheld protect the
innocent), will say that making a recommendation about author tags is one
of the worst decisions made by the board. Anyway, the decision has been
discussed many times over and I find it a little discouraging that the
weight of the formal recommendation tends to drown any reasonable
discussion on the matter.
At 11:48 AM 11/3/2006, you wrote:
>No, don't feel like that, because it's not so clear. We have had a lot of
>discussion about @author tags, especially about those which existed when
>we imported some java classes from other apache project, to eliminate
>some dependencies. (not sure we have chose the best solution ;)
>
>Emmanuel.
>
>On 11/3/06, Danny Angus
><<m...@slc.co.uk> wrote:
>>"Emmanuel Lecharny" <<m...@gmail.com>
>>wrote on 03/11/2006 10:23:41:
>>
>> > Yeah, this the reason why we only put : @author <a href="mailto:
>> > <ma...@directory.apache.org>dev@directory.apache.org">Apache
>> Directory Project</a>
>>
>>OMG, that makes so much sense I feel like a total idiot!
>--
>Cordialement,
>Emmanuel Lécharny
--
Ceki Gülcü
Logback: The reliable, generic, fast and flexible logging framework for Java.
http://logback.qos.ch
Re: Coding standards
Posted by Emmanuel Lecharny <el...@gmail.com>.
No, don't feel like that, because it's not so clear. We have had a lot of
discussion about @author tags, especially about those which existed when we
imported some java classes from other apache project, to eliminate some
dependencies. (not sure we have chose the best solution ;)
Emmanuel.
On 11/3/06, Danny Angus <Da...@slc.co.uk> wrote:
>
> "Emmanuel Lecharny" <el...@gmail.com> wrote on 03/11/2006 10:23:41:
>
> > Yeah, this the reason why we only put : @author <a href="mailto:
> > dev@directory.apache.org">Apache Directory Project</a>
>
> OMG, that makes so much sense I feel like a total idiot!
>
>
> *******************************************************************************************************
> The information in this e-mail is confidential and for use by the
> addressee(s) only. If you are not the intended recipient please delete the
> message from your computer. You may not copy or forward it or use or
> disclose its contents to any other person. As Internet communications are
> capable of data corruption Student Loans Company Limited does not accept any
> responsibility for changes made to this message after it was sent. For this
> reason it may be inappropriate to rely on advice or opinions contained in an
> e-mail without obtaining written confirmation of it. Neither Student Loans
> Company Limited or the sender accepts any liability or responsibility for
> viruses as it is your responsibility to scan attachments (if any). Opinions
> and views expressed in this e-mail are those of the sender and may not
> reflect the opinions and views of The Student Loans Company Limited.
>
> This footnote also confirms that this email message has been swept for the
> presence of computer viruses.
>
>
> ********************************************************************************************************
>
--
Cordialement,
Emmanuel Lécharny
Re: Coding standards
Posted by Danny Angus <Da...@slc.co.uk>.
"Emmanuel Lecharny" <el...@gmail.com> wrote on 03/11/2006 10:23:41:
> Yeah, this the reason why we only put : @author <a href="mailto:
> dev@directory.apache.org">Apache Directory Project</a>
OMG, that makes so much sense I feel like a total idiot!
*******************************************************************************************************
The information in this e-mail is confidential and for use by the addressee(s) only. If you are not the intended recipient please delete the message from your computer. You may not copy or forward it or use or disclose its contents to any other person. As Internet communications are capable of data corruption Student Loans Company Limited does not accept any responsibility for changes made to this message after it was sent. For this reason it may be inappropriate to rely on advice or opinions contained in an e-mail without obtaining written confirmation of it. Neither Student Loans Company Limited or the sender accepts any liability or responsibility for viruses as it is your responsibility to scan attachments (if any). Opinions and views expressed in this e-mail are those of the sender and may not reflect the opinions and views of The Student Loans Company Limited.
This footnote also confirms that this email message has been swept for the presence of computer viruses.
********************************************************************************************************
Re: Coding standards
Posted by Emmanuel Lecharny <el...@gmail.com>.
Yeah, this the reason why we only put : @author <a href="mailto:
dev@directory.apache.org">Apache Directory Project</a>
On 11/3/06, Danny Angus <Da...@slc.co.uk> wrote:
>
> Emmanuel Lecharny <el...@iktek.com> wrote on 02/11/2006 23:57:23:
>
> >
> > Please correct me if I'm wrong, and add anything which may be MIA :)
> >
>
> Not really my business, but... I think that @author tags are frowned upon
> by the ASF.
>
> d.
>
>
> *******************************************************************************************************
> The information in this e-mail is confidential and for use by the
> addressee(s) only. If you are not the intended recipient please delete the
> message from your computer. You may not copy or forward it or use or
> disclose its contents to any other person. As Internet communications are
> capable of data corruption Student Loans Company Limited does not accept any
> responsibility for changes made to this message after it was sent. For this
> reason it may be inappropriate to rely on advice or opinions contained in an
> e-mail without obtaining written confirmation of it. Neither Student Loans
> Company Limited or the sender accepts any liability or responsibility for
> viruses as it is your responsibility to scan attachments (if any). Opinions
> and views expressed in this e-mail are those of the sender and may not
> reflect the opinions and views of The Student Loans Company Limited.
>
> This footnote also confirms that this email message has been swept for the
> presence of computer viruses.
>
>
> ********************************************************************************************************
>
--
Cordialement,
Emmanuel Lécharny
Re: Coding standards
Posted by Alex Karasulu <ao...@bellsouth.net>.
Danny Angus wrote:
> Emmanuel Lecharny <el...@iktek.com> wrote on 02/11/2006 23:57:23:
>
>> Please correct me if I'm wrong, and add anything which may be MIA :)
>>
>
> Not really my business, but... I think that @author tags are frowned upon
> by the ASF.
Yeah we don't use me. Why does the coding standards use an @author tag?
Alex
Re: Coding standards
Posted by Danny Angus <Da...@slc.co.uk>.
Emmanuel Lecharny <el...@iktek.com> wrote on 02/11/2006 23:57:23:
>
> Please correct me if I'm wrong, and add anything which may be MIA :)
>
Not really my business, but... I think that @author tags are frowned upon
by the ASF.
d.
*******************************************************************************************************
The information in this e-mail is confidential and for use by the addressee(s) only. If you are not the intended recipient please delete the message from your computer. You may not copy or forward it or use or disclose its contents to any other person. As Internet communications are capable of data corruption Student Loans Company Limited does not accept any responsibility for changes made to this message after it was sent. For this reason it may be inappropriate to rely on advice or opinions contained in an e-mail without obtaining written confirmation of it. Neither Student Loans Company Limited or the sender accepts any liability or responsibility for viruses as it is your responsibility to scan attachments (if any). Opinions and views expressed in this e-mail are those of the sender and may not reflect the opinions and views of The Student Loans Company Limited.
This footnote also confirms that this email message has been swept for the presence of computer viruses.
********************************************************************************************************