Python Forum

the man page for pip describes a command option --download-cache <dir> as "Cache downloaded packages in <dir>.".  but this option is rejected with an error message:

Output:
lt1/forums /home/forums 3> pip install --download-cache /var/lib/pip-cache cog

Usage:   
  pip install [options] <requirement specifier> [package-index-options] ...
  pip install [options] -r <requirements file> [package-index-options] ...
  pip install [options] [-e] <vcs project url> ...
  pip install [options] [-e] <local project path> ...
  pip install [options] <archive url/path> ...

no such option: --download-cache
lt1/forums /home/forums 4> 

anyone know was is going on?  is the man page just a pipe-dream?

As of pip 8 --download-cache was dropped, pip should be using cache by default that can be turned off with --no-cache-dir.

λ pip -V
pip 9.0.1 ...

λ pip --help | grep cache
  --cache-dir <dir>           Store the cache data in <dir>.
  --no-cache-dir              Disable the cache.

Doc