docs: add claude.md and avoid dashes

2026-09-21 14:00:02 +02:00
1 parent dbdbfe5cd5
commit c40dfe0238
@@ -1,5 +1,5 @@
 [Desktop Entry]
-# Not here to put an entry in the application menu - hence NoDisplay. This is
+# Not here to put an entry in the application menu, hence NoDisplay. This is
 # how the desktop learns what to call the update while it runs: the progress
 # bar in the notification area is labelled from the desktop entry named in the
 # job request, and without one the job is filed under whatever the helper
@@ -7,7 +7,7 @@
 # Documentation:      man cachy-auto-update

 # ---------------------------------------------------------------------------
-# Main switches - normally set through `cachy-auto-update enable/disable`
+# Main switches, normally set through `cachy-auto-update enable/disable`
 # ---------------------------------------------------------------------------

 # Apply updates automatically in the background.
@@ -73,7 +73,7 @@ IgnorePkg=
 # installed packages, and every cached version of packages that are no longer
 # installed. Nothing that is currently installed is ever touched, so this only
 # costs the ability to downgrade further back than KeepOldPackages.
-# Without it /var/cache/pacman/pkg grows forever - tens of gigabytes on a
+# Without it /var/cache/pacman/pkg grows forever: tens of gigabytes on a
 # machine with a few large packages.
 CleanCache=yes

@@ -97,8 +97,8 @@ RemoveOrphans=no
 #
 # How long a message stays on screen is not configurable, because it follows
 # from what the message is for: anything reporting that the machine still needs
-# a person - a failed update, a paused package queue, a package that had to be
-# skipped - waits until it is dismissed, since a message like that is only ever
+# a person (a failed update, a paused package queue, a package that had to be
+# skipped) waits until it is dismissed, since a message like that is only ever
 # useful if it is still there when somebody comes back. Everything else, an
 # update that simply worked included, times out on its own.

@@ -28,8 +28,8 @@ TimeoutStartSec=4h
 # Deliberately *not* sandboxed the way paccache.service is: this unit installs
 # packages across the whole filesystem and downloads them over the network, so
 # ProtectSystem=, PrivateNetwork= and friends would break it. NoNewPrivileges
-# in particular has to stay off - the AUR step relies on the build account
-# calling sudo.
+# in particular has to stay off, because the AUR step relies on the build
+# account calling sudo.
 NoNewPrivileges=no
 ProtectHostname=yes

@@ -5,7 +5,7 @@ Documentation=man:cachy-auto-update(1)
 [Timer]
 # The tick is hourly, but an actual update only happens once per
 # UpdateInterval (default: daily). That combination is what makes a postponed
-# run - low battery, a game running, somebody else using pacman - retry by
+# run (low battery, a game running, somebody else using pacman) retry by
 # itself an hour later without any backoff bookkeeping.
 OnBootSec=15min
 OnCalendar=hourly