From d2ae160b22724edea7fd6ba290c474492a7a8b32 Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Mon, 15 Jan 2018 13:00:33 +0100
Subject: [PATCH] pmgsubscription.adoc: improve subscription docs

---
 asciidoc/asciidoc-pmg.conf |  1 +
 getting-help.adoc          | 12 ++++++------
 pmg-installation.adoc      |  2 +-
 pmgsubscription.adoc       | 32 +++++++++++++++++++++++++++++++-
 4 files changed, 39 insertions(+), 8 deletions(-)

diff --git a/asciidoc/asciidoc-pmg.conf b/asciidoc/asciidoc-pmg.conf
index b2d3b11..3f49d0f 100644
--- a/asciidoc/asciidoc-pmg.conf
+++ b/asciidoc/asciidoc-pmg.conf
@@ -3,6 +3,7 @@
 proxmoxGmbh=Proxmox Server Solutions Gmbh
 copyright=Proxmox Server Solutions Gmbh
 pmg=Proxmox Mail Gateway
+pricing-url=https://www.proxmox.com/en/proxmox-mail-gateway/pricing
 website=http://www.proxmox.com/
 forum-url=https://forum.proxmox.com/
 forum=https://forum.proxmox.com/[Proxmox Community Forum]
diff --git a/getting-help.adoc b/getting-help.adoc
index ab9a27c..74bb9f5 100644
--- a/getting-help.adoc
+++ b/getting-help.adoc
@@ -19,12 +19,12 @@ great place to get information.
 Commercial Support
 ~~~~~~~~~~~~~~~~~~
 
-{proxmoxGmbh} also offers commercial 
-https://www.proxmox.com/en/proxmox-mail-gateway/pricing[{pmg} Subscription Service Plans]. System Administrators with a standard subscription plan can access a 
-dedicated support portal with guaranteed reponse time, where {pmg}
-developers help them should an issue appear.
-Please contact the mailto:office@proxmox.com[Proxmox sales team]
-for more information or volume discounts.
+{proxmoxGmbh} also offers commercial {pricing-url}[{pmg} Subscription
+Service Plans]. System Administrators with a standard subscription
+plan can access a dedicated support portal with guaranteed reponse
+time, where {pmg} developers help them should an issue appear.  Please
+contact the mailto:office@proxmox.com[Proxmox sales team] for more
+information or volume discounts.
 
 
 Bug Tracker
diff --git a/pmg-installation.adoc b/pmg-installation.adoc
index d62a011..d3601dc 100644
--- a/pmg-installation.adoc
+++ b/pmg-installation.adoc
@@ -281,7 +281,7 @@ update. So you will never miss important security fixes.
 
 Please note that and you need a valid subscription key to access this
 repository. We offer different support levels, and you can find further
-details at https://www.proxmox.com/en/proxmox-mail-gateway/pricing.
+details at {pricing-url}.
 
 NOTE: You can disable this repository by commenting out the above line
 using a `#` (at the start of the line). This prevents error messages
diff --git a/pmgsubscription.adoc b/pmgsubscription.adoc
index 91ebba4..4b2fe5c 100644
--- a/pmgsubscription.adoc
+++ b/pmgsubscription.adoc
@@ -22,7 +22,37 @@ pmgsubscription - Subscription Management
 =========================================
 endif::manvolnum[]
 
-This tool is used to handle {pmg} subscriptions.
+{pmg} is free open software, and the company that developed it
+(Proxmox Server Solutions GmbH) offers {pricing-url}[support] in many
+ways, with different support channel, level and pricing.
+
+The tool `pmgsubscription` is used to handle {pmg}
+subscriptions. Please use the GUI or the `set` command to upload a new
+key:
+
+----
+# pmgsubscription set <key>
+----
+
+
+NOTE: Subscription keys are bound to specific servers ('Server ID'),
+so you can use them for exactly one server. Each server needs its own
+key.
+
+
+The `get` command is used to view the current subscription status:
+
+----
+# pmgsubscription get
+key: pmgc-xxxxxxxxxx
+level: c
+productname: Proxmox Mail Gateway Trial Subscription 1 year
+regdate: 2017-12-15 00:00:00
+serverid: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+status: Active
+url: https://www.proxmox.com/en/proxmox-mail-gateway/pricing
+----
+
 
 ifdef::manvolnum[]
 include::pmg-copyright.adoc[]
-- 
2.39.2