Add documentation in response to Pawel's comments:   http://code.google.com/p/soc/source/detail?r=832
Add documentation in response to Pawel's comments:
  http://code.google.com/p/soc/source/detail?r=832

Patch by: Todd Larsen
Review by: to-be-reviewed

--HG--
extra : convert_revision : svn%3A32761e7d-7263-4528-b7be-7235b26367ec/trunk%40855

SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange,SRabbelier/Melange