manpage updates

docs/man/man1/ansible-playbook.1

 '\" t
 .\"     Title: ansible-playbook
 .\"    Author: [see the "AUTHOR" section]
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 04/03/2012
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 04/13/2012
 .\"    Manual: System administration commands
 .\"    Source: Ansible 0.0.2
 .\"  Language: English
 .\"
-.TH "ANSIBLE\-PLAYBOOK" "1" "04/03/2012" "Ansible 0\&.0\&.2" "System administration commands"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
+.TH "ANSIBLE\-PLAYBOOK" "1" "04/13/2012" "Ansible 0\&.0\&.2" "System administration commands"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -42,6 +33,10 @@ ansible\-playbook <filename\&.yml> \&... [options]
 The names of one or more YAML format files to run as ansible playbooks\&.
 .RE
 .SH "OPTIONS"
+.sp
+\fB\-D\fR, \fB\-\-debug\fR
+.sp
+Print any messages the remote module sends to standard error to the console
 .PP
 \fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR
 .RS 4
@@ -71,11 +66,28 @@ is specified as an integer, the default is 5\&.
 Prompt for the SSH password instead of assuming key\-based authentication with ssh\-agent\&.
 .RE
 .PP
+\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR
+.RS 4
+Prompt for the password to use for playbook plays that request sudo access, if any
+.RE
+.PP
 \fB\-T\fR \fISECONDS\fR, \fB\-\-timeout=\fR\fISECONDS\fR
 .RS 4
 Connection timeout to use when trying to talk to hosts, in
 \fISECONDS\fR\&.
 .RE
+.PP
+\fB\-e\fR \fIEXTRA_VARS\fR, \fB\-\-extra_vars=\fR\fIEXTRA_VARS\fR
+.RS 4
+An additional list of space delimited key=value pairs to pass into the playbook that are not declared in the vars section of the playbook\&.
+.RE
+.PP
+\fB\-O\fR \fIOVERRIDE_HOSTS\fR, \fB\-\-override\-hosts=\fR\fIOVERRIDE_HOSTS\fR
+.RS 4
+Ignore the inventory file and run the playbook against only these hosts\&. "hosts:" line in playbook should be set to
+\fIall\fR
+when using this option\&.
+.RE
 .SH "ENVIRONMENT"
 .sp
 The following environment variables may specified\&.

docs/man/man1/ansible.1

 '\" t
 .\"     Title: ansible
 .\"    Author: [see the "AUTHOR" section]
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 04/10/2012
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 04/13/2012
 .\"    Manual: System administration commands
 .\"    Source: Ansible 0.0.2
 .\"  Language: English
 .\"
-.TH "ANSIBLE" "1" "04/10/2012" "Ansible 0\&.0\&.2" "System administration commands"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
+.TH "ANSIBLE" "1" "04/13/2012" "Ansible 0\&.0\&.2" "System administration commands"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -34,7 +25,7 @@ ansible \- run a command somewhere else
 ansible <host\-pattern> [\-f forks] [\-m module_name] [\-a args]
 .SH "DESCRIPTION"
 .sp
-\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&.
+\fBAnsible\fR is an extra\-simple tool/framework/API for doing \'remote things\' over SSH\&.
 .SH "ARGUMENTS"
 .PP
 \fBhost\-pattern\fR
@@ -72,64 +63,56 @@ to load modules from\&. The default is
 \fI/usr/share/ansible\fR\&.
 .RE
 .PP
