Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update documentation to advice using 'systemctl edit' to modify the auto-check cycle #84

Merged
merged 6 commits into from
Jan 2, 2024
Merged

Update documentation to advice using 'systemctl edit' to modify the auto-check cycle #84

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
00731d5
Update documentation to advice using 'systemctl edit' to modify the a…
Antiz96 Jan 2, 2024
ea0b960
Address mdl feedback
Antiz96 Jan 2, 2024
c30f337
Add hyperlink to the systemd timer chapter
Antiz96 Jan 2, 2024
ed7983e
Add a missing return line in the man page
Antiz96 Jan 2, 2024
b9f8e7d
Add double return lines for readability
Antiz96 Jan 2, 2024
a6594ae
Insert blank line in the man page for readibility
Antiz96 Jan 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -183,16 +183,17 @@ See <https://wiki.archlinux.org/title/Desktop_notifications>

### Modify the auto-check cycle

If you enabled the systemd.timer, the `--check` option is automatically launched at boot and then once every hour.
If you enabled the [systemd.timer](#the-systemd-timer), the `--check` option is automatically launched at boot and then once per hour.

If you want to change that cycle, you can edit the `/usr/lib/systemd/user/arch-update.timer` file (or `/etc/systemd/user/arch-update.timer` if you installed `arch-update` [from source](#from-source)) and modify the `OnUnitActiveSec` value.
The timer needs to be re-enabled to apply changes, you can do so by running the following command:
If you want to change the check cycle, run `systemctl --user edit arch-update.timer` to create an override configuration for the timer and input the following in it:

```bash
systemctl --user enable --now arch-update.timer
```text
[Timer]
OnUnitActiveSec=10m
```

See <https://www.freedesktop.org/software/systemd/man/systemd.time.html>
Time units are `s` for seconds, `m` for minutes, `h` for hours, `d` for days...
See <https://www.freedesktop.org/software/systemd/man/systemd.time.html> for more details.

### Do not show package version changes

Expand Down
14 changes: 9 additions & 5 deletions doc/man/arch-update.1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -110,15 +110,19 @@ See https://wiki.archlinux.org/title/Desktop_notifications

.TP
.B Modify the auto-check cycle
.RB "If you enabled the " "systemd.timer" ", the " "--check " "option is automatically launched at boot and then once every hour"
.RB "If you enabled the " "systemd.timer" ", the " "--check " "option is automatically launched at boot and then once per hour."
.br
.RB "If you want to change that cycle, you can edit the " "/usr/lib/systemd/user/arch-update.timer " "(or "/etc/systemd/user/arch-update.timer " if you installed arch-update from source) file and modify the " "OnUnitActiveSec " "value"
.RB "If you want to change the check cycle, run " "systemctl --user edit arch-update.timer " "to create an override configuration for the timer and input the following in it:"
.br
The timer needs to be re-enabled to apply changes, you can do so by running the following command:

.B [Timer]
.br
.B OnUnitActiveSec=10m

.br
.B systemctl --user enable --now arch-update.timer
.RB "Time units are " "s " "for seconds, " "m " "for minutes, " "h " "for hours, " "d " "for days..."
.br
See https://www.freedesktop.org/software/systemd/man/systemd.time.html
See https://www.freedesktop.org/software/systemd/man/systemd.time.html for more details.

.TP
.B Do not show packages version changes
Expand Down