Para lograr un estilo de código razonable, basta con ser
ordenados y leer un poco de código de programadores con mayor experiencia.
Aunque no existe un estilo de código,
Linus Torvalds escribió un documento al respecto que se puede encontrar
en varios formatos, por ejemplo en
español
o en inglés.
Otra referencia clásica es
Recommended C Style and Coding Standards.
Utilidades como indent pueden ayudar, pero el estilo de código
suele ser algo bastante personal como para ser capturado por un programa UNIX
o impuesto por alguien.
El estilo de código deberá ser uniforme en todos los archivos que
lo conforman.
Los archivos de cabecera, al ser la interface del módulo, deberán ser comentados en cada función con pre y post aunque sea de manera informal, a fin de conocer la funcionalidad de cada una.
El código además de compilar correctamente, no deberá generar ningún warning frente a las siguientes opciones de compilación:
-Wall |