Fixed discrepancies between doc and code

Was reading some doc, found some strange stuff, they are fixed now. Just hope it is indeed still in the spirit of the original doc, but it was saying something and doing something else.