Fix the documentation booleans so they use "yes" and "no"

Both modules seboolean and zfs have not been adapted since they defer from the default (either by having a 'null' or special state, or prefering "on"/"off" for state indication.
reviewable/pr18780/r1
Dag Wieers 12 years ago
parent 84527b1d31
commit d4bb57d42d

@ -32,7 +32,8 @@ options:
description: description:
- If a stacks fails to form, rollback will remove the stack - If a stacks fails to form, rollback will remove the stack
required: false required: false
default: false default: "no"
choices: [ "yes", "no" ]
aliases: [] aliases: []
template_parameters: template_parameters:
description: description:
@ -63,7 +64,8 @@ options:
description: description:
- Wait while the stack is being created/updated/deleted. - Wait while the stack is being created/updated/deleted.
required: false required: false
default: true default: "yes"
choices: [ "yes", "no" ]
aliases: [] aliases: []
examples: examples:
@ -72,7 +74,7 @@ examples:
- name: launch ansible cloudformation example - name: launch ansible cloudformation example
cloudformation: > cloudformation: >
stack_name="ansible-cloudformation" state=present stack_name="ansible-cloudformation" state=present
region=us-east-1 disable_rollback=true region=us-east-1 disable_rollback=yes
template=files/cloudformation-example.json template=files/cloudformation-example.json
args: args:
template_parameters: template_parameters:

@ -111,7 +111,8 @@ options:
- If the job should be run at reboot, will ignore minute, hour, day, and month settings in favour of C(@reboot) - If the job should be run at reboot, will ignore minute, hour, day, and month settings in favour of C(@reboot)
version_added: "1.0" version_added: "1.0"
required: false required: false
default: False default: "no"
choices: [ "yes", "no" ]
aliases: [] aliases: []
examples: examples:
@ -119,7 +120,7 @@ examples:
description: Ensure a job that runs at 2 and 5 exists. Creates an entry like "* 5,2 * * ls -alh > /dev/null" description: Ensure a job that runs at 2 and 5 exists. Creates an entry like "* 5,2 * * ls -alh > /dev/null"
- code: 'cron: name="an old job" cron job="/some/dir/job.sh" state=absent' - code: 'cron: name="an old job" cron job="/some/dir/job.sh" state=absent'
description: 'Ensure an old job is no longer present. Removes any job that is preceded by "#Ansible: an old job" in the crontab' description: 'Ensure an old job is no longer present. Removes any job that is preceded by "#Ansible: an old job" in the crontab'
- code: 'cron: name="a job for reboot" reboot=True job="/some/job.sh"' - code: 'cron: name="a job for reboot" reboot=yes job="/some/job.sh"'
description: 'Creates an entry like "@reboot /some/job.sh"' description: 'Creates an entry like "@reboot /some/job.sh"'
- code: 'cron: name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate' - code: 'cron: name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate'

@ -42,6 +42,7 @@ options:
- A boolean that indicates whether the debug module should fail or not. - A boolean that indicates whether the debug module should fail or not.
required: false required: false
default: "no" default: "no"
choices: [ "yes", "no" ]
examples: examples:
- code: | - code: |
- action: debug msg="System $inventory_hostname has uuid $ansible_product_uuid" - action: debug msg="System $inventory_hostname has uuid $ansible_product_uuid"

@ -64,6 +64,8 @@ options:
description: description:
- Fail the command immediately if a test fails. Used by the 'test' command. - Fail the command immediately if a test fails. Used by the 'test' command.
required: false required: false
default: "no"
choices: [ "yes", "no" ]
fixtures: fixtures:
description: description:
- A space-delimited list of fixture file names to load in the database. B(Required) by the 'loaddata' command. - A space-delimited list of fixture file names to load in the database. B(Required) by the 'loaddata' command.

@ -48,7 +48,8 @@ options:
have any effect, the environment must be deleted and newly have any effect, the environment must be deleted and newly
created. created.
required: false required: false
default: no default: "no"
choices: [ "yes", "no" ]
virtualenv_command: virtualenv_command:
version_added: 1.1 version_added: 1.1
description: description:

5
ec2

@ -69,7 +69,8 @@ options:
description: description:
- wait for the instance to be in state 'running' before returning - wait for the instance to be in state 'running' before returning
required: false required: false
default: false default: "no"
choices: [ "yes", "no" ]
aliases: [] aliases: []
wait_timeout: wait_timeout:
description: description:
@ -129,7 +130,7 @@ options:
default: null default: null
aliases: [] aliases: []
examples: examples:
- code: 'local_action: ec2 keypair=admin instance_type=m1.large image=emi-40603AD1 wait=true group=webserver count=3 group=webservers' - code: 'local_action: ec2 keypair=admin instance_type=m1.large image=emi-40603AD1 wait=yes group=webserver count=3 group=webservers'
description: "Examples from Ansible Playbooks" description: "Examples from Ansible Playbooks"
requirements: [ "boto" ] requirements: [ "boto" ]
author: Seth Vidal, Tim Gerla, Lester Wade author: Seth Vidal, Tim Gerla, Lester Wade

@ -51,7 +51,7 @@ examples:
description: "Simple playbook example" description: "Simple playbook example"
- code: | - code: |
- name: Launch instances - name: Launch instances
local_action: ec2 keypair=$keypair image=$image wait=true count=3 local_action: ec2 keypair=$keypair image=$image wait=yes count=3
register: ec2 register: ec2
- name: Create volumes and attach - name: Create volumes and attach
local_action: ec2_vol instance=${item.id} volume_size=5 local_action: ec2_vol instance=${item.id} volume_size=5

@ -115,7 +115,7 @@ options:
in the policy. Does nothing if no default value is available. in the policy. Does nothing if no default value is available.
recurse: recurse:
required: false required: false
default: no default: "no"
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
version_added: "1.1" version_added: "1.1"
description: description:

4
gem

@ -41,8 +41,8 @@ options:
include_dependencies: include_dependencies:
description: Wheter to include dependencies or not. description: Wheter to include dependencies or not.
required: false required: false
choices: [true, false] choices: [ "yes", "no" ]
default: true default: "yes"
repository: repository:
description: The repository from which the gem will be installed description: The repository from which the gem will be installed
required: false required: false

2
git

@ -50,7 +50,7 @@ options:
force: force:
required: false required: false
default: "yes" default: "yes"
choices: [ yes, no ] choices: [ "yes", "no" ]
version_added: "0.7" version_added: "0.7"
description: description:
- If C(yes), any modified files in the working - If C(yes), any modified files in the working

@ -45,7 +45,7 @@ options:
system: system:
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
description: description:
- If I(yes), indicates that the group created is a system group. - If I(yes), indicates that the group created is a system group.
examples: examples:

4
hg

@ -57,7 +57,7 @@ options:
- Discards uncommited changes. Runs C(hg update -C). - Discards uncommited changes. Runs C(hg update -C).
required: false required: false
default: "yes" default: "yes"
choices: [ yes, no ] choices: [ "yes", "no" ]
purge: purge:
description: description:
- Delets untracked files. Runs C(hg purge). Note this requires C(purge) extension to - Delets untracked files. Runs C(hg purge). Note this requires C(purge) extension to
@ -65,7 +65,7 @@ options:
and undo the changes before exiting the task. and undo the changes before exiting the task.
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
notes: notes:
- If the task seems to be hanging, first verify remote host is in C(known_hosts). - If the task seems to be hanging, first verify remote host is in C(known_hosts).
SSH will prompt user to authorize the first contact with a remote host. One solution is to add SSH will prompt user to authorize the first contact with a remote host. One solution is to add

@ -56,7 +56,7 @@ options:
- Create a backup file including the timestamp information so you can get - Create a backup file including the timestamp information so you can get
the original file back if you somehow clobbered it incorrectly. the original file back if you somehow clobbered it incorrectly.
required: false required: false
default: no default: "no"
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
others: others:
description: description:

@ -75,15 +75,16 @@ options:
choices: [ 'BOF', '*regex*' ] choices: [ 'BOF', '*regex*' ]
create: create:
required: false required: false
choices: [ yes, no ] choices: [ "yes", "no" ]
default: no default: "no"
description: description:
- Used with C(state=present). If specified, the file will be created - Used with C(state=present). If specified, the file will be created
if it does not already exist. By default it will fail if the file if it does not already exist. By default it will fail if the file
is missing. is missing.
backup: backup:
required: false required: false
default: no default: "no"
choices: [ "yes", "no" ]
description: description:
- Create a backup file including the timestamp information so you can - Create a backup file including the timestamp information so you can
get the original file back if you somehow clobbered it incorrectly. get the original file back if you somehow clobbered it incorrectly.

@ -41,6 +41,8 @@ options:
description: description:
- update the package db first - update the package db first
required: false required: false
default: "no"
choices: [ "yes", "no" ]
notes: [] notes: []
''' '''
EXAMPLES = ''' EXAMPLES = '''

@ -40,6 +40,8 @@ options:
description: description:
- update the package db first - update the package db first
required: false required: false
default: "no"
choices: [ "yes", "no" ]
notes: [] notes: []
''' '''
EXAMPLES = ''' EXAMPLES = '''

@ -42,6 +42,8 @@ options:
description: description:
- update the package db first (pacman -Syy) - update the package db first (pacman -Syy)
required: false required: false
default: "no"
choices: [ "yes", "no" ]
author: Afterburn author: Afterburn
notes: [] notes: []

5
pip

@ -56,7 +56,8 @@ options:
have any effect, the environment must be deleted and newly have any effect, the environment must be deleted and newly
created. created.
required: false required: false
default: no default: "no"
choices: [ "yes", "no" ]
virtualenv_command: virtualenv_command:
version_aded: 1.1 version_aded: 1.1
description: description:
@ -70,7 +71,7 @@ options:
an older version of pip (< 1.0), you should set this to no because an older version of pip (< 1.0), you should set this to no because
older versions of pip do not support I(--use-mirrors). older versions of pip do not support I(--use-mirrors).
required: false required: false
default: yes default: "yes"
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
version_added: "1.0" version_added: "1.0"
state: state:

@ -38,8 +38,8 @@ options:
- Only enable missing plugins - Only enable missing plugins
- Does not disable plugins that are not in the names list - Does not disable plugins that are not in the names list
required: false required: false
default: no default: "no"
choices: [yes, no] choices: [ "yes", "no" ]
state: state:
description: description:
- Specify if pluginss are to be enabled or disabled - Specify if pluginss are to be enabled or disabled

@ -73,8 +73,8 @@ options:
description: description:
- Deletes and recreates the user. - Deletes and recreates the user.
required: false required: false
default: no default: "no"
choices: [yes, no] choices: [ "yes", "no" ]
state: state:
description: description:
- Specify if user is to be added or removed - Specify if user is to be added or removed

@ -37,8 +37,8 @@ options:
tracing: tracing:
description: description:
Enable/disable tracing for a vhost Enable/disable tracing for a vhost
default: no default: "no"
choices: [yes, no] choices: [ "yes", "no" ]
aliases: [trace] aliases: [trace]
state: state:
description: description:

@ -41,7 +41,7 @@ options:
- Desired boolean value - Desired boolean value
required: true required: true
default: null default: null
choices: [ "true", "false" ] choices: [ true, false ]
examples: examples:
- code: "seboolean: name=httpd_can_network_connect state=true persistent=yes" - code: "seboolean: name=httpd_can_network_connect state=true persistent=yes"
description: Set I(httpd_can_network_connect) SELinux flag to I(true) and I(persistent) description: Set I(httpd_can_network_connect) SELinux flag to I(true) and I(persistent)

@ -49,7 +49,7 @@ options:
description: description:
- If C(yes), modified files will be discarded. If C(no), module will fail if it encounters modified files. - If C(yes), modified files will be discarded. If C(no), module will fail if it encounters modified files.
required: false required: false
default: yes default: "yes"
choices: [ "yes", "no" ] choices: [ "yes", "no" ]
username: username:
description: description:

@ -56,8 +56,8 @@ options:
description: description:
- if C(reload=yes), performs a I(/sbin/sysctl -p) if the C(sysctl_file) is updated - if C(reload=yes), performs a I(/sbin/sysctl -p) if the C(sysctl_file) is updated
- if C(reload=no), does not reload I(sysctl) even if the C(sysctl_file) is updated - if C(reload=no), does not reload I(sysctl) even if the C(sysctl_file) is updated
choices: [ yes, no ] choices: [ "yes", "no" ]
default: yes default: "yes"
sysctl_file: sysctl_file:
description: description:
- specifies the absolute path to C(sysctl.conf), if not /etc/sysctl.conf - specifies the absolute path to C(sysctl.conf), if not /etc/sysctl.conf

10
user

@ -80,35 +80,35 @@ options:
createhome: createhome:
required: false required: false
default: "yes" default: "yes"
choices: [ yes, no ] choices: [ "yes", "no" ]
description: description:
- Unless set to C(no), a home directory will be made for the user - Unless set to C(no), a home directory will be made for the user
when the account is created. when the account is created.
system: system:
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
description: description:
- When creating an account, setting this to C(yes) makes the user a - When creating an account, setting this to C(yes) makes the user a
system account. This setting cannot be changed on existing users. system account. This setting cannot be changed on existing users.
force: force:
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
description: description:
- When used with C(state=absent), behavior is as with - When used with C(state=absent), behavior is as with
C(userdel --force). C(userdel --force).
remove: remove:
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
description: description:
- When used with C(state=absent), behavior is as with - When used with C(state=absent), behavior is as with
C(userdel --remove). C(userdel --remove).
generate_ssh_key: generate_ssh_key:
required: false required: false
default: "no" default: "no"
choices: [ yes, no ] choices: [ "yes", "no" ]
version_added: "0.9" version_added: "0.9"
description: description:
- Whether to generate a SSH key for the user in question. - Whether to generate a SSH key for the user in question.

Loading…
Cancel
Save