Browse Source

Documentation: move support for old compilers to CodingGuidelines

The "Try to be nice to older C compilers" text is clearly a guideline
to be borne in mind whilst coding rather than when submitting patches.

Signed-off-by: Adam Spiers <git@adamspiers.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Adam Spiers 12 years ago committed by Junio C Hamano
parent
commit
a26fd033af
  1. 8
      Documentation/CodingGuidelines
  2. 13
      Documentation/SubmittingPatches

8
Documentation/CodingGuidelines

@ -112,6 +112,14 @@ For C programs: @@ -112,6 +112,14 @@ For C programs:

- We try to keep to at most 80 characters per line.

- We try to support a wide range of C compilers to compile git with,
including old ones. That means that you should not use C99
initializers, even if a lot of compilers grok it.

- Variables have to be declared at the beginning of the block.

- NULL pointers shall be written as NULL, not as 0.

- When declaring pointers, the star sides with the variable
name, i.e. "char *string", not "char* string" or
"char * string". This makes it easier to understand code

13
Documentation/SubmittingPatches

@ -127,19 +127,6 @@ in templates/hooks--pre-commit. To help ensure this does not happen, @@ -127,19 +127,6 @@ in templates/hooks--pre-commit. To help ensure this does not happen,
run git diff --check on your changes before you commit.


(1a) Try to be nice to older C compilers

We try to support a wide range of C compilers to compile
git with. That means that you should not use C99 initializers, even
if a lot of compilers grok it.

Also, variables have to be declared at the beginning of the block
(you can check this with gcc, using the -Wdeclaration-after-statement
option).

Another thing: NULL pointers shall be written as NULL, not as 0.


(2) Generate your patch using git tools out of your commits.

git based diff tools generate unidiff which is the preferred format.

Loading…
Cancel
Save