docs++
lengths are int, not uint.  It just makes things easier.
draft of aliases and copies