docs: promote test subcommand

docs/configuration/map_filter_syntax.rst

@@ -82,6 +82,10 @@ The example is from the :sampleconf:`localbackup/host1.yml` example config.
     zroot/poudriere/ports/2017Q3        => NOT MAPPED
     zroot/poudriere/ports/HEAD          => NOT MAPPED
 
+.. TIP::
+
+   You can try out patterns for a configured job using the ``zrepl test`` subcommand.
+
 .. _pattern-filter:
 
 Filters

docs/configuration/preface.rst

@@ -31,3 +31,9 @@ Alternatively, for default settings, the following should to the trick.
     chmod -R 0700 /var/run/zrepl
 
 
+----------
+Validating
+----------
+
+The config can be validated using the ``zrepl test`` subcommand.
+

docs/configuration/prune.rst

@@ -12,6 +12,10 @@ Check the respective :ref:`job definition <job>` for details.
 
 Currently, the :ref:`prune-retention-grid` is the only supported pruning policy.
 
+.. TIP::
+
+    You can perform a dry-run of a job's pruning policy using the ``zrepl test`` subcommand.
+
 .. _prune-retention-grid:
 
 Retention Grid

docs/usage.rst

@@ -25,6 +25,8 @@ CLI Overview
       - control / query the daemon
     * - ``zrepl control status``
       - show job activity / monitoring (``--format raw``)
+    * - ``zrepl test``
+      - test configuration, try pattern syntax, dry run pruning policy, etc.
     * - ``zrepl stdinserver``
       - see :ref:`transport-ssh+stdinserver`