update requirements and document -f option