closes #63 by avoiding use of temporaries where possible
closes #56
minor doco
closes #65; closes #64