asciidoc: minimally update derived docbook conf templates to work with python333

(ported from cf7a2acc3069a7b4974ff41411ee232afb29a9a1 in pve-docs)

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

fixup heading markers

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

installation language fix-up

Improve spelling, grammar, readability, etc.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

planning deployment - language fix-up

Improve spelling, grammar, readability, etc.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

introduction language fix-up

Improve spelling, grammar, readability, etc.

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

replace "e-mail" with "email"

in accordance with our technical writing guide

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

bump version to 6.4-1

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update schema/static information

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

certs: minor stylistic improvements

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

bump version to 6.3-3

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

run make update

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

asciidoc-pmg: scan extjs: make onlineHelp struct a const

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

asciidoc-pmg: scan extjs: also find onlineHelpTool references

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

certs: further typo/lang fixes and residual s/pve/pmg/ cleaning

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

certs: pmg uses fingerprint pinning

the patch also addresses small stylistic nits.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

improve formatting overly short lines

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

certs: document new ACME implementation, move to configuration section

Based on the documentation of PVE.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

Change 'Gmbh' to 'GmbH'

Signed-off-by: Dylan Whyte <d.whyte@proxmox.com>

bump version to 6.3-2

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

backup: shortly document #3146 and #3154

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

backup: add anchors to pbs sections

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

backup: fix typos

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

bump version to 6.3-1

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

fixup line length and content

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

administration: add a basic explanation about personal quarantine

and mention the new quarantine link option.

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>

run make update for static/schema definitions

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pmgbackup: add scrots, followup fixes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add short documentation on PBS backups

This patch adds a short documentation for the PBS integration in PMG.
It aims to provide a very terse walkthrough the newly created pmgbackup
subcommands.

updated screenshot (and the newly referenced one) will be provided off-list
due to their size.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

correct small typo in pmgbackup.adoc

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

installation: don't mention ext3 as an option anymore

Support for ext3 was removed by commit 0abf0d3683b74421eca24ba61d1d4e100d35211a
in pve-installer.

Signed-off-by: Fabian Ebner <f.ebner@proxmox.com>

followup: s/html/HTML/ and some nits

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

expand docs for adding a disclaimer

The part with the matching encodings is not straight-forward to debug, so at
least document it.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

expan how to install rar support with commands

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

drop blank lines at EOF

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add documentation for RAR support

While clamav and our stack do support handling RAR archives, both need
packages from `non-free` installed in order to work.

Adding the 2 packages to the appropriate places would still
require a reference to the sources.list entry of how to get the `non-free`
archive area enabled and that way we can reference one place to answer how
to enable RAR support

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

local users: add missing Helpdesk role

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

local users: reformat

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

bump version to 6.2-2

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add pmg specifics to resolv.conf documentation

