new function 'move' + update doc and tests