comments

2 files changed, 19 insertions, 18 deletions

diff --git a/config-etckeeper.PKGBUILD b/config-etckeeper.PKGBUILD
index 52bb751..5f56b43 100644
--- a/config-etckeeper.PKGBUILD
+++ b/config-etckeeper.PKGBUILD
@@ -6,28 +6,29 @@ depends=(etckeeper pristine-etc-keeper)
 package() {
 cd "$pkgdir"
 
-# [https://www.parabola.nu/packages/community/any/etckeeper/
-# etckeeper] is configured to use git (the default) to keep track of
-# changes in `/etc`. The systemd unit etckeeper.timer is enabled,
+# [etckeeper][] is configured to use git (the default) to keep track
+# of changes in `/etc`. The systemd unit etckeeper.timer is enabled,
 # which makes a commit (if necessary) daily.  It will also run before
 # and after pacman via libalpm hooks.
+#
+# [etckeeper]: https://www.parabola.nu/packages/community/any/etckeeper/
 add-unit etc/systemd/system/multi-user.target.wants/etckeeper.timer
 
 # In addition to etckeeper keeping track of the current configuration,
-# lukeshu's
-# [https://www.parabola.nu/packages/pcr/any/pristine-etc-keeper-git/
-# pristine-etc-keeper] maintains a branch of what `/etc` would be like
-# if we never made any changes from the default files. The clean
-# version of etc is available as the clean remote's master
-# branch. Doing a git diff clean/master master should be helpful in
-# investigating how things have been configured.
+# lukeshu's [pristine-etc-keeper][] maintains a branch of what `/etc`
+# would be like if we never made any changes from the default
+# files. The clean version of etc is available as the clean remote's
+# master branch. Doing a git diff pristine/master master should be
+# helpful in investigating how things have been configured.
+#
+# [pristine-etc-keeper]: https://www.parabola.nu/packages/pcr/any/pristine-etc-keeper-git/
 add-unit etc/systemd/system/multi-user.target.wants/pristine-etc-keeper.timer
 
 # The etckeeper update-ignore hook is customized to ignore a couple
 # more files in `/etc` (and avoid ignoring `/etc/mtab`).  We ignore
-# `resolv.conf` because it is managed by
-# [https://www.parabola.nu/packages/core/any/openresolv/
-# openresolv/resolvconf].
+# `resolv.conf` because it is managed by [resolvconf][openresolv].
+
+# [openresolv]: https://www.parabola.nu/packages/core/any/openresolv/
 add-file -m755 etc/etckeeper/update-ignore.d/02custom <<_EOF_
 #!/bin/bash
 sed -i '/^# end section managed by etckeeper\$/,\$d' .gitignore
diff --git a/config-winston-base.PKGBUILD b/config-winston-base.PKGBUILD
index 2fce27d..c61e4f7 100644
--- a/config-winston-base.PKGBUILD
+++ b/config-winston-base.PKGBUILD
@@ -32,12 +32,12 @@ add-unit etc/systemd/system/getty.target.wants/getty@tty1.service
 add-unit etc/systemd/system/multi-user.target.wants/haveged.service
 add-unit etc/systemd/system/multi-user.target.wants/irqbalance.service
 
-## Networking ##
+# ## Networking
 
-# /etc/udev/rules.d/80-net-setup-link.rules is a symlink to /dev/null,
-# which disables new-style [predictable network interface names][0]
-# (enp0s3? ens3?), and causes it to fall back to the old-style names
-# (eth0).
+# `/etc/udev/rules.d/80-net-setup-link.rules` is a symlink to
+# `/dev/null`, which disables new-style [predictable network interface
+# names][0] (`enp0s3`? `ens3`?), and causes it to fall back to the
+# old-style names (`eth0`).
 #
 # [0]: https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames/
 install -dm755 etc/udev/rules.d