Clarify docs re mode's octal representation (#44410)

* Clarify docs re mode's octal representation

I changed the language about how to use mode to make it more obvious
that using "01777" is not a typo, because the leading zero is not meant
to reflect the way that number might have been given on a command line.
See also: issues #5409 #9196 #11385 #13115 #18952 #23491 #23521
This commit is contained in:
Todd Walton 2018-08-29 16:12:32 -04:00 committed by Alicia Cozine
commit 1247f4a464
4 changed files with 10 additions and 9 deletions

View file

@ -103,11 +103,12 @@ options:
'''
EXAMPLES = '''
# change file ownership, group and mode. When specifying mode using octal numbers, first digit should always be 0.
# change file ownership, group and mode
- file:
path: /etc/foo.conf
owner: foo
group: foo
# when specifying mode using octal numbers, add a leading 0
mode: 0644
- file:
path: /work