The documentation of '/etc/resolv.conf' and '/etc/hostname' should mention
the specifics of PMG (their content is used to create variables used in
the postfix configuration

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

close #2449: clarify DNSBL check in SMTP Whitelist

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>

asciidoc-pmg: ignore link targets for non-manpages

(This is taken from pve-docs commit
7de8bba68de1875aca04ebd1cd941a2992c24753)

To allow linking from to a chapter/section not included in a manpage
allow the manpage link resolver to just return text in a case the
link target text is in fact no manpage.

If the link is a valid one in general will be checked in a lot of
other places, so here we won't run into a regression where a wrong,
non-existing, link does not get detected by the build system.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
Originally-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add white- and blacklist clarification

The difference between the 3 whitelists and 2 blacklists is not
explained anywhere in the docs and leads to confusion all the time.
To improve this situation add an overview over the different white- and
blacklists explaining at which level and how they work.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>

postfix queue admin: add screenshots and a bit of details

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

queue admin: followup fixes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

MailTracker - remove special case for before-queue

Since we've recently added dedicated before-queue status to pmg-log-tracker
the MailTracker should treat before and after queue filtered mail equally.

This patch drops the note stating otherwise.
Additionally the line with 'queued/delivered' was left in place, since the
status does exist (as with the other 'queued' status mails it happens for
internally generated mails).

This commit partially reverts 6abb9ee31568c3828ab83fa8ec264d90fffe7dd1

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

add minimal queue administration docs

describe the buttons and their functions with the most common usage.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

install: move media preparation before wizard

As in the PVE docs, move the boot media preparation chapter in front of
the installation wizard one. Changes to the text were taken from the PVE
docs and adapted.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

install: usb: use updated instructions from PVE

The instructions for a bootable USB flash drive in the PVE docs have
been worked on to improve the phrasing and cover current tools for
Windows which we also want in the PMG docs.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>

bump version to 6.2-1

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

followup fixup

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

intro: user management: document Helpdesk role

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

intro: small wording fix

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

intro: add section about Web-based Management Interface

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

some indentation / textwidth fixes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

html TOC: add "back to index" link

use a unicode symbol for the back arrow, should nowadays be widely
available

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update screenshots

represents mainly new user logout/language button on the top right.

screenshot selenium scripts got improved to have more forms filled
out and allow doing them more automated but also allowing to mirror a
more realistic setup.

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

intro: fix rendering of greylist chunk

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update static/schema data

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pmgconfig: grammar, phrasing and typo fixes

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

prefer apt over apt-get, fix CT appliance section

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pmg-installation: minor fixups and rephrase some parts

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

add rust lang footnote

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

pmg-administration: grammar, phrasing, typos and outdated info

tracking center backend is now in rust instead of c

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>

Drop note for before-queue filtering

with the upcoming PMG 6.2 release before queue filtering is configurable via
GUI - drop the note, that it has to be manually added to pmg.conf

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

add a section on greylisting to pmgconfig.adoc

While we mention greylisting as available feature in pmgintro.adoc, we
should also document a few more technical details of its workings
in PMG (e.g. how long a seen triple is kept before expiring).

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

pmg-mail-filter: grammar, typo, phrasing fixes

also change a confusing example in the regex guide

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>

pmgproxy: simplify ciphers order/honor description

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

important service daemons: fix typos and grammar

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

pmg-ssl-certificate: typos and {pmg} instead of Proxmox

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

pmg-faq: minor typos and grammar fixes

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

useful cli tools: fix typos and grammar

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

pmgcm: typos, grammar and rephrasing fixups

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

rephrase before/after queue filtering for clarity

starting the listing with before/after queue filtering makes it easier to
scan through the document, especially if we refer to it with the same words
below.

Huge thanks to Daniela for suggesting the edit.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

pmg-planning-deployment: minor fixups in grammar and understandability

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

greylisting: wording and drop dubious 50% number

best viewed with
git show --word-diff=color

I mean possibly it was inteded to be marketing speach, but it's not
really relatable where it comes from; and we mention reduced load and
such already

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

rephrase greylisting section in pmg-intro

and mention that the netmask for greylisting is configurable

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

pmg-intro: minor grammar and structure fixes

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>
Reviewed-By: Aaron Lauterer <a.lauterer@proxmox.com>

bump version to 6.1-5

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add new greylist params gen-pmg.conf.5.-opts.pl

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

add description of Match Archive Filename

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

improve explanation of Archive Filter

also mention that it matches regular attachments content-types

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

clarify tracking center docs for before-queue

In the after-queue case we get 2 QEntrys from the pmg-log-tracker when
the mail is accepted. One serves as a relay and provides the delivery
status. In the before-queue case we only have 1 QEntry and no extra delivery
status. This results in before-queue accepted mails being shown as
'queued/accepted' instead of 'accepted/<status>'.

As the tracking center shows 'queued/accepted', mention this combination
in the docs and clarify that it only happens in the before-queue
filtering case.

Signed-off-by: Mira Limbeck <m.limbeck@proxmox.com>

move various links from http to https

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update nmap example, link also to online doc

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

add support for next-hop TLS destination

Adapt the documentation for TLS Destination policies to mention next-hop
destinations defined in the transport table. Support for this was introduced
with the fix for #1948.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

fix description of spam level in what object

The sentence was the wrong way around (and had a typo), which
led to confusion for some users.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>

bump version to 6.1-4

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update static

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

api-viewer: port over search, expand/collapse all & deeplink from PVE

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

api-viewer: whitespace, indentation and typo fixes

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

adapt toc2 and more responsive style changes from PVE

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

bump version to 6.1-3

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

gen-pmg.conf.5: allow to overwrite undocumented key error for bootstrapping

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

gen-pmg.conf.5-opts: drop unused Data::Dumper

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

gen-pmg.conf.5-opts: whitespace cleanup

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

Feature #2438 add support for lmtp delivery to downstream servers

new feature lmtp support for simplifying setups with lmtp capable
downstream servers (e.g. dovecot) Postfix support lmtp out of the box
and can now deliver mails directly to internal mailbox servers
without one more smtp connection

extending the documentation for new lmtp option in
MailProxyConfiguration and MailProxyConfiguration:Transport

Signed-off-by: Julian Zehnter <pmg-devel@j-z.it>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>
Tested-By: Stoiko Ivanov <s.ivanov@proxmox.com>

put login-window screenshot inside paragraph

with the recent change of including the screenshots with the
thumbnail attribute, the login-window screenshot was not rendered anymore

This happened because it was included directly above a list environment,
where the thumbnail attribute was not defined.

Additionally the big attribute was dropped.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

bump version to 6.1-2

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update static schema/synopsis definitions

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

update installer scrots, add summary one

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>