C Header Style Guide

FreeBASIC

C Header Style Guide
 
About This Guide

This guide is not a C tutorial or a step by step guide for converting headers. This is a style guide which represents the ideal header we would like to maintain. Currently not all of the headers under our control conform to this guide 100%, but work is in progress to do this and all new contributions should attempt to use these standards.

General


  • Translations should be very close to the original, so they look familiar and can be updated easily.
  • Identifiers (including any #defines) should not be changed unless absolutely necessary.
  • Smaller files may be combined into one bigger header, if they would be #included anyways and all belong to the same library.
  • Original license should be retained.

Coding style


  • Headers need to work with the latest FreeBASIC version.
  • Naming conflicts between multiple identifiers (due to FreeBASIC's case insensitivity) or an identifier and a FreeBASIC keyword should be resolved by appending an underscore to one identifier.
  • extern "c" blocks should be used instead of cdecl alias "..." for function declarations or function pointer types.
  • Preprocessor directives (including #defines) should be preserved. Exception: Remove if they serve only to select options for different C compilers, i.e. extern differences, then these can be removed unless they provide support for further code. When choosing compilers the choice should favor GNU C.
  • FreeBASIC keywords should be lower-case.

Dealing with constructs not supported by FreeBASIC


  • Inline functions should be converted to a macro if appropriate.
  • Preprocessor directives inside structure declarations, function bodies, or similar may need to be moved outside because in FreeBASIC they'd be scoped.
  • Declarations spread across multiple lines with preprocessor directives in between them (for example function declarations, or array initializers) will need to be manually rewritten