libcaca-style(3caca) [debian man page]

libcaca-style(3caca)						      libcaca						      libcaca-style(3caca)

NAME

       libcaca-style - Libcaca coding style

General guidelines
       A pretty safe rule of thumb is: look at what has already been done and try to do the same.

       o Tabulations should be avoided and replaced with eight spaces.

       o Indentation is generally 4 spaces.

       o Lines should wrap at most at 79 characters.

       o Do not leave whitespace at the end of lines.

       o Do not use multiple spaces for anything else than indentation.

       o Code qui fait des warnings == code de porc == deux baffes dans ta gueule

C coding style
       Try to use short names whenever possible (i for indices, w for width, cv for canvas...). Macros are always uppercase, variable and function
       names are always lowercase. Use the underscore to separate words within names:

       #define BROKEN 0
       #define MAX(x, y) ((x > y) ? (x) : (y))

       unsigned int x, y, w, h;
       char *font_name;
       void frobulate_every_three_seconds(void);

       const is a suffix. It's char const *foo, not const char *foo.

       Use spaces after commas and between operators. Do not use spaces after an opening parenthesis or before a closing one:

       a += 2;
       b = (a * (c + d));
       x = min(x1, x2, x3);

       Do not put a space between functions and the corresponding opening parenthesis:

       int function(int);

       A space can be inserted after keywords such as for, while or if, but consistency with the rest of the page is encouraged:

       if(a == b)
	   return;

       if (p == NULL)

       Do not put parentheses around return values:

       return a + (b & x) + d[10];

       Opening braces should be on a line of their own, aligned with the current block. Braces are optional for one-liners:

       int function(int a)
       {
	   if(a & 0x84)
	       return a;

	   if(a < 0)
	   {
	       return -a;
	   }
	   else
	   {
	       a /= 2;

	       switch(a)
	       {
		   case 0:
		   case 1:
		       return -1;
		       break;
		   default:
		       return a;
	       }
	   }
       }

C++ coding style
       Nothing here yet.

Version 0.99.beta18						  Fri Apr 6 2012					      libcaca-style(3caca)

libcaca attribute definitions(3caca)				      libcaca				      libcaca attribute definitions(3caca)

NAME

       libcaca attribute definitions -

   Enumerations
       enum caca_color { CACA_BLACK =  0x00, CACA_BLUE =  0x01, CACA_GREEN =  0x02, CACA_CYAN =  0x03, CACA_RED =  0x04, CACA_MAGENTA =  0x05,
	   CACA_BROWN =  0x06, CACA_LIGHTGRAY =  0x07, CACA_DARKGRAY =	0x08, CACA_LIGHTBLUE =	0x09, CACA_LIGHTGREEN =  0x0a, CACA_LIGHTCYAN =
	   0x0b, CACA_LIGHTRED =  0x0c, CACA_LIGHTMAGENTA =  0x0d, CACA_YELLOW =  0x0e, CACA_WHITE =  0x0f, CACA_DEFAULT =  0x10, CACA_TRANSPARENT
	   =  0x20 }
       enum caca_style { CACA_BOLD =  0x01, CACA_ITALICS =  0x02, CACA_UNDERLINE =  0x04, CACA_BLINK =	0x08 }

Detailed Description
       Colours and styles that can be used with caca_set_attr().

Enumeration Type Documentation
   enum caca_color libcaca colour keyword
       Enumerator:

       CACA_BLACK
	      The colour index for black.

       CACA_BLUE
	      The colour index for blue.

       CACA_GREEN
	      The colour index for green.

       CACA_CYAN
	      The colour index for cyan.

       CACA_RED
	      The colour index for red.

       CACA_MAGENTA
	      The colour index for magenta.

       CACA_BROWN
	      The colour index for brown.

       CACA_LIGHTGRAY
	      The colour index for light gray.

       CACA_DARKGRAY
	      The colour index for dark gray.

       CACA_LIGHTBLUE
	      The colour index for blue.

       CACA_LIGHTGREEN
	      The colour index for light green.

       CACA_LIGHTCYAN
	      The colour index for light cyan.

       CACA_LIGHTRED
	      The colour index for light red.

       CACA_LIGHTMAGENTA
	      The colour index for light magenta.

       CACA_YELLOW
	      The colour index for yellow.

       CACA_WHITE
	      The colour index for white.

       CACA_DEFAULT
	      The output driver's default colour.

       CACA_TRANSPARENT
	      The transparent colour.

   enum caca_style libcaca style keyword
       Enumerator:

       CACA_BOLD
	      The style mask for bold.

       CACA_ITALICS
	      The style mask for italics.

       CACA_UNDERLINE
	      The style mask for underline.

       CACA_BLINK
	      The style mask for blink.

Author
       Generated automatically by Doxygen for libcaca from the source code.

Version 0.99.beta18						  Fri Apr 6 2012			      libcaca attribute definitions(3caca)