doc/syntax/methods.rdoc: Expanded and clarified methods

Added some talk of return values and the use of the "return" keyword.

Significantly expanded on the section about singleton methods.

Added a new section about overriding.