summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCharles Ferguson <gerph@gerph.org>2015-11-26 15:40:09 +0000
committerCharles Ferguson <gerph@gerph.org>2015-11-26 15:40:09 +0000
commit9325c0ae5fde9bb035e7f03017b8ce8bcdd635a5 (patch)
tree34a78feae9d89a465461ca22ed6ee2ded5d874ec
parent8ae30f1822cb73ac54eb9e19d922d605a78ed098 (diff)
downloadansible-modules-core-9325c0ae5fde9bb035e7f03017b8ce8bcdd635a5.tar.gz
Update documentation for 'file' module to include 'diff_peek'.
The 'diff_peek' option isn't documented at all, and provides a rudimentary check that the content isn't binary. Documentation is added to explain the option. The 'validate' option has a declaration, but isn't implemented. Therefore it may as well be removed from the module.
-rw-r--r--files/file.py7
1 files changed, 6 insertions, 1 deletions
diff --git a/files/file.py b/files/file.py
index 8219990d..9e79d4ac 100644
--- a/files/file.py
+++ b/files/file.py
@@ -87,6 +87,12 @@ options:
- 'force the creation of the symlinks in two cases: the source file does
not exist (but will appear later); the destination exists and is a file (so, we need to unlink the
"path" file and create symlink to the "src" file in place of it).'
+ diff_peek:
+ required: false
+ description:
+ - "Only check whether the file looks like binary. Returns with the parameter
+ 'appears_binary' set to True or False depending on the initial content of the
+ file. This option is enabled when the option is set (to any value)."
'''
EXAMPLES = '''
@@ -158,7 +164,6 @@ def main():
recurse = dict(default=False, type='bool'),
force = dict(required=False, default=False, type='bool'),
diff_peek = dict(default=None),
- validate = dict(required=False, default=None),
src = dict(required=False, default=None),
),
add_file_common_args=True,