Cleanup: comment mismatch with code

Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Move "hello-static-lib" to doc/examples and add non-automake Makefiles

The examples are now automatically built as part of the default make target
and plain Makefiles with no dependency on automake are provided for clarity.

Update the manpage and README to reflect the change and remove lots of trailing
whitespace.

Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>