David Green writes: > Well, clutter like "Blah: none" seems to me to be more the fault of > the doc-formatter for not hiding lines like that.
It's more the repetition in the lines you snipped that I really object to: given the function's name, the name(s) of its parameter(s), and the short description of what it does, it's obvious what the parameter(s) are for and what it returns; repeating that information doesn't help anybody. (It may help computers, though.) Smylers