improving documentation on parsing functions

git-svn-id: http://svn.code.sf.net/p/sumo/code/trunk/sumo@16172 29f149b2-0c63-11e1-8f5c-a347f6a9acd0