-\fB\-a\fR \*(Aq\fIARGUMENTS\fR\*(Aq, \fB\-\-args=\fR\*(Aq\fIARGUMENTS\fR\*(Aq
+\fB\-a\fR \'\fIARGUMENTS\fR\', \fB\-\-args=\fR\'\fIARGUMENTS\fR\'
 .RS 4
 The
 \fIARGUMENTS\fR
 to pass to the module\&.
 .RE
-.PP
+.sp
+\fB\-D\fR, \fB\-\-debug\fR
+.sp
+Print any messages the remote module sends to standard error to the console
+.sp
 \fB\-k\fR, \fB\-\-ask\-pass\fR
-.RS 4
+.sp
 Prompt for the SSH password instead of assuming key\-based authentication with ssh\-agent\&.
-.RE
-.PP
+.sp
+\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR
+.sp
+Prompt for the password to use with \-\-sudo, if any
+.sp
 \fB\-o\fR, \fB\-\-one\-line\fR
-.RS 4
+.sp
 Try to output everything on one line\&.
-.RE
-.PP
+.sp
+\fB\-s\fR, \fB\-\-sudo\fR
+.sp
+Run the command as the user given by \-u and sudo to root\&.
+.sp
 \fB\-t\fR \fIDIRECTORY\fR, \fB\-\-tree=\fR\fIDIRECTORY\fR
-.RS 4
-Save contents in this output
-\fIDIRECTORY\fR, with the results saved in a file named after each host\&.
-.RE
-.PP
+.sp
+Save contents in this output \fIDIRECTORY\fR, with the results saved in a file named after each host\&.
+.sp
 \fB\-T\fR \fISECONDS\fR, \fB\-\-timeout=\fR\fISECONDS\fR
-.RS 4
-Connection timeout to use when trying to talk to hosts, in
-\fISECONDS\fR\&.
-.RE
-.PP
+.sp
+Connection timeout to use when trying to talk to hosts, in \fISECONDS\fR\&.
+.sp
 \fB\-B\fR \fINUM\fR, \fB\-\-background=\fR\fINUM\fR
-.RS 4
-Run commands in the background, killing the task after
-\fINUM\fR
-seconds\&.
-.RE
-.PP
+.sp
+Run commands in the background, killing the task after \fINUM\fR seconds\&.
+.sp
 \fB\-P\fR \fINUM\fR, \fB\-\-poll=\fR\fINUM\fR
-.RS 4
-Poll a background job every
-\fINUM\fR
-seconds\&. Requires
-\fB\-B\fR\&.
-.RE
-.PP
+.sp
+Poll a background job every \fINUM\fR seconds\&. Requires \fB\-B\fR\&.
+.sp
 \fB\-u\fR \fIUSERNAME\fR, \fB\-\-remote\-user=\fR\fIUSERNAME\fR
-.RS 4
-Use this remote
-\fIUSERNAME\fR
-instead of root\&.
-.RE
-.PP
+.sp
+Use this remote \fIUSERNAME\fR instead of root\&.
+.sp
 \fB\-c\fR \fICONNECTION\fR, \fB\-\-connection=\fR\fICONNECTION\fR
-.RS 4
-Connection type to use\&. Possible options are
-\fIparamiko\fR
-and
-\fIlocal\fR\&.
-.RE
+.sp
+Connection type to use\&. Possible options are \fIparamiko\fR (SSH) and \fIlocal\fR\&. Local is mostly useful for crontab or kickstarts\&.
 .SH "INVENTORY"
 .sp
 Ansible stores the hosts it can potentially operate on in an inventory file\&. The syntax is one host per line\&. Groups headers are allowed and are included on their own line, enclosed in square brackets\&.

docs/man/man1/ansible.1.asciidoc

@@ -64,47 +64,44 @@ The 'ARGUMENTS' to pass to the module.
 
 Print any messages the remote module sends to standard error to the console
 
-*-k*, *--ask-pass*::
+*-k*, *--ask-pass*
 
 Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.
 
-*-K*, *--ask-sudo-pass*::
+*-K*, *--ask-sudo-pass*
 
 Prompt for the password to use with --sudo, if any
 
-*-o*, *--one-line*::
+*-o*, *--one-line*
 
 Try to output everything on one line.
 
-*-s*, *--sudo*::
+*-s*, *--sudo*
 
 Run the command as the user given by -u and sudo to root.
 
-*-t* 'DIRECTORY', *--tree=*'DIRECTORY'::
+*-t* 'DIRECTORY', *--tree=*'DIRECTORY'
 
 Save contents in this output 'DIRECTORY', with the results saved in a
 file named after each host.
 
-
-*-T* 'SECONDS', *--timeout=*'SECONDS'::
+*-T* 'SECONDS', *--timeout=*'SECONDS'
 
 Connection timeout to use when trying to talk to hosts, in 'SECONDS'.
 
-
-*-B* 'NUM', *--background=*'NUM'::
+*-B* 'NUM', *--background=*'NUM'
 
 Run commands in the background, killing the task after 'NUM' seconds.
 
-
-*-P* 'NUM', *--poll=*'NUM'::
+*-P* 'NUM', *--poll=*'NUM'
 
 Poll a background job every 'NUM' seconds. Requires *-B*.
 
-*-u* 'USERNAME', *--remote-user=*'USERNAME'::
+*-u* 'USERNAME', *--remote-user=*'USERNAME'
 
 Use this remote 'USERNAME' instead of root.
 
-*-c* 'CONNECTION', *--connection=*'CONNECTION'::
+*-c* 'CONNECTION', *--connection=*'CONNECTION'
 
 Connection type to use.  Possible options are 'paramiko' (SSH) and 'local'.
 Local is mostly useful for crontab or kickstarts.