Syntax documentation: method return values and expanded documentation of singletons

I think I've made some improvements in the documentation about how to declare methods.  Please let me know what you think.