Add very simple main page to include/libcgroup.h. It contains just very
basic info and links to the other modules. Feel free to elaborate more on
this, it could contain lot more:
 - how to complie with libcgroup (=pkgconfig)?
 - how to report errors
 - links to samples
 - link to home page
 - info about threading
 etc.

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Update doxygen config file to 1.6.1 + add comments + change following
settings:

OUTPUT_DIRECTORY = doc/generated
ALWAYS_DETAILED_SEC = YES - we want all function in detailed list
JAVADOC_AUTOBRIEF = YES - IMHO the least painfull way to extract brief
desxcription, see doxygen docs for the other ways. But still painful enough :(
OPTIMIZE_OUTPUT_FOR_C  = YES - we're C project
IDL_PROPERTY_SUPPORT   = NO - we're C project
WARN_NO_PARAMDOC = YES - document all function parameters please!
INPUT = include - generate public docs only
GENERATE_LATEX = NO - no LaTeX for now, maybe later
*_GRAPH = NO - no call/include graphs in public docs


Signed-off-by: Jan Safranek <jsafrane@redhat.com>

Pre:
total: 1 errors, 10 warnings, 817 lines checked

Post:
total: 0 errors, 4 warnings, 818 lines checked

Unfixed warnings are because they break text and therefore capabilities
to easily grep through.

Signed-off-by: Dhaval Giani <dhaval.giani@gmail.com>

Pre:
total: 0 errors, 3 warnings, 638 lines checked

Post:
total: 0 errors, 0 warnings, 640 lines checked

Signed-off-by: Dhaval Giani <dhaval.giani@gmail.com>