Clarify the requirements file format documentation - Thanks @thanatos

Fixes #2003