gen-pmg.conf.5-opts.pl: allow to generate docs for subgroups

diff --git a/gen-pmg.conf.5-opts.pl b/gen-pmg.conf.5-opts.pl
index b2bb2d8b7569c35ac9ceed382324bdd44fbd43eb..fd928cea632848c2aeded12d037a0d90856421d2 100755 (executable)
--- a/gen-pmg.conf.5-opts.pl
+++ b/gen-pmg.conf.5-opts.pl
@@ -14,6 +14,27 @@ my $types = PMG::Config::Base->lookup_types;
 my $single_section = shift;
 my $found = 0;
 
+my $key_groups = {
+    'mail-relaying' => [
+       'mail' , {
+           relay => 1,
+           relaynomx => 1,
+           relayport => 1,
+           smarthost => 1,
+       }],
+};
+
+my $select_keys;
+
+if ($single_section) {
+    if (my $a =  $key_groups->{$single_section}) {
+       my ($sec, $hash) = @$a;
+       $single_section = $sec;
+       $select_keys = $hash;
+    }
+}
+
+
 foreach my $section (@$types) {
     my $plugin = PMG::Config::Base->lookup($section);
     my $schema = $plugin->updateSchema(1);
@@ -31,6 +52,7 @@ foreach my $section (@$types) {
        my ($key, $phash) = @_;
        return 1 if $key eq 'digest';
        return 1 if $key eq 'delete';
+       return 1 if $select_keys && !$select_keys->{$key};
        return 0;
     };
     

diff --git a/pmgconfig.adoc b/pmgconfig.adoc
index fa9c9fbe0af8a2ddea6cf1afa3fadc3f452bf211..238dfabd3c3d7c86eaebf29026a6cf7dc429bacb 100644 (file)
--- a/pmgconfig.adoc
+++ b/pmgconfig.adoc
@@ -221,6 +221,10 @@ ifndef::manvolnum[]
 image::images/screenshot/pmg-gui-system-options.png[]
 endif::manvolnum[]
 
+
+Those settings are saved to subsection 'admin' in `/etc/pmg/pmg.conf`,
+using the following configuration keys:
+
 include::pmg.admin-conf-opts.adoc[]
 
 
@@ -230,12 +234,14 @@ Mail Proxy Configuration
 Relaying
 ~~~~~~~~
 
-
 ifndef::manvolnum[]
 image::images/screenshot/pmg-gui-mailproxy-relaying.png[]
 endif::manvolnum[]
 
-TODO
+Those settings are saved to subsection 'mail' in `/etc/pmg/pmg.conf`,
+using the following configuration keys:
+
+include::pmg.mail-relaying-conf-opts.adoc[]
 
 Relay Domains
 ~~~~~~~~~~~~~