Documentation update

[Rod Widdowson]

> No, the transient defiitions are purely deprecated compatibility and even
there
> it's questionable because they're completely duplicated by the new stuff.

Of course.  Thanks.

> You're
> thinking of Persistents, and the SAML 1 case of sticking them into an
Attribute
> with the old NameID attribute encoder thing.

Right.  It has finally sunk it.
 
> So I'd probably say, point to V2 and note they're unneeded now.

Will do.  I am developing a standard for that as both the encoders and the
resolvers have several deprecated functions.

Thanks
/R