API doc generator -- allow description of return values

[skinner]

I've been reading the Code Documentation wiki page:

​http://dojo.jot.com/Code%20Documentation

If I understand correctly, it's possible to associate a short description with each parameter, like this:

dojo.foo.go = function(/* int */ direction) {
   // Summary: Goes forward or back.
   // direction: int Use 1 for forward or -1 for backward
}

It would be great to also add short descriptions about return values too, beyond just the type of the value, like this:

dojo.foo.getHeight = function() {
   return height; // float Always a value between 0 and maxHeight
}

[Neil Roberts]

This already works with the returns keyword in the initial comment block.