From 8073b8e6e9127737e4e7af086498eafe21004007 Mon Sep 17 00:00:00 2001
From: Antoine Cotten <tonio.cotten@gmail.com>
Date: Thu, 18 Dec 2014 17:26:26 +0100
Subject: [PATCH] improve doc and bump version

---
 CHANGELOG.md  |  5 +++++
 README.md     | 19 +++++++++++++++----
 metadata.json |  2 +-
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8f9b5f8..7507c2b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,8 @@
+###0.4.1
+
+* Document missing parameter `installation_support`
+* Improve documentation
+
 ###0.4.0
 
 * Support installation from archive
diff --git a/README.md b/README.md
index bdbf7f3..8b63b3f 100644
--- a/README.md
+++ b/README.md
@@ -15,11 +15,11 @@
 
 ##Overview
 
-The tomcat module installs and configures Apache Tomcat instances from the available packages in your distribution's repositories.
+The tomcat module installs and configures Apache Tomcat instances from either the packages available in your distribution's repositories, or from any archive file you provide to it.
 
 ##Module description
 
-Almost all Linux distributions provide one or more maintained packages of the Tomcat application server. These are available either from the distribution repositories or third-party sources ([JPackage](http://www.jpackage.org), [EPEL](https://fedoraproject.org/wiki/EPEL), ...). This module will install the desired version of tomcat and its dependencies from the repositories available on the target system.  
+This module will install the desired version of the Apache Tomcat Web Application Container from almost any possible source, including the repositories available on the target system (distribution repositories or third-party sources like [JPackage](http://www.jpackage.org) and [EPEL](https://fedoraproject.org/wiki/EPEL)  
 A long list of parameters permit a fine-tuning of the server and the JVM. It is for example possible to configure admin applications, install extra tomcat libraries, configure log4j as the standard logger, or enable the remote JMX listener.  
 The creation of individual instances is also supported via a custom type.
 
@@ -40,6 +40,15 @@ include ::tomcat
 
 ####A couple of examples
 
+Install from archive instead of package
+
+```puppet
+class { '::tomcat':
+  installation_support => 'archive',
+  version              => '8.0.15'
+}
+```
+
 Use a non-default JVM and run it with custom options
 
 ```puppet
@@ -158,12 +167,14 @@ Primary class and entry point of the module
 
 **Packages and service**
 
+#####`installation_support`
+What type of source to install from. The module will download the necessary files by itself. Valid values are `package` and `archive`. Defaults to `package`.
+#####`archive_source`
+Source of the tomcat server archive, if installed from archive. Supports local files, puppet://, http://, https:// and ftp://. Defaults to `http://archive.apache.org/dist/tomcat/tomcat-${maj_version}/v${version}/bin/apache-tomcat-${version}.tar.gz`
 #####`version`
 Tomcat full version number. The valid format is 'x.y.z'. Default depends on the distribution.  
 *Note:* if you install tomcat from package and define this value manually, please make **sure** this version of tomcat if available in your system's repositories, since several sub-parameters depend on it  
 A list of available versions in each supported distribution is present withing the `params` class.
-#####`archive_source`
-Source of the tomcat server archive, if installed from archive. Defaults to `http://archive.apache.org/dist/tomcat/tomcat-${maj_version}/v${version}/bin/apache-tomcat-${version}.tar.gz`
 #####`package_name`
 Tomcat package name. Ignored if installed from archive. Default depends on the distribution.
 #####`tomcat_native`
diff --git a/metadata.json b/metadata.json
index f7ca54e..d460e96 100644
--- a/metadata.json
+++ b/metadata.json
@@ -2,7 +2,7 @@
   "name": "aco-tomcat",
   "summary": "Puppet module for Tomcat",
   "author": "Antoine Cotten",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "license": "Apache-2.0",
   "project_page": "https://github.com/tOnI0/aco-tomcat",
   "source": "git://github.com/tOnI0/aco-tomcat.git",