units: adjust Descriptions of various units

keszybz · keszybz · commit 4fd3fc663960 · 2021-06-30T13:25:16.000+02:00
In general, it's not very usuful to repeat the unit name as the description.
Especially when the word is a common name and if somebody doesn't understand
the meaning immediately, they are not going to gain anything from the
repeat either, e.g. "halt", "swap".

In the status-unit-format=combined output parentheses are used around
Description, so avoid using parenthesis in the Description itself.
diff --git a/units/bluetooth.target b/units/bluetooth.target
@@ -8,6 +8,6 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Bluetooth
+Description=Bluetooth Support
 Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes
diff --git a/units/final.target b/units/final.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Final Step
+Description=Late Boot Services
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes
diff --git a/units/getty-pre.target b/units/getty-pre.target
@@ -8,6 +8,6 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Login Prompts (Pre)
+Description=Preparation for Logins
 Documentation=man:systemd.special(7) man:systemd-getty-generator(8)
 Documentation=http://0pointer.de/blog/projects/serial-console.html
diff --git a/units/halt.target b/units/halt.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Halt
+Description=System Halt
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=systemd-halt.service
diff --git a/units/hibernate.target b/units/hibernate.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Hibernate
+Description=System Hibernation
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=systemd-hibernate.service
diff --git a/units/local-fs-pre.target b/units/local-fs-pre.target
@@ -8,6 +8,6 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Local File Systems (Pre)
+Description=Preparation for Local File Systems
 Documentation=man:systemd.special(7)
 RefuseManualStart=yes
diff --git a/units/network-pre.target b/units/network-pre.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Network (Pre)
+Description=Preparation for Network
 Documentation=man:systemd.special(7)
 Documentation=https://www.freedesktop.org/wiki/Software/systemd/NetworkTarget
 RefuseManualStart=yes
diff --git a/units/paths.target b/units/paths.target
@@ -8,5 +8,5 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Paths
+Description=Path Units
 Documentation=man:systemd.special(7)
diff --git a/units/poweroff.target b/units/poweroff.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Power-Off
+Description=System Power Off
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=systemd-poweroff.service
diff --git a/units/printer.target b/units/printer.target
@@ -8,6 +8,6 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Printer
+Description=Printer Support
 Documentation=man:systemd.special(7)
 StopWhenUnneeded=yes
diff --git a/units/reboot.target b/units/reboot.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Reboot
+Description=System Reboot
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 Requires=systemd-reboot.service
diff --git a/units/remote-fs-pre.target b/units/remote-fs-pre.target
@@ -8,6 +8,6 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Remote File Systems (Pre)
+Description=Preparation for Remote File Systems
 Documentation=man:systemd.special(7)
 RefuseManualStart=yes
diff --git a/units/shutdown.target b/units/shutdown.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Shutdown
+Description=System Shutdown
 Documentation=man:systemd.special(7)
 DefaultDependencies=no
 RefuseManualStart=yes
diff --git a/units/slices.target b/units/slices.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Slices
+Description=Slice Units
 Documentation=man:systemd.special(7)
 Wants=-.slice system.slice
 After=-.slice system.slice
diff --git a/units/sockets.target b/units/sockets.target
@@ -8,5 +8,5 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Sockets
+Description=Socket Units
 Documentation=man:systemd.special(7)
diff --git a/units/swap.target b/units/swap.target
@@ -8,5 +8,5 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Swap
+Description=Swaps
 Documentation=man:systemd.special(7)
diff --git a/units/systemd-halt.service b/units/systemd-halt.service
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Halt
+Description=System Halt
 Documentation=man:systemd-halt.service(8)
 DefaultDependencies=no
 Requires=shutdown.target umount.target final.target
diff --git a/units/systemd-networkd.service.in b/units/systemd-networkd.service.in
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Network Service
+Description=Network Configuration
 Documentation=man:systemd-networkd.service(8)
 ConditionCapability=CAP_NET_ADMIN
 DefaultDependencies=no
diff --git a/units/systemd-poweroff.service b/units/systemd-poweroff.service
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Power-Off
+Description=System Power Off
 Documentation=man:systemd-poweroff.service(8)
 DefaultDependencies=no
 Requires=shutdown.target umount.target final.target
diff --git a/units/systemd-reboot.service b/units/systemd-reboot.service
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Reboot
+Description=System Reboot
 Documentation=man:systemd-reboot.service(8)
 DefaultDependencies=no
 Requires=shutdown.target umount.target final.target
diff --git a/units/systemd-suspend.service.in b/units/systemd-suspend.service.in
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Suspend
+Description=System Suspend
 Documentation=man:systemd-suspend.service(8)
 DefaultDependencies=no
 Requires=sleep.target
diff --git a/units/timers.target b/units/timers.target
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Timers
+Description=Timer Units
 Documentation=man:systemd.special(7)
 
 DefaultDependencies=no
diff --git a/units/tmp.mount b/units/tmp.mount
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Temporary Directory (/tmp)
+Description=Temporary Directory /tmp
 Documentation=https://systemd.io/TEMPORARY_DIRECTORIES
 Documentation=man:file-hierarchy(7)
 Documentation=https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems
