From 36382face9919ec8078c0edc7baf7f091466a087 Mon Sep 17 00:00:00 2001 From: Toshio Kuratomi Date: Fri, 24 Jul 2015 14:51:31 -0700 Subject: [PATCH] Add a warning about mode being octal --- lib/ansible/utils/module_docs_fragments/files.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/ansible/utils/module_docs_fragments/files.py b/lib/ansible/utils/module_docs_fragments/files.py index 5087c0cf508..9bc96c6e257 100644 --- a/lib/ansible/utils/module_docs_fragments/files.py +++ b/lib/ansible/utils/module_docs_fragments/files.py @@ -25,7 +25,7 @@ options: required: false default: null description: - - mode the file or directory should be, such as 0644 as would be fed to I(chmod). As of version 1.8, the mode may be specified as a symbolic mode (for example, C(u+rwx) or C(u=rw,g=r,o=r)). + - mode the file or directory should be. For those used to I(/usr/bin/chmod) remember that modes are actually octal numbers (like 0644). Leaving off the leading zero will likely have unexpected results. As of version 1.8, the mode may be specified as a symbolic mode (for example, C(u+rwx) or C(u=rw,g=r,o=r)). owner: required: false default: null