Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Why are useful command line options in pip undocumented and explicitly hidden? #2429
I vaguely remembered that this was the same as adding a
However, I was unable to find any documentation for this anywhere except in the source code, where help for the feature is explicitly suppressed (using
I look through the history of the file, but did not find any mention of why the feature was hidden in the commit messages.
Is this an experimental feature which should not be relied upon? Should I not use (nor encourage others to use) these features or is there a different way of using these features? Could someone please shine some light on this conundrum?
This is a question which I had previously posted on StackOverflow hoping that there was an explanation along the lines that these options were only to be used if
However, that doesn't seem to be case, or at least it isn't common knowledge.
+1, it's hard to defend hiding recognized command-line flags, but useful ones it's just stupid.
Relevant code: cmdoptions.py
I fully agree that these extremely useful options should be documented. They were documented previously at the following, now-defunct location: http://www.pip-installer.org/en/latest/other-tools.html#using-pip-with-virtualenv