Browse code

Update %description and auto-add version to manpages

Conflicts:

docs/man/man1/ansible-playbook.1
docs/man/man1/ansible.1

Update %description

Tim Bielawa authored on 2012/04/17 23:31:29
Showing 7 changed files
... ...
@@ -16,10 +16,10 @@ tests:
16 16
 
17 17
 docs: $(MANPAGES)
18 18
 
19
-%.1: %.1.asciidoc
20
-	$(ASCII2MAN)
19
+%.1.asciidoc.gen: %.1.asciidoc ansible.spec
20
+	sed "s/%VERSION%/$(RPMVERSION)/" $< > $@
21 21
 
22
-%.5: %.5.asciidoc
22
+%.1: %.1.asciidoc.gen
23 23
 	$(ASCII2MAN)
24 24
 
25 25
 loc:
... ...
@@ -45,6 +45,7 @@ clean:
45 45
 	find . -type f \( -name "*.swp" \) -delete
46 46
 	@echo "Cleaning up asciidoc to man transformations and results"
47 47
 	find ./docs/man -type f -name "*.xml" -delete
48
+	find ./docs/man -type f -name "*.gen" -delete
48 49
 	@echo "Cleaning up output from test runs"
49 50
 	-rm -rf test/test_data
50 51
 	@echo "Cleaning up RPM building stuff"
... ...
@@ -20,9 +20,13 @@ Requires: python-paramiko
20 20
 Requires: python-jinja2
21 21
 
22 22
 %description
23
-Ansible is a extra-simple tool/API for doing 'parallel remote things' over SSH
24
-executing commands, running "modules", or executing larger 'playbooks' that
25
-can serve as a configuration management or deployment system.
23
+
24
+Ansible is a radically simple model-driven configuration management,
25
+multi-node deployment, and remote task execution system. Ansible works
26
+over SSH and does not require any software or daemons to be installed
27
+on remote nodes. Extension modules can be written in any language and
28
+are transferred to managed machines automatically.
29
+
26 30
 
27 31
 %prep
28 32
 %setup -q
... ...
@@ -1 +1,2 @@
1 1
 *.xml
2
+*.gen
... ...
@@ -1,13 +1,22 @@
1 1
 '\" t
2 2
 .\"     Title: ansible-playbook
3 3
 .\"    Author: [see the "AUTHOR" section]
4
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
-.\"      Date: 04/16/2012
4
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
+.\"      Date: 04/17/2012
6 6
 .\"    Manual: System administration commands
7 7
 .\"    Source: Ansible 0.0.2
8 8
 .\"  Language: English
9 9
 .\"
10
-.TH "ANSIBLE\-PLAYBOOK" "1" "04/16/2012" "Ansible 0\&.0\&.2" "System administration commands"
10
+.TH "ANSIBLE\-PLAYBOOK" "1" "04/17/2012" "Ansible 0\&.0\&.2" "System administration commands"
11
+.\" -----------------------------------------------------------------
12
+.\" * Define some portability stuff
13
+.\" -----------------------------------------------------------------
14
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
+.\" http://bugs.debian.org/507673
16
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
+.ie \n(.g .ds Aq \(aq
19
+.el       .ds Aq '
11 20
 .\" -----------------------------------------------------------------
12 21
 .\" * set default formatting
13 22
 .\" -----------------------------------------------------------------
... ...
@@ -2,7 +2,7 @@ ansible-playbook(1)
2 2
 ===================
3 3
 :doctype:manpage
4 4
 :man source:   Ansible
5
-:man version:  0.0.2
5
+:man version:  %VERSION%
6 6
 :man manual:   System administration commands
7 7
 
8 8
 NAME
... ...
@@ -1,13 +1,22 @@
1 1
 '\" t
2 2
 .\"     Title: ansible
3 3
 .\"    Author: [see the "AUTHOR" section]
4
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
-.\"      Date: 04/16/2012
4
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
+.\"      Date: 04/17/2012
6 6
 .\"    Manual: System administration commands
7 7
 .\"    Source: Ansible 0.0.2
8 8
 .\"  Language: English
9 9
 .\"
10
-.TH "ANSIBLE" "1" "04/16/2012" "Ansible 0\&.0\&.2" "System administration commands"
10
+.TH "ANSIBLE" "1" "04/17/2012" "Ansible 0\&.0\&.2" "System administration commands"
11
+.\" -----------------------------------------------------------------
12
+.\" * Define some portability stuff
13
+.\" -----------------------------------------------------------------
14
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
+.\" http://bugs.debian.org/507673
16
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
+.ie \n(.g .ds Aq \(aq
19
+.el       .ds Aq '
11 20
 .\" -----------------------------------------------------------------
12 21
 .\" * set default formatting
13 22
 .\" -----------------------------------------------------------------
... ...
@@ -25,7 +34,7 @@ ansible \- run a command somewhere else
25 25
 ansible <host\-pattern> [\-f forks] [\-m module_name] [\-a args]
26 26
 .SH "DESCRIPTION"
27 27
 .sp
28
-\fBAnsible\fR is an extra\-simple tool/framework/API for doing \'remote things\' over SSH\&.
28
+\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&.
29 29
 .SH "ARGUMENTS"
30 30
 .PP
31 31
 \fBhost\-pattern\fR
... ...
@@ -63,7 +72,7 @@ to load modules from\&. The default is
63 63
 \fI/usr/share/ansible\fR\&.
64 64
 .RE
65 65
 .PP
66
-\fB\-a\fR \'\fIARGUMENTS\fR\', \fB\-\-args=\fR\'\fIARGUMENTS\fR\'
66
+\fB\-a\fR \*(Aq\fIARGUMENTS\fR\*(Aq, \fB\-\-args=\fR\*(Aq\fIARGUMENTS\fR\*(Aq
67 67
 .RS 4
68 68
 The
69 69
 \fIARGUMENTS\fR
... ...
@@ -2,7 +2,7 @@ ansible(1)
2 2
 =========
3 3
 :doctype:manpage
4 4
 :man source:   Ansible
5
-:man version:  0.0.2
5
+:man version:  %VERSION%
6 6
 :man manual:   System administration commands
7 7
 
8 8
 NAME