From 2ec553b4803095ff05a9cb8f79fdb9c245813a4f Mon Sep 17 00:00:00 2001
From: Darko Poljak <foss@ungleich.com>
Date: Thu, 11 Apr 2019 14:30:23 +0200
Subject: [PATCH] Add cdist-dump man page

---
 docs/changelog               |   5 +-
 docs/src/index.rst           |   1 +
 docs/src/man1/cdist-dump.rst | 110 +++++++++++++++++++++++++++++++++++
 3 files changed, 114 insertions(+), 2 deletions(-)
 create mode 100644 docs/src/man1/cdist-dump.rst

diff --git a/docs/changelog b/docs/changelog
index c06715b7..e670ef49 100644
--- a/docs/changelog
+++ b/docs/changelog
@@ -2,9 +2,10 @@ Changelog
 ---------
 
 next:
-	* Debugging: Rename debug-dump.sh to cdist-dump(Darko Poljak)
-	* Type __link: Add messaging (Ander Punnar)
 	* New types: __ufw and __ufw_rule (Mark Polyakov)
+	* Type __link: Add messaging (Ander Punnar)
+	* Debugging: Rename debug-dump.sh to cdist-dump (Darko Poljak)
+	* Documentation: Add cdist-dump man page (Darko Poljak)
 
 4.10.9: 2019-04-09
 	* Type __ssh_authorized_keys: Properly handle multiple --option params (Steven Armstrong)
diff --git a/docs/src/index.rst b/docs/src/index.rst
index bef91e1c..af303f5b 100644
--- a/docs/src/index.rst
+++ b/docs/src/index.rst
@@ -18,6 +18,7 @@ Contents:
    cdist-quickstart
    cdist-real-world
    man1/cdist
+   man1/cdist-dump
    cdist-bootstrap
    cdist-configuration
    cdist-manifest
diff --git a/docs/src/man1/cdist-dump.rst b/docs/src/man1/cdist-dump.rst
new file mode 100644
index 00000000..907cd192
--- /dev/null
+++ b/docs/src/man1/cdist-dump.rst
@@ -0,0 +1,110 @@
+cdist-dump(1)
+=============
+
+NAME
+----
+cdist-dump - Dump data from local cdist cache
+
+
+SYNOPSIS
+--------
+
+::
+
+    cdist-dump [options] [host...]
+
+
+
+DESCRIPTION
+-----------
+cdist-dump is a helper script that dumps data from local cdist cache for
+specified hosts. If host is not specified then all data from cache directory
+is dumped. Default cache directory is '~/.cdist/cache'.
+
+cdist-dump can be used for debugging existing types, host configuration and
+new types. 
+
+
+OPTIONS
+-------
+**-a**
+   dump all
+
+**-C CACHE-DIR**
+   use specified CACHE-DIR (default: ~/.cdist/cache)
+
+**-c**
+   dump code-*
+
+**-d DELIMITER**
+   delimiter used for filename and line number prefix (default: ':')
+
+**-E**
+   dump global explorers
+
+**-e**
+   dump type explorers
+
+**-F**
+   disable filename prefix (enabled by default)
+
+**-f**
+   enable filename prefix (default)
+
+**-g**
+   dump gencode-*
+
+**-h**
+   show this help screen and exit
+
+**-L**
+   disable line number prefix (default)
+
+**-l**
+   enable line number prefix (disabled by default)
+
+**-m**
+   dump messages
+
+**-o**
+   dump executions' stdout
+
+**-p**
+   dump parameters
+
+**-r**
+   dump executions' stderr
+
+**-V**
+   show version and exit
+
+**-v**
+   increase verbosity
+
+
+EXAMPLES
+--------
+
+.. code-block:: sh
+
+    # Dump all
+    % cdist-dump -a
+
+    # Dump only code-* output
+    % cdist-dump -c
+
+
+SEE ALSO
+--------
+:strong:`cdist`\ (1)
+
+
+AUTHORS
+-------
+Darko Poljak <darko.poljak--@--ungleich.ch>
+
+
+COPYING
+-------
+Copyright \(C) 2019 Darko Poljak. Free use of this software is
+granted under the terms of the GNU General Public License v3 or later (GPLv3+).