Skip to Content.
Sympa Menu

ndt-dev - Re: [ndt-dev] c code style

Please Wait...

ndt-dev@internet2.edu

Subject: NDT-DEV email list created

List archive

Re: [ndt-dev] c code style


Chronological Thread 
  • From: Dominic Hamon <dominic@measurementlab.net>
  • To: Aaron Brown <aaron@internet2.edu>, Kavitha Kumar <kkumar@internet2.edu>, ndt-dev@internet2.edu
  • Subject: Re: [ndt-dev] c code style
  • Date: Wed, 7 Nov 2012 09:57:51 -0800

Here's the full patch.



On Tue, Nov 6, 2012 at 9:36 AM, Dominic Hamon <dominic@measurementlab.net> wrote:


On Mon, Nov 5, 2012 at 1:01 PM, Aaron Brown <aaron@internet2.edu> wrote:
Hey Dominic,


On Nov 5, 2012, at 3:51 PM, Dominic Hamon <dominic@measurementlab.net> wrote:

I'm looking at using cpplint.py from here but I had to do two things:

1. Change the filter so it considers files with a .c extension.

Are you making changes to cpplint.py?

Yes - it's a one line change just to make it consider plain .c files. It might be worth keeping the updated version in the tree somewhere.
 

2. Use the following command line: 'cpplint.py --filter=-build/include_order,-legal/copyright,-readability/casting $file' to remove some cases that we probably don't care about.

Could you send a an existing NDT .c file, and that same file after the lint has been run. 

Attached patch with a number of files updated so you can see the differences.
 


wdyt?

Dominic Hamon | Measurement Lab


On Tue, Oct 30, 2012 at 8:59 AM, Kavitha Kumar <kkumar@internet2.edu> wrote:
Hi Dominic,

   Yes, you're right w.r.t the GNU style braces and indentation. Eclipse does seem to use these, so it might have been an error on my side.

Basically, our goal for formatting-style was to enable code to be easily readable, consistent, attractive to newer members of the NDT dev community, and easy to use before committing code into the repositories.

So, its of equal value if you'd prefer to change it to google or GNU style (Aaron and Nils second this on my side). But it would be great if you documented your style suggestions and include your script (if you used "indent" or so) so that everyone has access to it in future. You could add documentation to the wiki pages.

W.r.t your question about persuading GNU indent to speak google : that's easy to do in Eclipse. You can set the "code style" settings for many parameters, and can even alter default profiles like GNU/K&R to have your preferences for just a few parameters.

Thanks,
Kavitha

----- Original Message -----
> From: "Dominic Hamon" <dominic@measurementlab.net>
> To: "Kavitha Kumar" <kkumar@internet2.edu>
> Cc: ndt-dev@internet2.edu, "Aaron Brown" <aaron@internet2.edu>
> Sent: Tuesday, October 30, 2012 11:23:05 AM
> Subject: Re: [ndt-dev] c code style
>
> Hi Kavitha
>
>
> I wonder if Eclipse is using some other definition of GNU style than
> the one I know[1] as it doesn't look much like GNU style. That has
> things like braces on column one for functions, structs, and enums,
> and the C code here has the braces in line with the first line of a
> block.
>
>
> The existing code has quite a bit in common with Google standard[2]
> except for the indent being mostly 8 instead of 2. Let me know if
> changing the indent is something that you're passionate about as I
> know many people are.
>
>
> I'm not sure if GNU indent can be persuaded to speak Google style,
> but it can definitely get part of the way there.
>
>
> 1. http://www.gnu.org/prep/standards/standards.html#Formatting
> 2. http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
>
>
>
> On Tue, Oct 30, 2012 at 4:21 AM, Kavitha Kumar < kkumar@internet2.edu
> > wrote:
>
>
> Hi Dominic,
> I used the GNU style formatting for the C code. I basically got lazy
> and used Eclipse to format my code.
>
> And when I did so, I made a separate commit for the formatted code
> alone so that it was easy to "number" it with svn.
>
> HTH,
> Kavitha
>
>
>
> ----- Original Message -----
> > From: "Dominic Hamon" < dominic@measurementlab.net >
> > To: "Aaron Brown" < aaron@internet2.edu >
> > Cc: ndt-dev@internet2.edu
> > Sent: Monday, October 29, 2012 3:36:09 PM
> > Subject: Re: [ndt-dev] c code style
> >
> >
> >
> >
> >
> > On Mon, Oct 29, 2012 at 6:48 AM, Aaron Brown < aaron@internet2.edu
> > >
> > wrote:
> >
> >
> >
> > Hey Dominic,
> >
> >
> >
> >
> > On Oct 26, 2012, at 4:10 PM, Dominic Hamon wrote:
> >
> >
> >
> > Is there an existing code style for the c code in ndt? I noticed
> > that
> > some of the files seem to have odd wrapping and indenting, but that
> > might be a mistake due to merging in the past.
>
> >
> > I'd like to clean up the code formatting but I don't know what
> > style
> > to use.
> >
> > As long as it's standardized and easy to reproduce, I don't have a
> > strong opinion on the matter. My only preference would be to use
> > one
> > that minimizes the amount of change from the existing scheme (to
> > avoid unnecessary churn).
> >
> >
> > I understand. My preference would be the Google C++ style (
> > http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml )
> > which is pretty much what ndt follows, except for the indentation.
> >
> >
> > I'm happy to fix up the existing code to the style, but I
> > understand
> > that might be too much change 'just' for formatting. WDYT?
> >
> >
> >
> >
> >
> >
> >
> > Cheers,
> > Aaron
> >
> >
> > TIP2013, University of Hawaii Mānoa
> > January 13 - January 17, 2013, Honolulu, HI
> > http://events.internet2.edu/2013/tip/
> >
> >
>
>


TIP2013, University of Hawaii Mānoa
January 13 - January 17, 2013, Honolulu, HI
http://events.internet2.edu/2013/tip/



Attachment: ndt-style.patch
Description: Binary data




Archive powered by MHonArc 2.6.16.

Top of Page