docs: Add better description for simplesaml.nameidattribute.

(Also fixes a couple of formatting errors.)

Thanks to Thijs Kinkhorst for providing this patch.

git-svn-id: https://simplesamlphp.googlecode.com/svn/trunk@3036 44740490-163a-0410-bde0-09ae8108e29a