Clarify the requirements file format documentation - Thanks @thanatos
Merge pull request #2027 from dstufft/correctly-document-requirements

Clarify the requirements file format documentation - Thanks @thanatos