Improving documentation of Societe class
Merge pull request #1575 from marcosgdf/doc

Improving documentation of Societe class