[inlinedocs] tabs before comments and symbols, S3 methods

[Toby Dylan Hocking]

Great, thanks for the contributions.

Yes, I have given some thought to adding examples inline in the code,
but I don't like it, because when the example code is commented, it is
harder to edit and test. Of course I am willing to listen to a
compelling argument if you have one, but at this time, I wouldn't like
to encourage the ##examples<< syntax.

Instead, I prefer to add a corresponding file in the tests
subdirectory, and take the examples from this.