* Allow for requirements files to differ per platform

As a common example, we need a compiled requirements file for linux that differs from mac os

* Add pip_repository documentation

The macros are leaky and otherwise you have to read sources to find out about the kwargs

Fixes #384