stable bar, updated docs. Only 3/4 routines left unimplemented.
halfway thru barswap