Re: Artistic style.

From: Jens Ivar Jordre (jens@fi.uib.no)
Date: Wed Feb 07 2001 - 15:09:42 EST

  • Next message: Hironori Ito: "Re: New BrRdoModuleZDC in brat"

    On Wed, 7 Feb 2001, Konstantin Olchanski wrote:
    
    > On Wed, Feb 07, 2001 at 07:41:44PM +0100, Jens Ivar Jordre wrote:
    > >
    > > I'd just like to point out a useful program for our coding and different
    > > conventions. The program is called Artistic Style. It does indention
    > > and formatting of raw C, C++ and Java code.
    >
    >
    > These programs are a dime a dozen. Nothing to get excited about.
    
    At least I agree with the first one.
    
    > > If used, it will make our code easier to read.
    >
    > I rather doubt this claim. The best way (the only way) to make code easy
    > to read is to *write good code*. Linus Torvalds wrote quite a few
    > excellent assays on this.
    
    Couldn't agree more regarding the best way. However, it is easier to read
    code that has structured indention than complete anarchy.
    
    > Besides, shuffling around already written and debugged code
    > has a good chance of breaking it and makes it harder for
    > the *author* to read it. It also breaks the "cvs annotate" functionality
    > by changing "every line in every file".
    
    Well, at least for new classes/macros/private stuff/major revisions it
    can be used without breaking annotate functionality in cvs.
    
    > > It has some built in styles. Maybe we could settle upon one of these.
    >
    >
    > Coding styles, "spaces per tab", the only right place to put the curly
    > braces, underscores versus mixed-case in variable names, kConstant
    > versus UPPER_CASE_CONSTANT.
    
    It only deals with indentation. Style on data members, function names etc.
    is not touched.
    
    > Being there done that. Do we get to vote on each feature? (Yawn...)
    >
    >
    > > A link to its sourceforge web page is put on the regular private area
    > > computing page: http://www.rhic.bnl.gov/brahms/WWW/private/computing.html
    > > The direct link is: http://astyle.sourceforge.net
    > >
    > > Do try it out!!!
    >
    > Don't waste your time. Go and write some good code instead.
    
    Depending on your taste, chose from any of the two statements above.
    
    ---
    Jens Ivar Jřrdre, Dep. of Phys., Allégt. 55, N-5007 BERGEN, NORWAY
    room 521, e-mail: JensIvar.Jordre@fi.uib.no, phone: (+47) 55 58 27 92
    



    This archive was generated by hypermail 2b29 : Wed Feb 07 2001 - 14:08:17 EST