installation: fix codeblock rendering in zfs performance tips section

That slipped through, asciidoc uses 4 not 3 dashes for that.

Fixes: c8be3f0 ("installation: align zfs performance tip with PVE documentation")
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

bump version to 8.1.1

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

update various screenshots

lots of them where made with PMG 6.2, and while we had no huge revamp,
there are quite some small to mid sized changes and improvements all
over the place, so update a few that show such changes and where easy
to regenerate quickly.

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

installation: reword/expand/reflow and fix login thumbnail

Try to improve the layout, still not really ideal with that many
thumbnails in a single relatively short section but should be a bit
easier to read.

Change the place of the UI login thumbnail as before the numerical
bulletin point list it won't work due to block boundaries and asciidoc

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

screenshots: update dashboard and login screenshots

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

screenshots: regenerate installer screenshots with smaller border

to avoid ugly blocking looking images that distract from the actual
content.

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

verify-images: include the file name that failed verification

so that it might actually be useful..

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

buildsys: make verify-images target informative only

The PDF and the HTML are rendered fine anyway, this is just a PITA

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

doc-generator: add new option dkim-use-domain

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

dkim: rephrase signing-domain source docs

mostly to mention the 2 terms RFC5321.MailFrom and RFC5322.From
actually used in the dmarc-rfc for both terms.

additionally rephrase the link phrase from smtp_rfc to rfc_5321 (there
are at least 3 rfcs titled SMTP)

fix 1 small typo.

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

dkim: document dkim-use-domain

Signed-off-by: Maximiliano Sandoval <m.sandoval@proxmox.com>
[S.I.: fix spelling of dkim-use-domain]
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

bump version to 8.1.0

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

update static schema info

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

asciidoc: make thumbnail path relative to images/

This in turn allows to also use images from other subdirectories, e.g.
`images/installer/`, and not just from `images/screenshot/`.

Replacing all paths was done mechanically using:

  sed -i 's/thumbnail="pmg-gui/thumbnail="screenshot\/pmg-gui/g' *.adoc

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

images: run png-cleanup.pl on all and verify on install

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

installation: add a TUI installer screenshot

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

installation: convert installer screenshots to thumbnails

Again, like the PVE documantation. Improves the reading flow quite a bit
too.

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

installation: add `nomodeset` kernel parameter tip for bogus graphics

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

installation: align zfs performance tip with PVE documentation

This one is IMO better worded, so just use that.

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

installation: update chapter based on PVE docs & new GRUB entries

The new release also brings things such a the serial console
installer and a expandend 'Advanced Options' menu.

This mostly aligns it with the respective documentation from PVE,
rewording some things and adding some {NOTE,TIP,WARNING}s from there as
well.

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

images: update GRUB menu screenshot to latest release

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

gitignore: add initial file based on pve-docs

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>

docs: pmgconfig: fix path to transport file

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

admin: system-booting: add screenshots

additionally adapt the paths for pmg with:
sed -ri 's/screenshot\///g' system-booting.adoc

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

admin: include system-booting docs

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

admin: system-booting: replace pve with pmg automatically

the result looks correct, and using sed might help in case the
pve-docs get updated:

sed -ri 's/([^-])pve([^.])/\1pmg\2/g;
    /^ifdef::wiki\[\]/,/^endif::wiki\[\]/d' system-booting.adoc

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

admin: system-booting: copy system-booting.adoc from pve-docs

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

update static schema info

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

bump version to 8.0.2

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

update static schema info

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

d/copyright: update years

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

add disclaimer position/separator docs

explain what the default is and that it can be configured.

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

update static schema info

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

doc-generator: add new option filter-timeout

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

rule system: explain new and mode and invert flag

and adding that the previous behaviour is now the default.

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

rule system: add a small section about matching rules

this section explains how multiple object categories and multiple
objects interact with the rule matching.

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

Fix wrong usage of GiB for disksizes

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

administration, installation: add chapter "Firmware Updates"

and "Debian Firmware Repository", with mutual linking. Largely
identical to PVE docs, except for:
- remove mentions of ensuring a safe cluster node reboot
- adapt internal links for this doc structure

Firmware updates are important, their existence should not be checked
only when there are already noticeable problems.

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>

installation: rephrase section "Other Repository Sources"

to be Debian release independent & conform to additional repo sections

Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>

Consistency of GB and GiB pmg

Since the actual system-checks are done in GiB and to stay consistent
with the other docs, change all GB units to GiB

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>

Fix spelling of command line/command-line

