From fabdaf9100f4839a8421456d640283d5dd7ba755 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fabian=20Gr=C3=BCnbichler?= <f.gruenbichler@proxmox.com>
Date: Thu, 21 Jul 2022 15:56:38 +0200
Subject: [PATCH] add docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
---
 Makefile                                      |   7 +
 README                                        |  85 ----
 debian/rules                                  |  13 +
 defines.mk                                    |  14 +
 docs/GFDL.rst                                 | 422 ++++++++++++++++
 docs/Makefile                                 |  94 ++++
 .../proxmox-scanrefs.cpython-39.pyc           | Bin 0 -> 3722 bytes
 docs/_ext/proxmox-scanrefs.py                 | 153 ++++++
 docs/_templates/index-sidebar.html            |  11 +
 docs/_templates/sidebar-header.html           |   7 +
 docs/command-syntax.rst                       |  13 +
 docs/conf.py                                  | 475 ++++++++++++++++++
 docs/config/mirror/man5.rst                   |  16 +
 docs/configuration-files.rst                  |  14 +
 docs/custom.css                               |  88 ++++
 docs/custom.js                                |   7 +
 docs/epilog.rst                               |  19 +
 docs/images/favicon.ico                       | Bin 0 -> 2336 bytes
 docs/images/proxmox-logo.png                  | Bin 0 -> 15899 bytes
 docs/images/proxmox-logo.svg                  | 243 +++++++++
 docs/index.rst                                |  47 ++
 docs/introduction.rst                         | 149 ++++++
 docs/pom-copyright.rst                        |  18 +
 docs/proxmox-apt-repo/description.rst         |   2 +
 docs/proxmox-apt-repo/man1.rst                |  16 +
 docs/proxmox-offline-mirror/description.rst   |   2 +
 docs/proxmox-offline-mirror/man1.rst          |  16 +
 docs/todos.rst                                |   6 +
 src/bin/docgen.rs                             |  31 ++
 src/config.rs                                 |   2 +-
 30 files changed, 1884 insertions(+), 86 deletions(-)
 delete mode 100644 README
 create mode 100644 debian/rules
 create mode 100644 defines.mk
 create mode 100644 docs/GFDL.rst
 create mode 100644 docs/Makefile
 create mode 100644 docs/_ext/__pycache__/proxmox-scanrefs.cpython-39.pyc
 create mode 100644 docs/_ext/proxmox-scanrefs.py
 create mode 100644 docs/_templates/index-sidebar.html
 create mode 100644 docs/_templates/sidebar-header.html
 create mode 100644 docs/command-syntax.rst
 create mode 100644 docs/conf.py
 create mode 100644 docs/config/mirror/man5.rst
 create mode 100644 docs/configuration-files.rst
 create mode 100644 docs/custom.css
 create mode 100644 docs/custom.js
 create mode 100644 docs/epilog.rst
 create mode 100755 docs/images/favicon.ico
 create mode 100644 docs/images/proxmox-logo.png
 create mode 100644 docs/images/proxmox-logo.svg
 create mode 100644 docs/index.rst
 create mode 100644 docs/introduction.rst
 create mode 100644 docs/pom-copyright.rst
 create mode 100644 docs/proxmox-apt-repo/description.rst
 create mode 100644 docs/proxmox-apt-repo/man1.rst
 create mode 100644 docs/proxmox-offline-mirror/description.rst
 create mode 100644 docs/proxmox-offline-mirror/man1.rst
 create mode 100644 docs/todos.rst
 create mode 100644 src/bin/docgen.rs

diff --git a/Makefile b/Makefile
index 5344d66..200c196 100644
--- a/Makefile
+++ b/Makefile
@@ -1,10 +1,13 @@
 include /usr/share/dpkg/pkg-info.mk
 include /usr/share/dpkg/architecture.mk
+include defines.mk
 
 PACKAGE=proxmox-offline-mirror
 BUILDDIR ?= $(PACKAGE)-$(DEB_VERSION_UPSTREAM)
 BUILDDIR_TMP ?= $(BUILDDIR).tmp
 
+SUBDIRS := docs
+
 DEB=$(PACKAGE)_$(DEB_VERSION_UPSTREAM_REVISION)_$(DEB_BUILD_ARCH).deb
 LIB_DEB=librust-$(PACKAGE)-dev_$(DEB_VERSION_UPSTREAM_REVISION)_$(DEB_BUILD_ARCH).deb
 DBG_DEB=$(PACKAGE)-dbgsym_$(DEB_VERSION_UPSTREAM_REVISION)_$(DEB_BUILD_ARCH).deb
@@ -23,6 +26,10 @@ all: cargo-build $(SUBDIRS)
 cargo-build:
 	cargo build $(CARGO_BUILD_ARGS)
 
+.PHONY: $(SUBDIRS)
+$(SUBDIRS):
+	$(MAKE) -C $@
+
 .PHONY: build
 build:
 	rm -rf $(BUILDDIR) $(BUILDDIR_TMP); mkdir $(BUILDDIR_TMP)
