contains: add documentation regarding the use of `--`

Closes #1194.

[skip ci]