diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000000..d1a7b1604b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+*~
+*.py[co]
+build
diff --git a/AUTHORS.md b/AUTHORS.md
index eb5b5f301f..c920bd4782 100644
--- a/AUTHORS.md
+++ b/AUTHORS.md
@@ -4,7 +4,7 @@ Patches and Contributions
* Michael DeHaan - michael.dehaan AT gmail DOT com
* Jeremy Katz - katzj AT fedoraproject DOT org
* Seth Vidal - skvidal AT fedoraproject DOT org
- * Tim Bielawa - tbielawa AT gmail DOT com
+ * Tim Bielawa - tbielawa AT redhat DOT com
Send in a github pull request to get your name here.
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000000..dca3a50308
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,32 @@
+#!/usr/bin/make
+
+ASCII2MAN = a2x -D $(dir $@) -d manpage -f manpage $<
+ASCII2HTMLMAN = a2x -D docs/html/man/ -d manpage -f xhtml
+MANPAGES := docs/man/man1/ansible.1
+SITELIB = $(shell python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()")
+
+docs: manuals
+
+manuals: $(MANPAGES)
+
+%.1: %.1.asciidoc
+ $(ASCII2MAN)
+
+%.5: %.5.asciidoc
+ $(ASCII2MAN)
+
+pep8:
+ @echo "#############################################"
+ @echo "# Running PEP8 Compliance Tests"
+ @echo "#############################################"
+ pep8 lib/
+
+clean:
+ find . -type f -name "*.pyc" -delete
+ find . -type f -name "*.pyo" -delete
+ find . -type f -name "*~" -delete
+ find ./docs/ -type f -name "*.xml" -delete
+ find . -type f -name "#*" -delete
+
+.PHONEY: docs manual clean pep8
+vpath %.asciidoc docs/man/man1
diff --git a/docs/man/.gitignore b/docs/man/.gitignore
new file mode 100644
index 0000000000..b81c7954b7
--- /dev/null
+++ b/docs/man/.gitignore
@@ -0,0 +1 @@
+*.xml
\ No newline at end of file
diff --git a/docs/man/man1/ansible.1 b/docs/man/man1/ansible.1
new file mode 100644
index 0000000000..7ff7233b0e
--- /dev/null
+++ b/docs/man/man1/ansible.1
@@ -0,0 +1,108 @@
+'\" t
+.\" Title: ansible
+.\" Author: [see the "AUTHOR" section]
+.\" Generator: DocBook XSL Stylesheets v1.76.1
+.\" Date: 02/24/2012
+.\" Manual: System administration commands
+.\" Source: Ansible 0.0.1
+.\" Language: English
+.\"
+.TH "ANSIBLE" "1" "02/24/2012" "Ansible 0\&.0\&.1" "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 '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+ansible \- run a command somewhere else
+.SH "SYNOPSIS"
+.sp
+ansible [\-H hosts_path] [\-L library_path] [\-f forks] [\-n module_name] [\-a [args1 [args2 \&...]]] [\-p host_pattern] [\-u remote_user]
+.SH "DESCRIPTION"
+.sp
+\fBAnsible\fR is an extra\-simple Python API for doing \*(Aqremote things\*(Aq over SSH\&.
+.SH "OPTIONS"
+.PP
+\fB\-P\fR, \fB\-\-askpass\fR
+.RS 4
+Ask the user to input the ssh password for connecting\&.
+.RE
+.PP
+\fB\-H\fR, \fB\-\-host\-list\fR
+.RS 4
+Path to hosts list\&.
+.RE
+.PP
+\fB\-L\fR, \fB\-\-library\fR
+.RS 4
+Path to module library\&.
+.RE
+.PP
+\fB\-f\fR, \fB\-\-forks\fR
+.RS 4
+Level of parallelism\&. Specify as an integer\&.
+.RE
+.PP
+\fB\-n\fR, \fB\-\-name\fR
+.RS 4
+Module name to execute\&.
+.RE
+.PP
+\fB\-a\fR, \fB\-\-args\fR
+.RS 4
+Arguments to module\&.
+.RE
+.PP
+\fB\-p\fR, \fB\-\-pattern\fR
+.RS 4
+Hostname pattern\&. Accepts shell\-like globs\&.
+.RE
+.PP
+\fB\-r\fR, \fB\-\-run\-playbook\fR
+.RS 4
+Playbook file to run\&. Replaces the
+\fB\-n\fR
+and
+\fB\-a\fR
+options\&.
+.RE
+.PP
+\fB\-u\fR, \fB\-\-remote\-user\fR
+.RS 4
+Remote user to connect as\&. Uses
+\fIroot\fR
+by default\&.
+.RE
+.SH "INVENTORY"
+.sp
+Ansible stores the hosts it can potentially operate on in an inventory file\&. The syntax is simple: one host per line\&. Organize your hosts into multiple groups by separating them into multiple inventory files\&.
+.SH "FILES"
+.sp
+/etc/ansible/hosts \(em Default hosts file
+.sp
+/usr/share/ansible \(em Default module library
+.SH "AUTHOR"
+.sp
+Ansible was originally written by Michael DeHaan\&. See the AUTHORS file for a complete list of contributors\&.
+.SH "COPYRIGHT"
+.sp
+Copyright \(co 2012, Michael DeHaan
+.sp
+Ansible is released under the terms of the MIT license\&.
+.SH "SEE ALSO"
+.sp
+Ansible home page: https://github\&.com/mpdehaan/ansible/
diff --git a/docs/man/man1/ansible.1.asciidoc b/docs/man/man1/ansible.1.asciidoc
new file mode 100644
index 0000000000..ca5e1e9dff
--- /dev/null
+++ b/docs/man/man1/ansible.1.asciidoc
@@ -0,0 +1,109 @@
+ansible(1)
+=========
+:doctype:manpage
+:man source: Ansible
+:man version: 0.0.1
+:man manual: System administration commands
+
+NAME
+----
+ansible - run a command somewhere else
+
+
+SYNOPSIS
+--------
+ansible [-H hosts_path] [-L library_path] [-f forks] [-n module_name]
+ [-a [args1 [args2 ...]]] [-p host_pattern] [-u remote_user]
+
+
+DESCRIPTION
+-----------
+
+*Ansible* is an extra-simple Python API for doing \'remote things' over
+SSH.
+
+
+OPTIONS
+-------
+
+*-P*, *--askpass*::
+
+Ask the user to input the ssh password for connecting.
+
+
+*-H*, *--host-list*::
+
+Path to hosts list.
+
+
+*-L*, *--library*::
+
+Path to module library.
+
+
+*-f*, *--forks*::
+
+Level of parallelism. Specify as an integer.
+
+
+*-n*, *--name*::
+
+Module name to execute.
+
+
+*-a*, *--args*::
+
+Arguments to module.
+
+
+*-p*, *--pattern*::
+
+Hostname pattern. Accepts shell-like globs.
+
+
+*-r*, *--run-playbook*::
+
+Playbook file to run. Replaces the *-n* and *-a* options.
+
+
+*-u*, *--remote-user*::
+
+Remote user to connect as. Uses __root__ by default.
+
+
+INVENTORY
+---------
+
+Ansible stores the hosts it can potentially operate on in an inventory
+file. The syntax is simple: one host per line. Organize your hosts
+into multiple groups by separating them into multiple inventory files.
+
+
+FILES
+-----
+
+/etc/ansible/hosts -- Default hosts file
+
+/usr/share/ansible -- Default module library
+
+
+AUTHOR
+------
+
+Ansible was originally written by Michael DeHaan. See the AUTHORS file
+for a complete list of contributors.
+
+
+COPYRIGHT
+---------
+
+Copyright © 2012, Michael DeHaan
+
+Ansible is released under the terms of the MIT license.
+
+
+
+SEE ALSO
+--------
+
+Ansible home page:
diff --git a/setup.py b/setup.py
index 25f72ee5fd..0749f73a8f 100644
--- a/setup.py
+++ b/setup.py
@@ -19,10 +19,12 @@ setup(name='ansible',
'library/command',
'library/facter',
'library/copy',
+ ]),
+ ('man/man1', [
+ 'docs/man/man1/ansible.1'
])
],
scripts=[
'bin/ansible',
]
)
-