From bc132ec5800793def47ba7c46ff510994c9a7a5a Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Sat, 5 Nov 2016 17:29:22 +0100
Subject: [PATCH] gen-pct-network-opts.pl: improve layout

---
 gen-pct-network-opts.pl |  5 +++--
 pct-network-opts.adoc   | 30 ++++++++++++++++--------------
 2 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/gen-pct-network-opts.pl b/gen-pct-network-opts.pl
index f8b7d07..054e5fc 100755
--- a/gen-pct-network-opts.pl
+++ b/gen-pct-network-opts.pl
@@ -15,6 +15,7 @@ my $format = $phash->{format};
 
 my $typetext = PVE::JSONSchema::schema_get_type_text($phash);
 
-print "`net[n]`: `$typetext`\n\n";
+print "`net[n]`: `$typetext` ::\n\n";
+print $phash->{description} . "\n\n";
 
-print PVE::RESTHandler::dump_properties($format);
+print PVE::RESTHandler::dump_properties($format, 'asciidoc', 'config-sub');
diff --git a/pct-network-opts.adoc b/pct-network-opts.adoc
index 8bb9855..50354da 100644
--- a/pct-network-opts.adoc
+++ b/pct-network-opts.adoc
@@ -1,54 +1,56 @@
-`net[n]`: `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]`
+`net[n]`: `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::
 
-`bridge`: `<bridge>` ::
+Specifies network interfaces for the container.
+
+`bridge`=`<bridge>` ;;
 
 Bridge to attach the network device to.
 
-`firewall`: `<boolean>` ::
+`firewall`=`<boolean>` ;;
 
 Controls whether this interface's firewall rules should be used.
 
-`gw`: `<GatewayIPv4>` ::
+`gw`=`<GatewayIPv4>` ;;
 
 Default gateway for IPv4 traffic.
 
-`gw6`: `<GatewayIPv6>` ::
+`gw6`=`<GatewayIPv6>` ;;
 
 Default gateway for IPv6 traffic.
 
-`hwaddr`: `<XX:XX:XX:XX:XX:XX>` ::
+`hwaddr`=`<XX:XX:XX:XX:XX:XX>` ;;
 
 The interface MAC address. This is dynamically allocated by default, but you can set that statically if needed, for example to always have the same link-local IPv6 address. (lxc.network.hwaddr)
 
-`ip`: `<IPv4Format/CIDR>` ::
+`ip`=`<IPv4Format/CIDR>` ;;
 
 IPv4 address in CIDR format.
 
-`ip6`: `<IPv6Format/CIDR>` ::
+`ip6`=`<IPv6Format/CIDR>` ;;
 
 IPv6 address in CIDR format.
 
-`mtu`: `<integer> (64 - N)` ::
+`mtu`=`<integer> (64 - N)` ;;
 
 Maximum transfer unit of the interface. (lxc.network.mtu)
 
-`name`: `<string>` ::
+`name`=`<string>` ;;
 
 Name of the network device as seen from inside the container. (lxc.network.name)
 
-`rate`: `<mbps>` ::
+`rate`=`<mbps>` ;;
 
 Apply rate limiting to the interface
 
-`tag`: `<integer> (1 - 4094)` ::
+`tag`=`<integer> (1 - 4094)` ;;
 
 VLAN tag for this interface.
 
-`trunks`: `<vlanid[;vlanid...]>` ::
+`trunks`=`<vlanid[;vlanid...]>` ;;
 
 VLAN ids to pass through the interface
 
-`type`: `<veth>` ::
+`type`=`<veth>` ;;
 
 Network interface type.
 
-- 
2.39.2