motion require and updated docs
patch from j-mcnally: motion require and updated docs