doc python_req things

give python_requirements_library a docstring

tag python_requirements with @manual so it shows up in BUILD dictionary

add example to python_requirements with a "this gives you something like..."

Bugs closed: 292

Reviewed at https://rbcommons.com/s/twitter/r/629/