fix documentation for shift
test substition and shifting