From 34aefbc0f6ea3340c6661f1c23be3ae1fe5f0a71 Mon Sep 17 00:00:00 2001
From: Kamila Souckova <kamila@ksp.sk>
Date: Sun, 11 Mar 2018 01:35:16 +0100
Subject: [PATCH] __prometheus_{server,alertmanager}: new man pages

---
 .../type/__prometheus_alertmanager/man.rst    | 25 ++++++++-----------
 .../type/__prometheus_alertmanager/manifest   |  1 -
 cdist/conf/type/__prometheus_server/man.rst   |  4 ++-
 3 files changed, 13 insertions(+), 17 deletions(-)

diff --git a/cdist/conf/type/__prometheus_alertmanager/man.rst b/cdist/conf/type/__prometheus_alertmanager/man.rst
index ba99e7c8..894100c8 100644
--- a/cdist/conf/type/__prometheus_alertmanager/man.rst
+++ b/cdist/conf/type/__prometheus_alertmanager/man.rst
@@ -18,19 +18,20 @@ REQUIRED PARAMETERS
 -------------------
 config
    Alertmanager configuration file. It will be saved as /etc/alertmanager/alertmanager.yml on the target.
-listen-address
-   Passed as web.listen-address.
 
 
 OPTIONAL PARAMETERS
 -------------------
 storage-path
    Where to put data. Default: /data/alertmanager. (Directory will be created if needed.)
+retention-days
+   How long to retain data. Default: 90 days.
 
 
 BOOLEAN PARAMETERS
 ------------------
-None
+install-from-backports
+   Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.
 
 
 EXAMPLES
@@ -38,21 +39,15 @@ EXAMPLES
 
 .. code-block:: sh
 
-    ALERTPORT=9093
-
-    __daemontools
-    __golang_from_vendor --version 1.8.1  # required for prometheus and many exporters
-
-    require="__daemontools __golang_from_vendor" __prometheus_alertmanager \
-      --with-daemontools \
-      --config "$__manifest/files/alertmanager.yml" \
-      --storage-path /data/alertmanager \
-      --listen-address "[::]:$ALERTPORT"
+    __prometheus_alertmanager \
+        --install-from-backports \
+        --config "$__manifest/files/alertmanager.yml" \
+        --storage-path /data/alertmanager
 
 
 SEE ALSO
 --------
-:strong:`cdist-type__prometheus_server`\ (7), :strong:`cdist-type__daemontools`\ (7),
+:strong:`cdist-type__prometheus_server`\ (7), :strong:`cdist-type__grafana_dashboard`\ (7),
 Prometheus alerting documentation: https://prometheus.io/docs/alerting/overview/
 
 AUTHORS
@@ -61,7 +56,7 @@ Kamila Součková <kamila--@--ksp.sk>
 
 COPYING
 -------
-Copyright \(C) 2017 Kamila Součková. You can redistribute it
+Copyright \(C) 2018 Kamila Součková. You can redistribute it
 and/or modify it under the terms of the GNU General Public License as
 published by the Free Software Foundation, either version 3 of the
 License, or (at your option) any later version.
diff --git a/cdist/conf/type/__prometheus_alertmanager/manifest b/cdist/conf/type/__prometheus_alertmanager/manifest
index 926ad712..8278170a 100755
--- a/cdist/conf/type/__prometheus_alertmanager/manifest
+++ b/cdist/conf/type/__prometheus_alertmanager/manifest
@@ -48,7 +48,6 @@ require="$require $require_pkg" __directory "$storage_path" --owner prometheus -
 require="$require $require_pkg" \
 __key_value alertmanager_fix_init_script --file /etc/init.d/prometheus-alertmanager --key="NAME" --value="prometheus-alertmanager" --delimiter "="
 
-
 ##### CONFIGURE #############################################################
 
 FLAGS="--storage.path $storage_path --data.retention $(($retention_days*24))h --web.listen-address [::]:9093"
diff --git a/cdist/conf/type/__prometheus_server/man.rst b/cdist/conf/type/__prometheus_server/man.rst
index 33dd3e53..4308e6c4 100644
--- a/cdist/conf/type/__prometheus_server/man.rst
+++ b/cdist/conf/type/__prometheus_server/man.rst
@@ -30,7 +30,8 @@ storage-path
 
 BOOLEAN PARAMETERS
 ------------------
-None
+install-from-backports
+   Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.
 
 
 EXAMPLES
@@ -42,6 +43,7 @@ EXAMPLES
     ALERTPORT=9093
 
     __prometheus_server \
+        --install-from-backports \
         --config "$__manifest/files/prometheus.yml" \
         --retention-days 14 \
         --storage-path /data/prometheus \