[PATCH datacenter-manager v2 4/4] docs: add simple man page for pdmAtoB

[Lukas Wagner <l.wagner@proxmox.com>]

Mostly to silence the lintian warning complaining about the missing
page. The content was copied over from PBS and adapted.

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
Reviewed-by: Shannon Sterz <s.sterz@proxmox.com>
Tested-by: Shannon Sterz <s.sterz@proxmox.com>
---

Notes:
    Changes since v1:
      - rebased
      - slightly rephrased the pdmAtoB man page, thx @ Shannon

 debian/proxmox-datacenter-manager.install |  1 +
 docs/Makefile                             |  1 +
 docs/conf.py                              |  1 +
 docs/pdmAtoB/man1.rst                     | 17 +++++++++++++++++
 4 files changed, 20 insertions(+)
 create mode 100644 docs/pdmAtoB/man1.rst

diff --git a/debian/proxmox-datacenter-manager.install b/debian/proxmox-datacenter-manager.install
index 001d7272..fad3f4a4 100644
--- a/debian/proxmox-datacenter-manager.install
+++ b/debian/proxmox-datacenter-manager.install
@@ -12,6 +12,7 @@ usr/sbin/pdmAtoB
 usr/sbin/proxmox-datacenter-manager-admin
 usr/share/bash-completion/completions/pdmAtoB.bash
 usr/share/bash-completion/completions/proxmox-datacenter-manager-admin.bash
+usr/share/man/man1/pdmAtoB.1
 usr/share/man/man1/proxmox-datacenter-api.1
 usr/share/man/man1/proxmox-datacenter-manager-admin.1
 usr/share/man/man1/proxmox-datacenter-privileged-api.1
diff --git a/docs/Makefile b/docs/Makefile
index 0487c97e..faa633bc 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -7,6 +7,7 @@ GENERATED_SYNOPSIS := \
 	config/views/config.rst \
 
 MAN1_PAGES := \
+	pdmAtoB.1 \
 	proxmox-datacenter-manager-admin.1 \
 	proxmox-datacenter-manager-client.1 \
 	proxmox-datacenter-api.1 \
diff --git a/docs/conf.py b/docs/conf.py
index 9de1d1da..39724ef3 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -95,6 +95,7 @@ man_pages = [
     ('proxmox-datacenter-api/man1', 'proxmox-datacenter-api', 'Proxmox Datacenter Manager Public API Server', [author], 1),
     ('proxmox-datacenter-privileged-api/man1', 'proxmox-datacenter-privileged-api', 'Proxmox Datacenter Manager Privileged API Server', [author], 1),
     # CLI
+    ('pdmAtoB/man1', 'pdmAtoB', 'Upgrade checker for Proxmox Datacenter Manager', [author], 1),
     ('proxmox-datacenter-manager-admin/man1', 'proxmox-datacenter-manager-admin', 'Command line tool for managing Proxmox Datacenter Manager hosts.', [author], 1),
     ('proxmox-datacenter-manager-client/man1', 'proxmox-datacenter-manager-client', 'Command line tool for connecting and controlling the remotes and resources of a Proxmox Datacenter Manager hosts.', [author], 1),
     # configs
diff --git a/docs/pdmAtoB/man1.rst b/docs/pdmAtoB/man1.rst
new file mode 100644
index 00000000..04a6ff26
--- /dev/null
+++ b/docs/pdmAtoB/man1.rst
@@ -0,0 +1,17 @@
+:orphan:
+
+
+=======
+pdmAtoB
+=======
+
+Description
+===========
+
+This tool will help you detect common pitfalls and misconfigurations before and
+during the upgrade of a Proxmox Datacenter Manager system. Any failures or
+warnings must be addressed prior to the upgrade. If you suspect that a message
+is a false positive, utmost carefulness is advised when proceeding with the
+upgrade.
+
+.. include:: ../pdm-copyright.rst
-- 
2.47.3