2012-11-28 09:39:26 +01:00
'\" t
. \" Title: ansible-doc
2013-02-02 03:38:21 +01:00
. \" Author: [see the "AUTHOR" section]
. \" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
. \" Date: 02/01/2013
2012-11-28 09:39:26 +01:00
. \" Manual: System administration commands
2013-02-02 03:38:21 +01:00
. \" Source: Ansible 1.1
2012-11-28 09:39:26 +01:00
. \" Language: English
. \"
2013-02-02 03:38:21 +01:00
.TH "ANSIBLE\-DOC" "1" "02/01/2013" "Ansible 1\&.1" "System administration commands"
2012-11-28 09:39:26 +01:00
. \" -----------------------------------------------------------------
. \" * set default formatting
. \" -----------------------------------------------------------------
. \" disable hyphenation
.nh
. \" disable justification (adjust text to left margin only)
.ad l
. \" -----------------------------------------------------------------
. \" * MAIN CONTENT STARTS HERE *
. \" -----------------------------------------------------------------
.SH "NAME"
ansible-doc \- show documentation on Ansible modules
.SH "SYNOPSIS"
.sp
ansible\- doc [\- M module_path] [\- l] [\- s] [module\& ...]
.SH "DESCRIPTION"
.sp
\fB ansible\- doc\fR displays information on modules installed in Ansible libraries\& . It displays a terse listing of modules and their short descriptions, provides a printout of their DOCUMENTATION strings, and it can create a short "snippet" which can be pasted into a playbook\& .
.SH "OPTIONS"
.PP
\fB \- M\fR \fI directory\fR , \fB \- \- module\- path=\fR \fI directory\fR
.RS 4
Add an additional directory to the default path for finding module libraries\& .
.RE
.PP
\fB \- s\fR , \fB \- \- snippet=\fR
.RS 4
Produce a snippet which can be copied into a playbook for modification, like a kind of task template\& .
.RE
.PP
\fB \- l\fR , \fB \- \- list=\fR
.RS 4
Produce a terse listing of modules and a short description of each\& .
.RE
.SH "AUTHOR"
.sp
ansible\- doc was originally written by Jan\- Piet Mens\& . See the AUTHORS file for a complete list of contributors\& .
.SH "COPYRIGHT"
.sp
Copyright \(co 2012, Jan\- Piet Mens
.sp
Ansible is released under the terms of the GPLv3 License\& .
.SH "SEE ALSO"
.sp
\fB ansible\- playbook\fR (1), \fB ansible\fR (1)
.sp
Extensive documentation as well as IRC and mailing list info is available on the ansible home page: https://ansible\& .github\& .com/