Improved documentation of PicaDecoder.

Added an in-depth description of the parser behaviour.