Fix typo in headers.c

Signed-off-by: Olivier Mehani <olivier.mehani@nicta.com.au>
Section omlc_inject(3) better

Signed-off-by: Olivier Mehani <olivier.mehani@nicta.com.au>
Delegate self-instrumentation to a specific function

Signed-off-by: Olivier Mehani <olivier.mehani@nicta.com.au>
Refactor buffered writer

 * Properly cleanup reading flag in processChain;
 * Make a clearer distinction between chunks and chain;
 * Fix Doxygen markup;

Problem: no count is kept of data dropped in the buffers.

fixes: #1528
refs: #1471, #1545

Signed-off-by: Olivier Mehani <olivier.mehani@nicta.com.au>