Commandline/command line/command-line where being used interchangeably,
which is not correct
(see: https://learn.microsoft.com/en-us/style-guide/a-z-word-list-term-collections/c/command-line).
use command-line when it is an adjective (e.g. "command-line interface")
and use command line when it is a noun (e.g. "change the setting from
the command line")

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>
[S.I.: fix a stray ' ' introduced with this commit]
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

Consistency of USB flash drive spelling

To be consistent, replaced all synonyms of USB flash drive (e.g. thumb
drive, drive, stick)

Signed-off-by: Noel Ullreich <n.ullreich@proxmox.com>

update external links to www.proxmox.com

During the redesign of www.proxmox.com the menu structure and therefore
some url changed. Update the external link in order to avoid an
unneccessary redirect.

Signed-off-by: Christian Ebner <c.ebner@proxmox.com>

faq: update support table

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

bump version to 8.0.1

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

run make update

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

installation: update repo suites and APT key checksums for bookworm

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

bump version to 8.0.0

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

d/control: add hint w.r.t. pve-common/pmg-api B-D

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

d/control: drop lintian from build-dependcies

we don't use it for building the package, and what's happening
afterwards isn't really the task of d/control to enforce.

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

buildsys: drop bogus and unused NOVIEW variable

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

buildsys: only get git revision if actually used

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

buildsys: drop unused PKGREL variable

we rely on d/changelog through the dpkg makefile fragments helper
since a while..

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

d/control: ensure docs are build with compatible asciidoc

follows pve-docs' 393cdae ("d/control: ensure docs are build with
compatible asciidoc")

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

buildsys: derive upload dist automatically

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

asciidoc config: work around missing icon bug

This follows commit
ba6ea595629b20adbfc8241b9a2d20aa14c338f3
from pve-docs.
and addresses [0].

[0]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1036030#10

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/source: override false-positive lintian errors

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/copyright: use machine readable format

taken from 1c894423cf56b2c8d4fc7be75a6847ecaf6b10c3
in pve-docs

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/control: raise standards version compliance to 4.6.2

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/control: define compat level via build-depends and raise to 13

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

mark pmg-doc-generator an arch-independent package

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/control: add missing ${misc:Depends}

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/control: add rsync as build dependency

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

buildsys: add DSC target

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

buildsys: improve build dir generation and cleanup

follows commit 67f4cd3b44ddb0e8525d094188e56e41bc669cd4
in pve-docs for consistency

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

d/souce/format: mark package as native

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

makefile: convert to use simple parenthesis

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

track pmg.admin-dkim-conf-opts.adoc to avoid pmg-api dependency on package build

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

config: fix link to whitelist configuration

previously this linked to the options section, this was misleading and
lead users to miss the smtp whitelist configuration section. linking
the correct section here also makes it clearer that these settings
refer to the smtp whitelist.

Signed-off-by: Stefan Sterz <s.sterz@proxmox.com>

buildsys: upload to bullseye

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

bump version to 7.3-2

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

stats: add references for online help

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

stats: add screenshots and expand a bit

only show the ones with a lot of content filling the panel big, but
add a bit of content to improve the remaining layout and crowding of
the thumbnails.

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

stats: some grammar layout and content additions/adaptions

note that much less changed that it seems from a line-based git use
git show --word-diff=color --word-diff-regex='\w+' to see actual
change.

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

update static schema info

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

administration: add section for statistics

by explaining each panel and it's options

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

config: add reference to postfix postconf

so that the users can find the place where the options are described

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

bump version to 7.3-1

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

update static schema info

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

doc-generator: add new option smtputf8

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

docs: add dark mode support to the api viewer

adds dark mode support to the api viewer that is activated depending
on the users theme preference. similar to the main gui's "auto"
theme.

this needs a bump of the widget toolkit so the dark-theme css is
present.

Signed-off-by: Stefan Sterz <s.sterz@proxmox.com>

conf: add support for a dark mode in the documentation

this commit adds support for a dark theme that behaves similarly to
that one used by the api viewer.

Signed-off-by: Stefan Sterz <s.sterz@proxmox.com>

pmgconfig: Explain new TLS inbound domains configuration

Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
 [ S.I.: mention that the setting is only on the external port ]
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

pmgqm: slightly reword OnCalendar override instructions

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

pmgqm: add example for systemd.timer edit

The resetting of OnCalendar can be a bit confusing for users, who are
not familiar with the intricacies of systemd overrides.
Add a simple example to address a common use-case, and point to the
relevant man pages for more details.

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

bump version to 7.2-1

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

update static schema info

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

update static schema info

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

fix capitalization of GmbH

Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>

fix #4265: nmap: suggest usin -Pn over depreacated -P0

While, unlike the report suggests, they're currently (nmap 7.91 from
Bullseye) *exactly* the same, besides a deprecation warning in
verbose mode, it still makes sense to recommend the newer syntax
already which was present already in current oldoldstable Debian
Stretch, so really not bleeding edge anymore.

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

docs: intro: avoid office@ mail address for sales related questions

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

fix #3645: Improve LDAP docs

- Be clearer about the fact that LDAP is only for spam quarantine
  access.
- Specify spam quarantine url and that users must log in with their
  email.

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

fix 3619: Add HTTPS to list of network services

This was previously missing from the "Firewall Settings" section and is
required for updates and subscription key checks

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

fix #3879: add colon at the end for user.conf

Signed-off-by: Moayad Almalat <m.almalat@proxmox.com>

bump version to 7.1-2

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

update static schema info

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

pmgproxy: document newly added options

adapted from pve-docs -> pveproxy

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>

pmgconfig: Link to SA rule writing documentation

Adds a link to SpamAssassin's rule syntax documentation to the section
"Custom SpamAssassin Configuration".

Also clarifies that the name of a custom spam score should be the name
of the corresponding SpamAssassin rule.

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

tfa: cleanup PVE specifics

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

tfa: rework note regarding cluster join and tfa

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