====== White and black space ======

Neither white nor black space has any function, but it is used to arrange characters on the screen, and/or make your code easier to read. Such characters are ''space'', ''tab'' and ''newline''. Do not use ''carriage return'' or other fancy stuff. On this page, we summarise the most important rules. If there are violations in the code, they should be fixed when the code is edited. Ideally this happens for some other reason.

===== White space =====

White space consists of characters that have no visual screen representation, but  may be used to organise screen contents.

  * Use 2 (two) spaces for indentation.
  * A tab character may be used to represent 8 space characters.
  * Inlined function implementation in a class or struct use compact spacing. Move functions elsewhere if this becomes messy.

    class FOO : public BAR {
      int _a{0};
    public:
      explicit FOO : BAR() {}
    
      int get_a()const { return _a; }
      int get_two_a()const;
    };
    
  * The header of a function that is not implemented inside a struct or class acts as a headline. This line ends after the argument list, i.e. the function block starts in the line below.

    int FOO:::get_two_a() const
    {
      int tmp = _a;
      tmp += _a;
      return _a;
    }
    
===== Black space =====

Black space consists of visible characters used to delimit content. The most important one is the separation line.
It consists of ''/*'' followed by 74x ''-'' and ''*/''. This line is used between class and function definitions.
Normal code should not show as more than 78 characters wide, excluding the newline chararcter at the end.