Improve pip umask docs (#49146, #49325) (#49326)

* For the pip module, umask should be specified as an octal *string*, not an octal (or decimal) *integer*.
(cherry picked from commit 0521e1c6dc)
(cherry picked from commit 237f127d21)

* Do not document buggy behavior.
(cherry picked from commit 1b77d72370)
This commit is contained in:
Bob Vincent 2018-11-30 16:38:36 -05:00 committed by Alicia Cozine
parent 9e8084380a
commit 9a5a4fa59a

View file

@ -98,9 +98,9 @@ options:
description:
- The system umask to apply before installing the pip package. This is
useful, for example, when installing on systems that have a very
restrictive umask by default (e.g., 0077) and you want to pip install
restrictive umask by default (e.g., "0077") and you want to pip install
packages which are to be used by all users. Note that this requires you
to specify desired umask mode in octal, with a leading 0 (e.g., 0077).
to specify desired umask mode as an octal string, (e.g., "0022").
version_added: "2.1"
notes:
- Please note that virtualenv (U(http://www.virtualenv.org/)) must be