bunch of code documentation for RDoc
more code documntation improvements; renamed 'scale' methods to 'mul' to avoid ambiguity, but kept old nmes around (undoc'd) for backwards compatibility
add progress messages to shlerb