From: Zbigniew Jędrzejewski-Szmek Date: Tue, 29 Jun 2021 07:47:53 +0000 (+0200) Subject: units: adjust Descriptions of various units X-Git-Tag: v249-rc3~13^2~3 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4fd3fc66396026f81fd5b27746f2faf8a9a7b9ee;p=thirdparty%2Fsystemd.git units: adjust Descriptions of various units 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 index 8333c2332fc..ab23c850c6b 100644 --- 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 index 34f6069dd13..4c86ca79356 100644 --- 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 index 5cf0875faee..663011de1d4 100644 --- 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 index b06758bf959..bfa5f23e1de 100644 --- 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 index 9ec6f2a6b1f..838c5a3e9be 100644 --- 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 index bffa7e95dd8..8e0f4b8ffb4 100644 --- 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 index 70279dacdbd..f92449b50bb 100644 --- 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 index 1bec148bee8..fb8dc643208 100644 --- 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 index e97f058fdcd..c17c123dfe8 100644 --- 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 index c695669c5cc..043bfbd61e6 100644 --- 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 index a900c90dcf5..5ad941935e1 100644 --- 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 index bba5e0ce7c7..1ede280eff1 100644 --- 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 index 582ae6ba275..8b3c0b6989a 100644 --- 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 index 4517e35fc57..72701bd2a80 100644 --- 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 index c6e20d77609..e53d1ebb7d9 100644 --- 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 index bcdd98815b5..1f2160765a2 100644 --- 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 index 37bfe285c03..3ce976f539d 100644 --- 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 index 9a40d2afa56..ffa45ba049a 100644 --- 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 index d95c618e79d..254188d6827 100644 --- 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 index 5c7ade7d021..79176ada31a 100644 --- 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 index 1ae32af5f7c..2515575e104 100644 --- 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 index 99f82e3b809..2e626be753a 100644 --- 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 index a8e58516328..516bd1621ce 100644 --- 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