Update documentation / code comments a little.

Signed-off-by: Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>