Improved documentation

Add more cases, add handler documentation, and so on.

Signed-off-by: Stefano Babic <sbabic@denx.de>