more code documntation improvements; renamed 'scale' methods to 'mul' to avoid ambiguity, but kept old nmes around (undoc'd) for backwards compatibility