Style guide

This is style guide for fish contributors. You should use it for any new code that you would add to this project and try to format existing code to use this style.

Formatting

Always use 2 spaces instead tabs as indent (unless needed like Makefile).

Opening curly bracket is always the same line as declaration.

 // ✔:
 struct name {
   // code
 };

 void func() {
   // code
 }

 if (...) {
   // code
 }

 // ✗:
 void func()
 {
   // code
 }

Put space after if, while and for before conditions.
```
 // ✔:
 if () {}

 // ✗:
 if() {}
```
Put spaces before and after operators excluding increment and decrement;
```
 // ✔:
 int a = 1 + 2 * 3;
 a++;

 // ✗:
 int a=1+2*3;
 a ++;
```
Never put spaces between function name and parameters list.
```
 // ✔:
 func(args);

 // ✗:
 func (args);
```
Never put spaces after ( and before ).

Always put space after comma and semicolon.

 // ✔:
 func(arg1, arg2);

 for (int i = 0; i < LENGTH; i++) {}

 // ✗:
 func(arg1,arg2);

 for (int i = 0;i<LENGTH;i++) {}

Documentation

Document your code using Doxygen.

Documentation comment should use double star notation or tipple slash:

 // ✔:
 /// Some var
 int var;

 /**
  * Some func
  */
 void func();

Use slash as tag mark:

 // ✔:

 /**
  * \param a an integer argument.
  * \param s a constant character pointer.
  * \return The results
  */
 int foo(int a, const char *s);

Naming

All names in code should be small_snake_case. No Hungary notation is used. Classes and structs names should be followed by _t.

1.9 KiB Raw Blame History

Style guide

Formatting

Documentation

Naming

1.9 KiB

Raw Blame History