fixes to add! and sub!
arity overloads for scala and scale!
docstring clarification
doc tidying