Modify API, complete API documentation

Colour and icon escape sequences enclose their argument in braces now.
Also, the icon escape sequence is in caps, to be more conform with
foreground and background (escape sequences taking argument values).

The API documentation should now cover all of the things present in
karuibar.h. The escape sequences should be covered, too.