add documentation for omit();