[pmg-devel] [PATCH pmg-docs] pmgqm: add example for systemd.timer edit

[pmg-devel] [PATCH pmg-docs] pmgqm: add example for systemd.timer edit

[Stoiko Ivanov]

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>
---
 pmgqm.adoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/pmgqm.adoc b/pmgqm.adoc
index 046c91e..2a73d9f 100644
--- a/pmgqm.adoc
+++ b/pmgqm.adoc
@@ -44,6 +44,18 @@ The timer can be edited with the command below:
 systemctl edit pmgspamreport.timer
 ----
 
+Keep in mind that just adding another `OnCalendar` event will cause the report
+to be sent out additionally at the specified time, if you want to prevent the
+default mail at 00:05, you need to reset the `OnCalendar` setting - for example
+to only send out the mails at 06:00:
+----
+[Timer]
+OnCalendar=
+OnCalendar=06:00
+----
+
+For details see the systemd man pages: `systemd.unit(5)`, `systemd.timer(5)`.
+
 ifdef::manvolnum[]
 include::pmg-copyright.adoc[]
 endif::manvolnum[]
-- 
2.30.2

[pmg-devel] applied: [PATCH pmg-docs] pmgqm: add example for systemd.timer edit

[Thomas Lamprecht]

Am 13/12/2022 um 12:45 schrieb Stoiko Ivanov:
> 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>
> ---
>  pmgqm.adoc | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
>

applied, thanks!