diff --git a/README b/README
deleted file mode 100644
index 7702ae4..0000000
--- a/README
+++ /dev/null
@@ -1,85 +0,0 @@
-proxmox-apt-mirror tool
-=======================
-
-This tool consists of two binaries, `proxmox-apt-mirror` (mirror tool to create
-and manage mirrors and media containing repositories) and `proxmox-apt-repo`
-(helper to use media on offline systems).
-
-There are two basic entity types available for configuration:
-- mirrors, consisting of upstream repository metadata and a local path where snapshots are stored
--- configured with `proxmox-apt-mirror config mirror ...`
--- used with `proxmox-apt-mirror mirror ...`
-- media, consisting of local mirrors and a path where mirrors are synced to
--- configured with `proxmox-apt-mirror config medium ...`
--- used with `proxmox-apt-mirror medium ...`
-
-and one internal one, a `pool` consisting of
-- a pool directory containing checksum files (e.g., `sha256/3dc7bc5f82cdcc4ea0f69dd30d5f6bb19e0ccc36f4a79c865eed0e7a370cd5e4`)
-- a base directory containing directories and hardlinks to checksum files inside the pool directory
-
-Adding a file consists of first adding the checksum file(s), then linking them
-under one or more paths. a garbage collect operation will iterate over all
-files in the base directory and remove those which are not (or no longer) a
-hardlink to any checksum files, and remove any checksum files which have no
-hardlinks outside of the pool checksum file directories.
-
-A default config path of `/etc/proxmox-apt-mirror.cfg` is used, but is
-overridable on a per command basis (for example, to allow operation as non-root
-user).
-
-Setting up a mirror
-===================
-
-First either run the `setup` wizard (`proxmox-apt-mirror setup`), or the
-`config mirror add` command. For example, to add a mirror entry for the Debian
-Bullseye security repository, the following command can be used:
-
- proxmox-apt-mirror config mirror add \
-  --id debian-bullseye-security \
-  --architectures amd64 \
-  --architectures all \
-  --repository 'deb http://deb.debian.org/debian-security bullseye-security main contrib non-free' \
-  --key-path /etc/apt/trusted.gpg.d/debian-archive-bullseye-security-automatic.gpg \
-  --sync true \
-  --verify true \
-  --base-dir /path/to/mirror/dir/debian-bullseye-security \
-  --pool-dir /path/to/mirror/dir/debian-bullseye-security/.pool
-
-Syncing a mirror
-================
-
-To create the first (and subsequent) snapshots, the following command can be used:
-
- proxmox-apt-mirror mirror snapshot create --id debian-bullseye-security
-
-Setting up a medium
-===================
-
-Either run the `setup` wizard again, or use the `config medium add` command.
-For example, to define a new medium containing the
-`proxmox-ve-bullseye-no-subscription` and `debian-bullseye` mirrors, run the
-following command:
-
- proxmox-apt-mirror config medium add \
-  --id pve-bullseye \
-  --mirrors proxmox-ve-bullseye-no-subscription \
-  --mirrors debian-bullseye \
-  --sync true \
-  --verify true \
-  --mountpoint /path/where/medium/is/mounted
-
-Syncing a medium
-================
-
-To sync the local mirrors to a medium, the following command can be used:
-
- proxmox-apt-mirror medium sync --id pve-bullseye
-
-Using a medium
-==============
-
-After syncing a medium, unmount it and make it accessible on the (offline)
-target system. You can now either manually point apt at the synced snapshots,
-or run `proxmox-apt-repo setup` to generate a sources.list.d snippet referecing
-selected mirrors and snapshots. Don't forget to remove the snippet again after
-the upgrade is done.
diff --git a/debian/rules b/debian/rules
new file mode 100644
index 0000000..879a659
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,13 @@
+#!/usr/bin/make -f
+
+export BUILD_MODE=release-deb
+%:
+	dh $@ --buildsystem cargo
+
+override_dh_auto_test:
+	# skip for now to avoid additional debug builds - no tests anyway
+	# dh_auto_test -- test --all
+
+override_dh_auto_install:
+	dh_auto_install
+	DESTDIR=../debian/proxmox-offline-mirror make -C docs install
diff --git a/defines.mk b/defines.mk
new file mode 100644
index 0000000..ebccd2b
--- /dev/null
+++ b/defines.mk
@@ -0,0 +1,14 @@
+PREFIX = /usr
+BINDIR = $(PREFIX)/bin
+SBINDIR = $(PREFIX)/sbin
+LIBDIR = $(PREFIX)/lib
+LIBEXECDIR = $(LIBDIR)
+DATAROOTDIR = $(PREFIX)/share
+MAN1DIR = $(PREFIX)/share/man/man1
+MAN5DIR = $(PREFIX)/share/man/man5
+DOCDIR = $(PREFIX)/share/doc/proxmox-offline-mirror
+SYSCONFDIR = /etc
+ZSH_COMPL_DEST = $(PREFIX)/share/zsh/vendor-completions
+
+# For local overrides
+-include local.mak
diff --git a/docs/GFDL.rst b/docs/GFDL.rst
new file mode 100644
index 0000000..67a6d11
--- /dev/null
+++ b/docs/GFDL.rst
@@ -0,0 +1,422 @@
+GNU Free Documentation License
+==============================
+
+Version 1.3, 3 November 2008
+
+
+Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. <https://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this
+ license document, but changing it is not allowed.
+
+0. PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or other
+functional and useful document "free" in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
+
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+
+
+1. APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License.  Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein.  The "Document", below,
+refers to any such manual or work.  Any member of the public is a
+licensee, and is addressed as "you".  You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
+
+A "Modified Version" of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+A "Secondary Section" is a named appendix or a front-matter section of
+the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall
+subject (or to related matters) and contains nothing that could fall
+directly within that overall subject.  (Thus, if the Document is in
+part a textbook of mathematics, a Secondary Section may not explain
+any mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+
+The "Invariant Sections" are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.  If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant.  The Document may contain zero
+Invariant Sections.  If the Document does not identify any Invariant
+Sections then there are none.
+
+The "Cover Texts" are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.  A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
+
+A "Transparent" copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, that is suitable for revising the document
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text.  A copy that is not "Transparent" is called "Opaque".
+
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
+or XML using a publicly available DTD, and standard-conforming simple
+HTML, PostScript or PDF designed for human modification.  Examples of
+transparent image formats include PNG, XCF and JPG.  Opaque formats
+include proprietary formats that can be read and edited only by
+proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the
+machine-generated HTML, PostScript or PDF produced by some word
+processors for output purposes only.
+
+The "Title Page" means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, "Title Page" means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+
+The "publisher" means any person or entity that distributes copies of
+the Document to the public.
+
+A section "Entitled XYZ" means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language.  (Here XYZ stands for a
+specific section name mentioned below, such as "Acknowledgements",
+"Dedications", "Endorsements", or "History".)  To "Preserve the Title"
+of such a section when you modify the Document means that it remains a
+section "Entitled XYZ" according to this definition.
+
+The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document.  These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+
+2. VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no
+other conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+
+3. COPYING IN QUANTITY
+
+If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document's license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
+
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to
+give them a chance to provide you with an updated version of the
+Document.
+
+
+4. MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+
+A. Use in the Title Page (and on the covers, if any) a title distinct
+   from that of the Document, and from those of previous versions
+   (which should, if there were any, be listed in the History section
+   of the Document).  You may use the same title as a previous version
+   if the original publisher of that version gives permission.
+B. List on the Title Page, as authors, one or more persons or entities
+   responsible for authorship of the modifications in the Modified
+   Version, together with at least five of the principal authors of the
+   Document (all of its principal authors, if it has fewer than five),
+   unless they release you from this requirement.
+C. State on the Title page the name of the publisher of the
+   Modified Version, as the publisher.
+D. Preserve all the copyright notices of the Document.
+E. Add an appropriate copyright notice for your modifications
+   adjacent to the other copyright notices.
+F. Include, immediately after the copyright notices, a license notice
+   giving the public permission to use the Modified Version under the
+   terms of this License, in the form shown in the Addendum below.
+G. Preserve in that license notice the full lists of Invariant Sections
+   and required Cover Texts given in the Document's license notice.
+H. Include an unaltered copy of this License.
+I. Preserve the section Entitled "History", Preserve its Title, and add
+   to it an item stating at least the title, year, new authors, and
+   publisher of the Modified Version as given on the Title Page.  If
+   there is no section Entitled "History" in the Document, create one
+   stating the title, year, authors, and publisher of the Document as
+   given on its Title Page, then add an item describing the Modified
+   Version as stated in the previous sentence.
+J. Preserve the network location, if any, given in the Document for
+   public access to a Transparent copy of the Document, and likewise
+   the network locations given in the Document for previous versions
+   it was based on.  These may be placed in the "History" section.
+   You may omit a network location for a work that was published at
+   least four years before the Document itself, or if the original
+   publisher of the version it refers to gives permission.
+K. For any section Entitled "Acknowledgements" or "Dedications",
+   Preserve the Title of the section, and preserve in the section all
+   the substance and tone of each of the contributor acknowledgements
+   and/or dedications given therein.
+L. Preserve all the Invariant Sections of the Document,
+   unaltered in their text and in their titles.  Section numbers
+   or the equivalent are not considered part of the section titles.
+M. Delete any section Entitled "Endorsements".  Such a section
+   may not be included in the Modified Version.
+N. Do not retitle any existing section to be Entitled "Endorsements"
+   or to conflict in title with any Invariant Section.
+O. Preserve any Warranty Disclaimers.
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section Entitled "Endorsements", provided it contains
+nothing but endorsements of your Modified Version by various
+parties--for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+
+
+5. COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice, and that you preserve all their Warranty Disclaimers.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections Entitled "History"
+in the various original documents, forming one section Entitled
+"History"; likewise combine any sections Entitled "Acknowledgements",
+and any sections Entitled "Dedications".  You must delete all sections
+Entitled "Endorsements".
+
+
+6. COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other
+documents released under this License, and replace the individual
+copies of this License in the various documents with a single copy
+that is included in the collection, provided that you follow the rules
+of this License for verbatim copying of each of the documents in all
+other respects.
+
+You may extract a single document from such a collection, and
+distribute it individually under this License, provided you insert a
+copy of this License into the extracted document, and follow this
+License in all other respects regarding verbatim copying of that
+document.
+
+
+7. AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, is called an "aggregate" if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation's users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document's Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
+
+
+8. TRANSLATION
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers.  In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled "Acknowledgements",
+"Dedications", or "History", the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
+
+
+9. TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense, or distribute it is void, and
+will automatically terminate your rights under this License.
+
+However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, receipt of a copy of some or all of the same material does
+not give you any rights to use it.
+
+
+10. FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions of the
+GNU Free Documentation License from time to time.  Such new versions
+will be similar in spirit to the present version, but may differ in
+detail to address new problems or concerns.  See
+https://www.gnu.org/licenses/.
+
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.  If the Document
+specifies that a proxy can decide which future versions of this
+License can be used, that proxy's public statement of acceptance of a
+version permanently authorizes you to choose that version for the
+Document.
+
+11. RELICENSING
+
+"Massive Multiauthor Collaboration Site" (or "MMC Site") means any
+World Wide Web server that publishes copyrightable works and also
+provides prominent facilities for anybody to edit those works.  A
+public wiki that anybody can edit is an example of such a server.  A
+"Massive Multiauthor Collaboration" (or "MMC") contained in the site
+means any set of copyrightable works thus published on the MMC site.
+
+"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 
+license published by Creative Commons Corporation, a not-for-profit 
+corporation with a principal place of business in San Francisco, 
+California, as well as future copyleft versions of that license 
+published by that same organization.
+
+"Incorporate" means to publish or republish a Document, in whole or in 
+part, as part of another Document.
+
+An MMC is "eligible for relicensing" if it is licensed under this 
+License, and if all works that were first published under this License 
+somewhere other than this MMC, and subsequently incorporated in whole or 
+in part into the MMC, (1) had no cover texts or invariant sections, and 
+(2) were thus incorporated prior to November 1, 2008.
+
+The operator of an MMC Site may republish an MMC contained in the site
+under CC-BY-SA on the same site at any time before August 1, 2009,
+provided the MMC is eligible for relicensing.
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..05b9067
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,94 @@
+include ../defines.mk
+
+GENERATED_SYNOPSIS := 						\
+	proxmox-offline-mirror/synopsis.rst			\
+	proxmox-apt-repo/synopsis.rst			\
+	config/mirror/config.rst
+
+MAN1_PAGES := 				\
+	proxmox-offline-mirror.1	\
+	proxmox-apt-repo.1
+
+MAN5_PAGES :=				\
+	mirror.cfg.5
+
+# Sphinx documentation setup
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+BUILDDIR      = output
+
+ifeq ($(BUILD_MODE), release)
+COMPILEDIR := ../target/release
+SPHINXOPTS    += -t release
+else ifeq ($(BUILD_MODE), release-deb)
+COMPILEDIR := ../target/$(DEB_TARGET_GNU_CPU)-unknown-$(DEB_TARGET_GNU_SYSTEM)/release
+SPHINXOPTS    += -t release
+else
+COMPILEDIR := ../target/debug
+SPHINXOPTS    += -t devbuild
+endif
+
+# Sphinx internal variables.
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .
+
+all: ${MAN1_PAGES} ${MAN5_PAGES}
+
+config/%/config.rst: ${COMPILEDIR}/docgen
+	${COMPILEDIR}/docgen $*.cfg >$@
+
+%/synopsis.rst: ${COMPILEDIR}/%
+	$< printdoc > $@
+
+${MAN1_PAGES} ${MAN5_PAGES}: man-pages
+
+.PHONY: man-pages
+man-pages: ${GENERATED_SYNOPSIS}
+	${SPHINXBUILD} ${SPHINXOPTS} -b man ./ ${BUILDDIR}/man
+
+.PHONY: html
+html: ${GENERATED_SYNOPSIS} images/proxmox-logo.svg custom.css conf.py ${PRUNE_SIMULATOR_FILES} ${LTO_BARCODE_FILES} ${API_VIEWER_SOURCES}
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	install -m 0644 custom.js custom.css images/proxmox-logo.svg $(BUILDDIR)/html/_static/
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+.PHONY: latexpdf
+latexpdf: ${GENERATED_SYNOPSIS}
+	@echo "Requires python3-sphinx, texlive-xetex, xindy and texlive-fonts-extra"
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through xelatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "xelatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+.PHONY: epub3
+epub3: ${GENERATED_SYNOPSIS}
+	$(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3
+	@echo
+	@echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3."
+
+clean:
+	rm -r -f *~ *.1 ${BUILDDIR} ${GENERATED_SYNOPSIS}
+
+install_manual_pages: man-pages
+	install -dm755 $(DESTDIR)$(MAN1DIR)
+	for i in ${MAN1_PAGES}; do install -m755 ${BUILDDIR}/man/$$i $(DESTDIR)$(MAN1DIR)/ ; done
+	install -dm755 $(DESTDIR)$(MAN5DIR)
+	for i in ${MAN5_PAGES}; do install -m755 ${BUILDDIR}/man/$$i $(DESTDIR)$(MAN5DIR)/ ; done
+
+install_html: html
+	install -dm755 $(DESTDIR)$(DOCDIR)
+	rsync -a ${BUILDDIR}/html $(DESTDIR)$(DOCDIR)
+
+install_pdf: latexpdf
+	install -dm755 $(DESTDIR)$(DOCDIR)
+	install -m 0644 output/latex/ProxmoxOfflineMirror.pdf $(DESTDIR)$(DOCDIR)/proxmox-offline-mirror.pdf
+
+ifneq ($(filter nodoc,$(DEB_BUILD_PROFILES)),)
+
+install: install_manual_pages
+
+else
+
+install: install_manual_pages install_html install_pdf
+
+endif
\ No newline at end of file
diff --git a/docs/_ext/__pycache__/proxmox-scanrefs.cpython-39.pyc b/docs/_ext/__pycache__/proxmox-scanrefs.cpython-39.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..d6ccc5252c0c56f8abda9b5ee779d701d827bab0
GIT binary patch
literal 3722
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

literal 0
HcmV?d00001

diff --git a/docs/_ext/proxmox-scanrefs.py b/docs/_ext/proxmox-scanrefs.py
new file mode 100644
index 0000000..0d62656
--- /dev/null
+++ b/docs/_ext/proxmox-scanrefs.py
@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+
+# debugging stuff
+from pprint import pprint
+
+from typing import cast
+
+import json
+import re
+
+import os
+import io
+from docutils import nodes
+
+from sphinx.builders import Builder
+from sphinx.util import logging
+
+logger = logging.getLogger(__name__)
+
+# refs are added in the following manner before the title of a section (note underscore and newline before title):
+# .. _my-label:
+#
+# Section to ref
+# --------------
+#
+#
+# then referred to like (note missing underscore):
+# "see :ref:`my-label`"
+#
+# the benefit of using this is if a label is explicitly set for a section,
+# we can refer to it with this anchor #my-label in the html,
+# even if the section name changes.
+#
+# see https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-ref
+
+def scan_extjs_files(wwwdir="../www"): # a bit rough i know, but we can optimize later
+    js_files = []
+    used_anchors = []
+    logger.info("scanning extjs files for onlineHelp definitions")
+    for root, dirs, files in os.walk("{}".format(wwwdir)):
+        #print(root, dirs, files)
+        for filename in files:
+            if filename.endswith('.js'):
+                js_files.append(os.path.join(root, filename))
+    for js_file in js_files:
+        fd = open(js_file).read()
+        allmatch = re.findall("(?:onlineHelp:|get_help_tool\s*\()\s*[\'\"](.*?)[\'\"]", fd, re.M)
+        for match in allmatch:
+            anchor = match
+            anchor = re.sub('_', '-', anchor) # normalize labels
+            logger.info("found onlineHelp: {} in {}".format(anchor, js_file))
+            used_anchors.append(anchor)
+
+    return used_anchors
+
+
+def setup(app):
+    logger.info('Mapping reference labels...')
+    app.add_builder(ReflabelMapper)
+    return {
+        'version': '0.1',
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }
+
+class ReflabelMapper(Builder):
+    name = 'proxmox-scanrefs'
+
+    def init(self):
+        self.docnames = []
+        self.env.online_help = {}
+        self.env.online_help['pbs_documentation_index'] = {
+            'link': '/docs/index.html',
+            'title': 'Proxmox Backup Server Documentation Index',
+        }
+        # Disabled until we find a sensible way to scan proxmox-widget-toolkit
+        # as well
+        #self.env.used_anchors = scan_extjs_files()
+
+        if not os.path.isdir(self.outdir):
+            os.mkdir(self.outdir)
+
+        self.output_filename = os.path.join(self.outdir, 'OnlineHelpInfo.js')
+        self.output = io.open(self.output_filename, 'w', encoding='UTF-8')
+
+    def write_doc(self, docname, doctree):
+            for node in doctree.traverse(nodes.section):
+                #pprint(vars(node))
+
+                if hasattr(node, 'expect_referenced_by_id') and len(node['ids']) > 1: # explicit labels
+                    filename = self.env.doc2path(docname)
+                    filename_html = re.sub('.rst', '.html', filename)
+
+                    # node['ids'][0] contains a normalized version of the
+                    # headline.  If the ref and headline are the same
+                    # (normalized) sphinx will set the node['ids'][1] to a
+                    # generic id in the format `idX` where X is numeric. If the
+                    # ref and headline are not the same, the ref name will be
+                    # stored in node['ids'][1]
+                    if re.match('^id[0-9]*$', node['ids'][1]):
+                        labelid = node['ids'][0]
+                    else:
+                        labelid = node['ids'][1]
+
+                    title = cast(nodes.title, node[0])
+                    logger.info('traversing section {}'.format(title.astext()))
+                    ref_name = getattr(title, 'rawsource', title.astext())
+
+                    if (ref_name[:7] == ':term:`'):
+                        ref_name = ref_name[7:-1]
+
+                    self.env.online_help[labelid] = {'link': '', 'title': ''}
+                    self.env.online_help[labelid]['link'] = "/docs/" + os.path.basename(filename_html) + "#{}".format(labelid)
+                    self.env.online_help[labelid]['title'] = ref_name
+
+            return
+
+
+    def get_outdated_docs(self):
+        return 'all documents'
+
+    def prepare_writing(self, docnames):
+        return
+
+    def get_target_uri(self, docname, typ=None):
+        return ''
+
+    def validate_anchors(self):
+        #pprint(self.env.online_help)
+        to_remove = []
+
+        # Disabled until we find a sensible way to scan proxmox-widget-toolkit
+        # as well
+        #for anchor in self.env.used_anchors:
+        #    if anchor not in self.env.online_help:
+        #        logger.info("[-] anchor {} is missing from onlinehelp!".format(anchor))
+        #for anchor in self.env.online_help:
+        #    if anchor not in self.env.used_anchors and anchor != 'pbs_documentation_index':
+        #        logger.info("[*] anchor {} not used! deleting...".format(anchor))
+        #        to_remove.append(anchor)
+        #for anchor in to_remove:
+        #   self.env.online_help.pop(anchor, None)
+        return
+
+    def finish(self):
+        # generate OnlineHelpInfo.js output
+        self.validate_anchors()
+
+        self.output.write("const proxmoxOnlineHelpInfo = ")
+        self.output.write(json.dumps(self.env.online_help, indent=2))
+        self.output.write(";\n")
+        self.output.close()
+        return
diff --git a/docs/_templates/index-sidebar.html b/docs/_templates/index-sidebar.html
new file mode 100644
index 0000000..45e0635
--- /dev/null
+++ b/docs/_templates/index-sidebar.html
@@ -0,0 +1,11 @@
+<h3>Navigation</h3>
+{{ toctree(includehidden=theme_sidebar_includehidden, collapse=True, titles_only=True) }}
+{% if theme_extra_nav_links %}
+<hr />
+<h3>Links</h3>
+<ul>
+    {% for text, uri in theme_extra_nav_links.items() %}
+    <li class="toctree-l1"><a href="{{ uri }}">{{ text }}</a></li>
+    {% endfor %}
+</ul>
+{% endif %}
diff --git a/docs/_templates/sidebar-header.html b/docs/_templates/sidebar-header.html
new file mode 100644
index 0000000..3e07913
--- /dev/null
+++ b/docs/_templates/sidebar-header.html
@@ -0,0 +1,7 @@
+ <p class="logo">
+    <a href="index.html">
+        <img class="logo" src="_static/proxmox-logo.svg" alt="Logo">
+    </a>
+</p>
+<h1 class="logo logo-name"><a href="index.html">Proxmox Offline Mirror</a></h1>
+<hr style="width:100%;">
diff --git a/docs/command-syntax.rst b/docs/command-syntax.rst
new file mode 100644
index 0000000..7fefc0b
--- /dev/null
+++ b/docs/command-syntax.rst
@@ -0,0 +1,13 @@
+Command Syntax
+==============
+
+``proxmox-offline-mirror``
+--------------------------
+
+.. include:: proxmox-offline-mirror/synopsis.rst
+
+
+``proxmox-apt-repo``
+--------------------
+
+.. include:: proxmox-apt-repo/synopsis.rst
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 0000000..e1d9f3c
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,475 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Proxmox Backup documentation build configuration file, originally
+# created by sphinx-quickstart on Tue Feb 26 16:54:35 2019.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+# custom extensions
+sys.path.append(os.path.abspath("./_ext"))
+
+# -- Implement custom formatter for code-blocks ---------------------------
+#
+# * use smaller font
+# * avoid space between lines to nicely format utf8 tables
+
+from sphinx.highlighting import PygmentsBridge
+from pygments.formatters.latex import LatexFormatter
+
+class CustomLatexFormatter(LatexFormatter):
+    def __init__(self, **options):
+        super(CustomLatexFormatter, self).__init__(**options)
+        self.verboptions = r"formatcom=\footnotesize\relax\let\strut\empty"
+
+PygmentsBridge.latex_formatter = CustomLatexFormatter
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+
+extensions = ["sphinx.ext.graphviz", 'sphinx.ext.mathjax', "sphinx.ext.todo", "proxmox-scanrefs"]
+
+todo_link_only = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The encoding of source files.
+#
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = 'Proxmox Offline Mirror'
+copyright = '2022, Proxmox Server Solutions GmbH'
+author = 'Proxmox Support Team'
+
+# The version info for the project you're documenting, acts as a replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+vstr = lambda s: '<devbuild>' if s is None else str(s)
+
+version = vstr(os.getenv('DEB_VERSION_UPSTREAM'))
+# The full version, including alpha/beta/rc tags.
+release = vstr(os.getenv('DEB_VERSION'))
+
+epilog_file = open('epilog.rst', 'r')
+rst_epilog = epilog_file.read()
+rst_epilog += f"\n..  |VERSION| replace:: {version}"
+rst_epilog += f"\n..  |pom-copyright| replace:: Copyright (C) {copyright}"
+
+man_pages = [
+    # CLI
+    ('proxmox-offline-mirror/man1', 'proxmox-offline-mirror', 'Command line tool for Backup and Restore', [author], 1),
+    ('proxmox-apt-repo/man1', 'proxmox-apt-repo', 'Command line tool to manage and configure the backup server.', [author], 1),
+    # configs
+    ('config/mirror/man5', 'mirror.cfg', 'Mirror Configuration', [author], 5),
+]
+
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+#
+# Else, today_fmt is used as the format for a strftime call.
+today_fmt = '%A, %d %B %Y'
+
+suppress_warnings = [ 'toc.excluded' ]
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = [
+    '_build', 'Thumbs.db', '.DS_Store',
+    'epilog.rst',
+    'pbs-copyright.rst',
+]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = not tags.has('release')
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'alabaster'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+html_theme_options = {
+    'fixed_sidebar': True,
+    'sidebar_includehidden': False,
+    'sidebar_collapse': False,
+    'globaltoc_collapse': False,
+    'show_relbar_bottom': True,
+    'show_powered_by': False,
+
+    'extra_nav_links': {
+        'Proxmox Homepage': 'https://proxmox.com',
+        'PDF': 'proxmox-offline-mirror.pdf',
+    },
+
+    'sidebar_width': '320px',
+    'page_width': '1320px',
+    # font styles
+    'head_font_family': 'Lato, sans-serif',
+    'caption_font_family': 'Lato, sans-serif',
+    'caption_font_size': '20px',
+    'font_family': 'Open Sans, sans-serif',
+}
+
+# Alabaster theme recommends setting this fixed.
+# If you switch theme this needs to removed, probably.
+html_sidebars = {
+    '**': [
+        'sidebar-header.html',
+        'searchbox.html',
+        'navigation.html',
+        'relations.html',
+    ],
+
+    'index': [
+        'sidebar-header.html',
+        'searchbox.html',
+        'index-sidebar.html',
+    ]
+}
+
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.
+# "<project> v<release> documentation" by default.
+#
+# html_title = 'Proxmox Backup v1.0-1'
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#
+#html_logo = 'images/proxmox-logo.svg' # replaced by html_theme_options.logo
+
+# The name of an image file (relative to this directory) to use as a favicon of
+# the docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#
+html_favicon = 'images/favicon.ico'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+html_js_files = [
+    'custom.js',
+]
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+#
+# html_extra_path = []
+
+# If not None, a 'Last updated on:' timestamp is inserted at every page
+# bottom, using the given strftime format.
+# The empty string is equivalent to '%b %d, %Y'.
+#
+# html_last_updated_fmt = None
+
+# We need to disable smatquotes, else Option Lists do not display long options
+smartquotes = False
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+#
+# html_domain_indices = True
+
+# If false, no index is generated.
+#
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#
+html_show_sourcelink = False
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'h', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'r', 'sv', 'tr', 'zh'
+#
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# 'ja' uses this config value.
+# 'zh' user can custom change `jieba` dictionary path.
+#
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+#
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'ProxmoxOfflineMirrordoc'
+
+# use local mathjax package, symlink comes from debian/proxmox-backup-docs.links
+mathjax_path = "mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_engine = 'xelatex'
+
+latex_elements = {
+    'fontenc': '\\usepackage{fontspec}',
+
+     # The paper size ('letterpaper' or 'a4paper').
+     #
+     'papersize': 'a4paper',
+
+     # The font size ('10pt', '11pt' or '12pt').
+     #
+     'pointsize': '10pt',
+
+    'fontpkg': r'''
+\setmainfont{Open Sans}
+\setsansfont{Lato}
+\setmonofont{DejaVu Sans Mono}
+''',
+
+     # Additional stuff for the LaTeX preamble.
+     #
+     # 'preamble': '',
+
+     # Latex figure (float) alignment
+     #
+     # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'ProxmoxOfflineMirror.tex', 'Proxmox Offline Mirror Documentation',
+     'Proxmox Support Team', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#
+#
+# Note: newer sphinx 1.6 should be able to convert .svg to .png
+# automatically using sphinx.ext.imgconverter
+latex_logo = "images/proxmox-logo.png"
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+#
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#
+# latex_appendices = []
+
+# It false, will not define \strong, \code, 	itleref, \crossref ... but only
+# \sphinxstrong, ..., \sphinxtitleref, ... To help avoid clash with user added
+# packages.
+#
+# latex_keep_old_macro_names = True
+
+# If false, no module index is generated.
+#
+# latex_domain_indices = True
+
+
+# -- Options for Epub output ----------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+epub_author = author
+epub_publisher = author
+epub_copyright = copyright
+
+# The basename for the epub file. It defaults to the project name.
+# epub_basename = project
+
+# The HTML theme for the epub output. Since the default themes are not
+# optimized for small screen space, using the same theme for HTML and epub
+# output is usually not wise. This defaults to 'epub', a theme designed to save
+# visual space.
+#
+# epub_theme = 'epub'
+
+# The language of the text. It defaults to the language option
+# or 'en' if the language is not set.
+#
+# epub_language = ''
+
+# The scheme of the identifier. Typical schemes are ISBN or URL.
+# epub_scheme = ''
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A tuple containing the cover image and cover page html template filenames.
+#
+# epub_cover = ()
+
+# A sequence of (type, uri, title) tuples for the guide element of content.opf.
+#
+# epub_guide = ()
+
+# HTML files that should be inserted before the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#
+# epub_pre_files = []
+
+# HTML files that should be inserted after the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#
+# epub_post_files = []
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+# The depth of the table of contents in toc.ncx.
+#
+# epub_tocdepth = 3
+
+# Allow duplicate toc entries.
+#
+# epub_tocdup = True
+
+# Choose between 'default' and 'includehidden'.
+#
+# epub_tocscope = 'default'
+
+# Fix unsupported image types using the Pillow.
+#
+# epub_fix_images = False
+
+# Scale large images.
+#
+# epub_max_image_width = 0
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#
+# epub_show_urls = 'inline'
+
+# If false, no index is generated.
+#
+# epub_use_index = True
diff --git a/docs/config/mirror/man5.rst b/docs/config/mirror/man5.rst
new file mode 100644
index 0000000..913b40c
--- /dev/null
+++ b/docs/config/mirror/man5.rst
@@ -0,0 +1,16 @@
+==========
+mirror.cfg
+==========
+
+Description
+===========
+
+The file /etc/proxmox-offline-mirror.cfg is a configuration file for Proxmox
+Offline Mirror. It contains definitions for mirrors, media and subscription keys.
+
+Options
+=======
+
+.. include:: config.rst
+
+.. include:: ../../pom-copyright.rst
diff --git a/docs/configuration-files.rst b/docs/configuration-files.rst
new file mode 100644
index 0000000..fe8cfb4
--- /dev/null
+++ b/docs/configuration-files.rst
@@ -0,0 +1,14 @@
+Configuration Files
+===================
+
+The Proxmox Offline Mirror configuration file is stored at ``/etc/proxmox-offline-mirror.cfg`` by default. Its location can be overriden for any given command using the `--config` parameter.
+
+
+``mirror.cfg``
+~~~~~~~~~~~~~~
+
+
+Options
+^^^^^^^
+
+.. include:: config/mirror/config.rst
diff --git a/docs/custom.css b/docs/custom.css
new file mode 100644
index 0000000..fe8b795
--- /dev/null
+++ b/docs/custom.css
@@ -0,0 +1,88 @@
+div.sphinxsidebar {
+    height: calc(100% - 20px);
+    overflow: auto;
+}
+
+h1.logo-name {
+    font-size: 24px;
+}
+
+div.body img {
+    width: 250px;
+}
+pre {
+    padding: 5px 10px;
+}
+
+div.topic {
+    background-color: #FAFAFA;
+}
+
+li a.current {
+    font-weight: bold;
+    border-bottom: 1px solid #000;
+}
+ul li.toctree-l1 {
+    margin-top: 0.5em;
+}
+ul li.toctree-l1 > a {
+    color: #000;
+}
+
+div.sphinxsidebar ul {
+    color: #444;
+}
+div.sphinxsidebar ul ul {
+    list-style: circle;
+}
+div.sphinxsidebar ul ul ul {
+    list-style: square;
+}
+
+div.sphinxsidebar ul a code {
+    font-weight: normal;
+}
+div.sphinxsidebar ul ul a {
+    border-bottom: 1px dotted #CCC;
+}
+
+div.sphinxsidebar form.search {
+    margin-bottom: 5px;
+}
+
+div.sphinxsidebar h3 {
+    width: 100%;
+}
+
+div.sphinxsidebar h1.logo-name {
+    display: none;
+}
+
+div.document, div.footer {
+    width: min(100%, 1320px);
+}
+
+@media screen and (max-width: 875px) {
+    div.sphinxsidebar p.logo {
+        display: initial;
+    }
+    div.sphinxsidebar h1.logo-name {
+        display: block;
+    }
+    div.sphinxsidebar span {
+        color: #EEE;
+    }
+    .sphinxsidebar ul li.toctree-l1 > a, div.sphinxsidebar a {
+        color: #FFF;
+    }
+    div.sphinxsidebar {
+        background-color: #555;
+    }
+    div.body {
+        min-width: 300px;
+    }
+    div.footer {
+        display: block;
+        margin: 15px auto 0px auto;
+    }
+}
diff --git a/docs/custom.js b/docs/custom.js
new file mode 100644
index 0000000..7964b2c
--- /dev/null
+++ b/docs/custom.js
@@ -0,0 +1,7 @@
+window.addEventListener('DOMContentLoaded', (event) => {
+    let activeSection = document.querySelector("a.current");
+    if (activeSection) {
+        // https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView
+        activeSection.scrollIntoView({ block: 'center' });
+    }
+});
diff --git a/docs/epilog.rst b/docs/epilog.rst
new file mode 100644
index 0000000..b5da481
--- /dev/null
+++ b/docs/epilog.rst
@@ -0,0 +1,19 @@
+.. Epilog (included at top of each file)
+
+   We use this file to define external links and common replacement
+   patterns.
+
+.. |WEBSITE| replace:: https://www.proxmox.com
+.. |DOWNLOADS| replace:: https://www.proxmox.com/downloads
+
+.. _Proxmox: https://www.proxmox.com
+.. _Proxmox Community Forum: https://forum.proxmox.com
+.. _Proxmox Virtual Environment: https://www.proxmox.com/proxmox-ve
+.. _Proxmox Backup: https://pbs.proxmox.com/wiki/index.php/Main_Page
+.. _PVE Development List: https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel
+.. _reStructuredText: https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html
+.. _Rust: https://www.rust-lang.org/
+.. _SHA-256: https://en.wikipedia.org/wiki/SHA-2
+
+.. _AGPL3: https://www.gnu.org/licenses/agpl-3.0.en.html
+.. _Debian: https://www.debian.org
diff --git a/docs/images/favicon.ico b/docs/images/favicon.ico
new file mode 100755
index 0000000000000000000000000000000000000000..ba0c9af606c2766dfd56afa3a49f7e09a700f8fc
GIT binary patch
literal 2336
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
GLSTZE(@<jo

literal 0
HcmV?d00001

diff --git a/docs/images/proxmox-logo.png b/docs/images/proxmox-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..659793ad64fa8704719644e2d05f638d409c897f
GIT binary patch
literal 15899
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
NIVoky8gY}*{|C4aZ&LsO

literal 0
HcmV?d00001

diff --git a/docs/images/proxmox-logo.svg b/docs/images/proxmox-logo.svg
new file mode 100644
index 0000000..bc5d22a
--- /dev/null
+++ b/docs/images/proxmox-logo.svg
@@ -0,0 +1,243 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="800"
+   height="129.03929"
+   id="svg3018"
+   version="1.1"
+   inkscape:version="0.48.3.1 r9886"
+   sodipodi:docname="Proxmox_logo_standard_hex.svg"
+   inkscape:export-filename="S:\Proxmox-Logo-NEW\Standard-Logo\PNG\Proxmox_logo_standard_hex_800px.png"
+   inkscape:export-xdpi="90"
+   inkscape:export-ydpi="90">
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="2.8"
+     inkscape:cx="349.01602"
+     inkscape:cy="64.505265"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="2560"
+     inkscape:window-height="1377"
+     inkscape:window-x="-8"
+     inkscape:window-y="-8"
+     inkscape:window-maximized="1"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     objecttolerance="4"
+     gridtolerance="2"
+     guidetolerance="1"
+     fit-margin-top="5"
+     fit-margin-left="5"
+     fit-margin-right="5"
+     fit-margin-bottom="5"
+     inkscape:showpageshadow="false" />
+  <defs
+     id="defs3020">
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath3102-1">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect3104-7"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath4746">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect4748"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       id="clipPath2999-2-3-4-1"
+       clipPathUnits="userSpaceOnUse">
+      <path
+         inkscape:connector-curvature="0"
+         id="path3001-8-8-6-0"
+         d="m 0,14400 14400,0 L 14400,0 0,0 0,14400 z" />
+    </clipPath>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath3102-4">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect3104-1"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath3008">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect3010"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath3102">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect3104"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath4814">
+      <rect
+         style="fill:#e57000;fill-opacity:1;fill-rule:evenodd;stroke:none"
+         id="rect4816"
+         width="436.40189"
+         height="326.40991"
+         x="-82.999916"
+         y="-347.71387"
+         transform="matrix(0.73449161,0.67861776,-0.78497193,0.61953133,0,0)" />
+    </clipPath>
+    <clipPath
+       id="clipPath2999-2-3-4"
+       clipPathUnits="userSpaceOnUse">
+      <path
+         inkscape:connector-curvature="0"
+         id="path3001-8-8-6"
+         d="m 0,14400 14400,0 L 14400,0 0,0 0,14400 z" />
+    </clipPath>
+  </defs>
+  <metadata
+     id="metadata3023">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     transform="translate(1451.1374,38.932293)"
+     id="layer1"
+     inkscape:groupmode="layer"
+     inkscape:label="Layer 1">
+    <g
+       id="g3378"
+       transform="matrix(0.28026719,0,0,0.28026719,-1040.8325,61.254294)"
+       inkscape:export-filename="S:\lucia\New-Logo-Symbol\Standard-Logo\PNG\Proxmox_logo_standard_hex_300px.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90">
+      <g
+         id="g3016-9"
+         style="fill:#000000"
+         transform="matrix(0.85286594,0,0,0.85286594,-2204.7964,-970.06495)">
+        <g
+           style="font-size:144px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Helion;-inkscape-font-specification:Helion"
+           id="text3093-5"
+           clip-path="url(#clipPath3102-4)"
+           transform="matrix(-0.99791979,0,0,0.99791979,1452.3586,746.04784)">
+          <path
+             d="M 276.30443,226.6231 466.89227,17.020605 C 459.49903,9.6280871 450.88762,3.8194321 441.05796,-0.40537695 431.22756,-4.6295171 420.6664,-6.7823721 409.37437,-6.8639479 397.38099,-6.7722031 386.39328,-4.3959326 376.41123,0.26487096 366.4286,4.9263417 357.75623,11.32398 350.39413,19.457805 L 276.30327,100.37282 202.69985,19.457805 C 195.07335,11.32397 186.19787,4.9263248 176.07344,0.2648493 165.94881,-4.395959 155.00175,-6.7722224 143.2322,-6.8639479 131.93978,-6.7823616 121.3786,-4.629505 111.5486,-0.40536951 101.71855,3.8194345 93.107122,9.6280871 85.714287,17.020605 L 276.30769,226.61752"
+             id="path3098-5"
+             inkscape:connector-curvature="0"
+             sodipodi:nodetypes="ccccccccccccc"
+             style="fill:#000000;fill-opacity:1" />
+        </g>
+        <g
+           transform="matrix(0.99791979,0,0,-0.99791979,900.89604,1230.3576)"
+           clip-path="url(#clipPath3102-4)"
+           id="g3196-9"
+           style="font-size:144px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Helion;-inkscape-font-specification:Helion">
+          <path
+             style="fill:#000000;fill-opacity:1"
+             sodipodi:nodetypes="ccccccccccccc"
+             inkscape:connector-curvature="0"
+             id="path3198-1"
+             d="M 276.30443,226.6231 466.89227,17.020605 C 459.49903,9.6280871 450.88762,3.8194321 441.05796,-0.40537695 431.22756,-4.6295171 420.6664,-6.7823721 409.37437,-6.8639479 397.38099,-6.7722031 386.39328,-4.3959326 376.41123,0.26487096 366.4286,4.9263417 357.75623,11.32398 350.39413,19.457805 L 276.30327,100.37282 202.69985,19.457805 C 195.07335,11.32397 186.19787,4.9263248 176.07344,0.2648493 165.94881,-4.395959 155.00175,-6.7722224 143.2322,-6.8639479 131.93978,-6.7823616 121.3786,-4.629505 111.5486,-0.40536951 101.71855,3.8194345 93.107122,9.6280871 85.714287,17.020605 L 276.30769,226.61752" />
+        </g>
+        <path
+           style="font-size:1059.61279297px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#e57000;fill-opacity:1;stroke:none;font-family:Helion;-inkscape-font-specification:Helion"
+           d="m 1160.6292,988.20538 0,0 -143.2665,-157.11232 c -8.333,-8.88721 -18.03061,-15.87754 -29.09279,-20.97078 -11.06252,-5.09255 -23.02366,-7.68889 -35.88343,-7.78914 -12.33843,0.0892 -23.87792,2.44147 -34.61849,7.05685 -10.74062,4.61613 -20.14972,10.96284 -28.22736,19.04016 L 1034.9383,988.20777 889.54063,1147.9854 c 8.07762,8.3329 17.48674,14.8349 28.22736,19.5062 10.74057,4.6712 22.28006,7.0457 34.61849,7.1234 12.89308,-0.1 24.92073,-2.6962 36.08307,-7.7891 11.16223,-5.0929 20.79325,-12.0833 28.89315,-20.9708 l 143.2662,-157.64917"
+           id="path3278-4"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="cccccccccscscc" />
+        <path
+           sodipodi:nodetypes="cccccccccscscc"
+           inkscape:connector-curvature="0"
+           id="path3280-5"
+           d="m 1192.6208,988.20538 0,0 143.2665,-157.11232 c 8.333,-8.88721 18.0306,-15.87754 29.0928,-20.97078 11.0625,-5.09255 23.0237,-7.68889 35.8834,-7.78914 12.3385,0.0892 23.878,2.44147 34.6185,7.05685 10.7407,4.61613 20.1498,10.96284 28.2274,19.04016 l -145.3977,159.77762 145.3977,159.77763 c -8.0776,8.3329 -17.4867,14.8349 -28.2274,19.5062 -10.7405,4.6712 -22.28,7.0457 -34.6184,7.1234 -12.8931,-0.1 -24.9208,-2.6962 -36.0831,-7.7891 -11.1623,-5.0929 -20.7933,-12.0833 -28.8932,-20.9708 L 1192.6211,988.20593"
+           style="font-size:1059.61279297px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#e57000;fill-opacity:1;stroke:none;font-family:Helion;-inkscape-font-specification:Helion" />
+      </g>
+      <g
+         id="g3368">
+        <g
+           id="text3223"
+           style="font-size:387.52206421px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:Helion;-inkscape-font-specification:Helion">
+          <path
+             inkscape:connector-curvature="0"
+             id="path3354"
+             d="m -686.1811,-262.38737 -177.87034,0 c -6.9834,0.19403 -12.87689,2.71288 -17.68048,7.55658 -4.8036,4.84422 -7.30631,10.85073 -7.50813,18.01955 l 0,245.6858223 c 19.0852,-0.4763289 34.97338,-7.080262 47.6646,-19.8118193 12.69112,-12.731517 19.2789,-28.732724 19.76337,-48.003669 l 135.63098,0 c 19.28682,-0.476261 35.35261,-7.080194 48.19742,-19.811819 12.84432,-12.73145 19.51284,-28.732655 20.00558,-48.003665 l 0,-67.42798 c -0.49274,-19.28682 -7.16125,-35.35262 -20.00557,-48.19744 -12.84482,-12.84432 -28.91061,-19.51283 -48.19743,-20.00556 z m -135.63098,144.15635 0,-75.95335 118.96774,0 c 0.69411,-0.34694 3.47131,0.34736 8.33161,2.08291 4.85991,1.73595 7.63712,6.59605 8.33163,14.58033 l 0,42.23936 c 0.34694,0.7106 -0.34736,3.55238 -2.08291,8.52538 -1.73595,4.97326 -6.59606,7.81505 -14.58033,8.52537 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3356"
+             d="m -308.04521,-143.41963 0,-50.76474 c -0.4766,-19.28682 -7.08053,-35.35262 -19.81182,-48.19744 -12.73179,-12.84432 -28.733,-19.51283 -48.00367,-20.00556 l -177.87034,0 c -7.15293,0.19403 -13.09485,2.71288 -17.82578,7.55658 -4.73095,4.84422 -7.18522,10.85073 -7.36283,18.01955 l 0,245.6858223 c 19.10135,-0.4763289 35.05412,-7.080262 47.85836,-19.8118193 12.80414,-12.731517 19.45651,-28.732724 19.95713,-48.003669 l 0,-17.050751 77.1159,0 39.13922,55.802459 c 6.28082,9.009794 14.16033,16.0819732 23.63854,21.2165595 9.47781,5.1346021 20.06993,7.7503397 31.77641,7.8472208 5.64296,-0.00808 11.11663,-0.6700872 16.42102,-1.9860337 5.30388,-1.3159425 10.29316,-3.2373765 14.96786,-5.7643078 l -54.63991,-77.8909318 c 15.83952,-3.431052 28.82133,-11.197535 38.94546,-23.299469 10.12362,-12.10172 15.3551,-26.55286 15.69445,-43.35347 z m -203.05895,8.13786 0,-58.9026 118.19271,0 c 0.71026,-0.34694 3.55205,0.34736 8.52537,2.08291 4.97294,1.73595 7.81473,6.59605 8.52538,14.58033 l 0,25.57613 c 0.35502,0.69445 -0.35543,3.47166 -2.13135,8.33161 -1.77632,4.86025 -6.74945,7.63746 -14.9194,8.33162 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3358"
+             d="m -66.297193,-262.38737 -135.243457,0 c -19.27095,0.49275 -35.27217,7.16126 -48.00368,20.00558 -12.73156,12.84481 -19.33549,28.91061 -19.81181,48.19742 l 0,135.243464 c 0.47632,19.270945 7.08025,35.272154 19.81181,48.003675 12.73152,12.731561 28.73273,19.3354921 48.00368,19.8118133 l 135.243457,0 C -47.026519,8.3982534 -31.02531,1.7943203 -18.293518,-10.937237 -5.5622279,-23.668754 1.0417033,-39.669961 1.5182953,-58.940906 l 0,-135.243464 c -0.4765997,-19.28682 -7.0805328,-35.35262 -19.8118193,-48.19744 -12.731788,-12.84432 -28.732995,-19.51283 -48.003669,-20.00556 z m 0,186.395713 c 0.355023,0.710536 -0.355427,3.552325 -2.13135,8.525376 -1.776324,4.973203 -6.749453,7.814992 -14.919401,8.525375 l -101.141956,0 c -0.71053,0.355294 -3.55232,-0.355156 -8.52538,-2.13135 -4.97321,-1.776054 -7.815,-6.749182 -8.52537,-14.919401 l 0,-101.529473 c -0.3553,-0.69411 0.35515,-3.47132 2.13134,-8.33162 1.77604,-4.85992 6.74918,-7.63712 14.91941,-8.33162 l 101.141956,0 c 0.710265,-0.34694 3.552054,0.34736 8.525376,2.08291 4.972932,1.73595 7.814721,6.59605 8.525375,14.58033 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3360"
+             style="fill:#e57000;fill-opacity:1"
+             d="m 343.24581,-243.01152 c -5.87764,-5.87708 -12.72377,-10.49499 -20.5384,-13.85374 -7.8152,-3.35821 -16.2114,-5.06974 -25.18861,-5.13459 -9.55093,0.0729 -18.35079,1.96208 -26.3996,5.66744 -8.04928,3.70589 -15.00843,8.79205 -20.87749,15.25848 l -58.51508,64.32783 -58.90259,-64.32783 c -6.02275,-6.63598 -12.96576,-11.77058 -20.82905,-15.40381 -7.86343,-3.6327 -16.550262,-5.47341 -26.060517,-5.52211 -8.977519,0.0649 -17.373714,1.77639 -25.18861,5.1346 -7.814936,3.35874 -14.661064,7.97665 -20.538405,13.85373 L 145.99962,-126.75639 40.207458,-10.501271 c 5.877333,6.0630371 12.723461,10.79396706 20.538405,14.1928038 7.814904,3.398847 16.211099,5.1265285 25.18861,5.1830495 9.381091,-0.072659 18.132507,-1.9618037 26.254287,-5.6674401 8.12163,-3.70562508 15.12923,-8.7917806 21.0228,-15.2584822 l 58.51507,-64.327834 58.51508,64.327834 c 5.86906,6.4667016 12.82821,11.55285519 20.87749,15.2584764 8.04881,3.7056326 16.84867,5.5947793 26.3996,5.6674459 8.97721,-0.056513 17.3734,-1.7841929 25.18861,-5.1830438 7.81464,-3.39884052 14.66077,-8.1297724 20.5384,-14.1928095 L 237.45365,-126.75639 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3362"
+             d="m 695.81803,-262.38737 -42.62688,0 c -13.94281,0.19403 -26.35949,3.97232 -37.25008,11.33487 -10.89107,7.36308 -19.14194,17.14787 -24.75266,29.35442 l 0.38752,-0.77503 -39.91426,87.57886 -39.52674,-87.57886 0,0.77503 c -5.44152,-12.20655 -13.64395,-21.99134 -24.60734,-29.35442 -10.96359,-7.36256 -23.42871,-11.14084 -37.39539,-11.33487 l -42.23936,0 c -7.33862,0.19403 -13.39357,2.71288 -18.16487,7.55658 -4.77131,4.84422 -7.24173,10.85073 -7.41126,18.01955 l 0,245.6858223 c 19.10135,-0.4763289 35.05411,-7.080262 47.85835,-19.8118193 12.80415,-12.731517 19.45652,-28.732724 19.95714,-48.003669 l 0,-129.818224 c 0.0241,-1.76784 0.55699,-3.17259 1.59851,-4.21425 1.04138,-1.04125 2.44613,-1.57408 4.21425,-1.5985 1.00908,0.0325 1.99402,0.35542 2.95482,0.96878 0.96064,0.61377 1.65494,1.32422 2.0829,2.13135 l 75.17831,165.857313 c 1.42074,2.962919 3.51979,5.368749 6.29715,7.217496 2.77705,1.848803 5.84489,2.801451 9.20353,2.857948 3.33409,-0.04034 6.35349,-0.928394 9.05821,-2.664177 2.70436,-1.73573 4.85185,-4.076977 6.44248,-7.02375 l 75.17831,-166.24483 c 0.58909,-0.80712 1.34797,-1.51757 2.27666,-2.13135 0.92817,-0.61337 1.97769,-0.9363 3.14858,-0.96878 1.5821,0.0244 2.87382,0.55726 3.87517,1.59851 1.00081,1.04165 1.5175,2.4464 1.55007,4.21424 l 0,129.818224 c 0.50027,19.270945 7.15264,35.272154 19.95712,48.003675 12.8039,12.731561 28.75667,19.3354921 47.85836,19.8118133 l 0,-245.6858223 c -0.17794,-7.16882 -2.63221,-13.17533 -7.36282,-18.01955 -4.73127,-4.8437 -10.67319,-7.36255 -17.82578,-7.55658 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3364"
+             d="m 963.0584,-262.38737 -135.24346,0 c -19.27095,0.49275 -35.27216,7.16126 -48.00368,20.00558 -12.73156,12.84481 -19.33549,28.91061 -19.81181,48.19742 l 0,135.243464 c 0.47632,19.270945 7.08025,35.272154 19.81181,48.003675 12.73153,12.731561 28.73273,19.3354921 48.00368,19.8118133 l 135.24346,0 c 19.27067,-0.4763289 35.27188,-7.080262 48.0037,-19.8118193 12.7313,-12.731517 19.3352,-28.732724 19.8118,-48.003669 l 0,-135.243464 c -0.4766,-19.28682 -7.0805,-35.35262 -19.8118,-48.19744 -12.73182,-12.84432 -28.73303,-19.51283 -48.0037,-20.00556 z m 0,186.395713 c 0.35502,0.710536 -0.35543,3.552325 -2.13135,8.525376 -1.77633,4.973203 -6.74946,7.814992 -14.9194,8.525375 l -101.14196,0 c -0.71053,0.355294 -3.55232,-0.355156 -8.52538,-2.13135 -4.97321,-1.776054 -7.815,-6.749182 -8.52537,-14.919401 l 0,-101.529473 c -0.35529,-0.69411 0.35515,-3.47132 2.13134,-8.33162 1.77604,-4.85992 6.74918,-7.63712 14.91941,-8.33162 l 101.14196,0 c 0.71026,-0.34694 3.55205,0.34736 8.52537,2.08291 4.97293,1.73595 7.81472,6.59605 8.52538,14.58033 z" />
+          <path
+             inkscape:connector-curvature="0"
+             id="path3366"
+             style="fill:#e57000;fill-opacity:1"
+             d="m 1372.6013,-243.01152 c -5.8777,-5.87708 -12.7238,-10.49499 -20.5384,-13.85374 -7.8152,-3.35821 -16.2114,-5.06974 -25.1886,-5.13459 -9.551,0.0729 -18.3508,1.96208 -26.3996,5.66744 -8.0493,3.70589 -15.0085,8.79205 -20.8775,15.25848 l -58.5151,64.32783 -58.9026,-64.32783 c -6.0227,-6.63598 -12.9658,-11.77058 -20.829,-15.40381 -7.8635,-3.6327 -16.5503,-5.47341 -26.0606,-5.52211 -8.9775,0.0649 -17.3737,1.77639 -25.1886,5.1346 -7.8149,3.35874 -14.661,7.97665 -20.5384,13.85373 l 105.7922,116.25513 -105.7922,116.255119 c 5.8774,6.0630371 12.7235,10.79396706 20.5384,14.1928038 7.8149,3.398847 16.2111,5.1265285 25.1886,5.1830495 9.3811,-0.072659 18.1326,-1.9618037 26.2543,-5.6674401 8.1217,-3.70562508 15.1293,-8.7917806 21.0228,-15.2584822 l 58.5151,-64.327834 58.5151,64.327834 c 5.869,6.4667016 12.8282,11.55285519 20.8775,15.2584764 8.0488,3.7056326 16.8486,5.5947793 26.3996,5.6674459 8.9772,-0.056513 17.3734,-1.7841929 25.1886,-5.1830438 7.8146,-3.39884052 14.6607,-8.1297724 20.5384,-14.1928095 L 1266.8091,-126.75639 z" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 0000000..9284f8b
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,47 @@
+.. Proxmox Backup documentation master file
+
+Welcome to the Proxmox Offline Mirror documentation!
+====================================================
+| |pom-copyright|
+| Version |version| -- |today|
+
+Permission is granted to copy, distribute and/or modify this document under the
+terms of the GNU Free Documentation License, Version 1.3 or any later version
+published by the Free Software Foundation; with no Invariant Sections, no
+Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included
+in the section entitled "GNU Free Documentation License".
+
+
+.. only:: html
+
+ A `PDF` version of the documentation is `also available here <./proxmox-offline-mirror.pdf>`_
+
+.. toctree::
+   :maxdepth: 3
+   :caption: Table of Contents
+
+   introduction.rst
+
+.. raw:: latex
+
+   \appendix
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Appendix
+
+   command-syntax.rst
+   configuration-files.rst
+   GFDL.rst
+
+.. only:: html and devbuild
+
+    .. toctree::
+       :maxdepth: 2
+       :hidden:
+       :caption: Developer Appendix
+
+       todos.rst
+
+
+.. # * :ref:`genindex`
diff --git a/docs/introduction.rst b/docs/introduction.rst
new file mode 100644
index 0000000..8472ed9
--- /dev/null
+++ b/docs/introduction.rst
@@ -0,0 +1,149 @@
+Introduction
+============
+
+What is Proxmox Offline Mirror?
+-------------------------------
+
+This tool consists of two binaries, `proxmox-offline-mirror` (mirror tool to create
+and manage mirrors and media containing repositories) and `proxmox-apt-repo`
+(helper to use media on offline systems).
+
+There are two basic entity types available for configuration:
+- mirrors, consisting of upstream repository metadata and a local path where snapshots are stored
+-- configured with `proxmox-offline-mirror config mirror ...`
+-- used with `proxmox-offline-mirror mirror ...`
+- media, consisting of local mirrors and a path where mirrors are synced to
+-- configured with `proxmox-offline-mirror config medium ...`
+-- used with `proxmox-offline-mirror medium ...`
+
+and one internal one, a `pool` consisting of
+- a pool directory containing checksum files (e.g., `sha256/3dc7bc5f82cdcc4ea0f69dd30d5f6bb19e0ccc36f4a79c865eed0e7a370cd5e4`)
+- a base directory containing directories and hardlinks to checksum files inside the pool directory
+
+Adding a file consists of first adding the checksum file(s), then linking them
+under one or more paths. a garbage collect operation will iterate over all
+files in the base directory and remove those which are not (or no longer) a
+hardlink to any checksum files, and remove any checksum files which have no
+hardlinks outside of the pool checksum file directories.
+
+A default config path of `/etc/proxmox-offline-mirror.cfg` is used, but is
+overridable on a per command basis (for example, to allow operation as non-root
+user).
+
+Setting up a mirror
+-------------------
+
+First either run the `setup` wizard (`proxmox-offline-mirror setup`), or the
+`config mirror add` command. For example, to add a mirror entry for the Debian
+Bullseye security repository, the following command can be used:
+
+ proxmox-offline-mirror config mirror add \
+  --id debian-bullseye-security \
+  --architectures amd64 \
+  --architectures all \
+  --repository 'deb http://deb.debian.org/debian-security bullseye-security main contrib non-free' \
+  --key-path /etc/apt/trusted.gpg.d/debian-archive-bullseye-security-automatic.gpg \
+  --sync true \
+  --verify true \
+  --base-dir /path/to/mirror/dir/debian-bullseye-security \
+  --pool-dir /path/to/mirror/dir/debian-bullseye-security/.pool
+
+Syncing a mirror
+----------------
+
+To create the first (and subsequent) snapshots, the following command can be used:
+
+ proxmox-offline-mirror mirror snapshot create --id debian-bullseye-security
+
+Setting up a medium
+-------------------
+
+Either run the `setup` wizard again, or use the `config medium add` command.
+For example, to define a new medium containing the
+`proxmox-ve-bullseye-no-subscription` and `debian-bullseye` mirrors, run the
+following command:
+
+ proxmox-offline-mirror config medium add \
+  --id pve-bullseye \
+  --mirrors proxmox-ve-bullseye-no-subscription \
+  --mirrors debian-bullseye \
+  --sync true \
+  --verify true \
+  --mountpoint /path/where/medium/is/mounted
+
+Syncing a medium
+----------------
+
+To sync the local mirrors to a medium, the following command can be used:
+
+ proxmox-offline-mirror medium sync --id pve-bullseye
+
+Using a medium
+--------------
+
+After syncing a medium, unmount it and make it accessible on the (offline)
+target system. You can now either manually point apt at the synced snapshots,
+or run `proxmox-apt-repo setup` to generate a sources.list.d snippet referecing
+selected mirrors and snapshots. Don't forget to remove the snippet again after
+the upgrade is done.
+
+
+.. _get_help:
+
+Getting Help
+------------
+
+.. _get_help_enterprise_support:
+
+Enterprise Support
+~~~~~~~~~~~~~~~~~~
+
+Users with a `Proxmox Offline Mirror Basic, Standard or Premium Subscription Plan
+<https://www.proxmox.com/en/proxmox-offline-mirror/pricing>`_ have access to the
+`Proxmox Customer Portal <https://my.proxmox.com>`_. The customer portal
+provides support with guaranteed response times from the Proxmox developers.
+For more information or for volume discounts, please contact office@proxmox.com.
+
+Community Support Forum
+~~~~~~~~~~~~~~~~~~~~~~~
+
+We always encourage our users to discuss and share their knowledge using the
+`Proxmox Community Forum`_. The forum is moderated by the Proxmox support team.
+The large user base is spread out all over the world. Needless to say that such
+a large forum is a great place to get information.
+
+Mailing Lists
+~~~~~~~~~~~~~
+
+Proxmox Offline Mirror is fully open-source and contributions are welcome! Here
+is the primary communication channel for developers:
+
+:Mailing list for developers: `PVE Development List`_
+
+Bug Tracker
+~~~~~~~~~~~
+
+Proxmox runs a public bug tracker at `<https://bugzilla.proxmox.com>`_. If an
+issue appears, file your report there. An issue can be a bug, as well as a
+request for a new feature or enhancement. The bug tracker helps to keep track
+of the issue and will send a notification once it has been solved.
+
+License
+-------
+
+|pom-copyright|
+
+This software is written by Proxmox Server Solutions GmbH <support@proxmox.com>
+
+Proxmox Backup Server is free and open source software: you can use it,
+redistribute it, and/or modify it under the terms of the GNU Affero General
+Public License as published by the Free Software Foundation, either version 3
+of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+``WITHOUT ANY WARRANTY``; without even the implied warranty of
+``MERCHANTABILITY`` or ``FITNESS FOR A PARTICULAR PURPOSE``.  See the GNU
+Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see AGPL3_.
\ No newline at end of file
diff --git a/docs/pom-copyright.rst b/docs/pom-copyright.rst
new file mode 100644
index 0000000..86e9434
--- /dev/null
+++ b/docs/pom-copyright.rst
@@ -0,0 +1,18 @@
+Copyright and Disclaimer
+========================
+
+|pom-copyright|
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public
+License along with this program.  If not, see
+http://www.gnu.org/licenses/
diff --git a/docs/proxmox-apt-repo/description.rst b/docs/proxmox-apt-repo/description.rst
new file mode 100644
index 0000000..f0c7185
--- /dev/null
+++ b/docs/proxmox-apt-repo/description.rst
@@ -0,0 +1,2 @@
+This tool serves as a helper to streamline usage of a mirrored offline APT
+repository and offline subscription keys.
\ No newline at end of file
diff --git a/docs/proxmox-apt-repo/man1.rst b/docs/proxmox-apt-repo/man1.rst
new file mode 100644
index 0000000..e68a584
--- /dev/null
+++ b/docs/proxmox-apt-repo/man1.rst
@@ -0,0 +1,16 @@
+================
+proxmox-apt-repo
+================
+
+Synopsis
+==========
+
+.. include:: synopsis.rst
+
+Description
+============
+
+.. include:: description.rst
+
+
+.. include:: ../pom-copyright.rst
diff --git a/docs/proxmox-offline-mirror/description.rst b/docs/proxmox-offline-mirror/description.rst
new file mode 100644
index 0000000..69c4b29
--- /dev/null
+++ b/docs/proxmox-offline-mirror/description.rst
@@ -0,0 +1,2 @@
+This tool allows registering and updating offline subscription keys, and
+configuring and managing offline APT repository mirrors and media.
\ No newline at end of file
diff --git a/docs/proxmox-offline-mirror/man1.rst b/docs/proxmox-offline-mirror/man1.rst
new file mode 100644
index 0000000..2127b40
--- /dev/null
+++ b/docs/proxmox-offline-mirror/man1.rst
@@ -0,0 +1,16 @@
+======================
+proxmox-offline-mirror
+======================
+
+Synopsis
+==========
+
+.. include:: synopsis.rst
+
+Description
+============
+
+.. include:: description.rst
+
+
+.. include:: ../pom-copyright.rst
diff --git a/docs/todos.rst b/docs/todos.rst
new file mode 100644
index 0000000..07f44ab
--- /dev/null
+++ b/docs/todos.rst
@@ -0,0 +1,6 @@
+Documentation Todo List
+=======================
+
+This is an auto-generated list of the todo references in the documentation.
+
+.. todolist::
diff --git a/src/bin/docgen.rs b/src/bin/docgen.rs
new file mode 100644
index 0000000..876222d
--- /dev/null
+++ b/src/bin/docgen.rs
@@ -0,0 +1,31 @@
+use anyhow::{bail, Error};
+use proxmox_offline_mirror::config;
+
+use proxmox_section_config::dump_section_config;
+
+fn get_args() -> (String, Vec<String>) {
+    let mut args = std::env::args();
+    let prefix = args.next().unwrap();
+    let prefix = prefix.rsplit('/').next().unwrap().to_string(); // without path
+    let args: Vec<String> = args.collect();
+
+    (prefix, args)
+}
+
+fn main() -> Result<(), Error> {
+    let (_prefix, args) = get_args();
+
+    if args.is_empty() {
+        bail!("missing arguments");
+    }
+
+    for arg in args.iter() {
+        let text = match arg.as_ref() {
+            "mirror.cfg" => dump_section_config(&config::CONFIG),
+            _ => bail!("docgen: got unknown type"),
+        };
+        println!("{}", text);
+    }
+
+    Ok(())
+}
\ No newline at end of file
diff --git a/src/config.rs b/src/config.rs
index 42705a8..44c4ca1 100644
--- a/src/config.rs
+++ b/src/config.rs
@@ -176,7 +176,7 @@ impl SubscriptionKey {
 }
 
 lazy_static! {
-    static ref CONFIG: SectionConfig = init();
+    pub static ref CONFIG: SectionConfig = init();
 }
 
 fn init() -> SectionConfig {