From: Bernhard H. <ber...@be...> - 2004-02-22 20:58:15
|
Hi, several people have joined the developer group during the last months, with an increasing number of windoze based developers. Of course this is a positive evolution, but some of you brought their own coding style to SDCC. This is not a crime, but you've certainly already made the experience, that it is difficult to read an unusual formatted code. A common formatting standard makes co-operation easier. Therefore please allow me to remember you that SDCC's coding style should comply with the "GNU coding standards". C code should be formatted like this: http://www.gnu.org/prep/standards_23.html#SEC23 For identation 2 spaces are used. A tab has to be 8 spaces wide; choosing a different tab width is IMHO one of the more inconsiderate violations. ChangeLog: The major editors on Linux provide syntax-coloring even for the Change Log. A greater violation of the formatting standard looks really ugly. If you want to know how the ChangeLog should be formatted see here: http://www.gnu.org/prep/standards_42.html#SEC42 Thanks for considering the standards, Bernhard |
From: Borut R. <bor...@si...> - 2007-02-17 16:24:06
|
Hi, I added the SDCC coding style document to the SDCC Release Wiki. See http://sdcc.sourceforge.net/release_wiki/index.php?page=SDCC+coding+style. Comments are appreciated. Borut |
From: Bernhard H. <sdc...@be...> - 2007-02-17 20:38:20
|
> I added the SDCC coding style document to the SDCC Release Wiki. > See > http://sdcc.sourceforge.net/release_wiki/index.php?page=SDCC+coding+style. > > Comments are appreciated. I clearly appreciate an official SDCC coding style. It should be clarified that the source shouldn't be modified just because of the coding style. This unnessesarly breaks the history. BTW: GNU also defines a style for Change Logs: http://www.gnu.org/prep/standards/html_node/Change-Logs.html I propose to add it to the wiki. Bernhard |
From: Borut R. <bor...@si...> - 2007-02-17 21:43:21
|
Bernhard Held wrote: > I clearly appreciate an official SDCC coding style. > > It should be clarified that the source shouldn't be modified just because of > the coding style. This unnessesarly breaks the history. > > BTW: GNU also defines a style for Change Logs: > http://www.gnu.org/prep/standards/html_node/Change-Logs.html > I propose to add it to the wiki. > I totally agree with everything you wrote. I currently don't have to update the Wiki and page and I'll be absent the next week. Can you update it? Borut |
From: Raphael N. <rn...@we...> - 2007-02-18 21:46:30
|
> > It should be clarified that the source shouldn't be modified just because of > > the coding style. This unnessesarly breaks the history. > > > > BTW: GNU also defines a style for Change Logs: > > http://www.gnu.org/prep/standards/html_node/Change-Logs.html > > I propose to add it to the wiki. > > > I totally agree with everything you wrote. I currently don't have to > update the Wiki and page and I'll be absent the next week. Can you > update it? Done. Raphael |
From: Borut R. <bor...@si...> - 2007-02-26 06:53:09
|
Thank you, Raphael! Sorry for the cryptic mail I sent, but it seems you understood it anyway :-[ I was so short in time while I wrote it that I didn't have time to write that I don't have "time" to update the Wiki page... Borut Raphael Neider wrote: >>> It should be clarified that the source shouldn't be modified just because of >>> the coding style. This unnessesarly breaks the history. >>> >>> BTW: GNU also defines a style for Change Logs: >>> http://www.gnu.org/prep/standards/html_node/Change-Logs.html >>> I propose to add it to the wiki. >>> >>> >> I totally agree with everything you wrote. I currently don't have to >> update the Wiki and page and I'll be absent the next week. Can you >> update it? >> > > Done. > > Raphael > |