]> git.ipfire.org Git - thirdparty/systemd.git/commit - man/tmpfiles.d.xml
man: reword tmpfiles.d descriptions to refer less to previous descriptions
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Tue, 11 Dec 2018 16:45:34 +0000 (17:45 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Tue, 11 Dec 2018 21:20:07 +0000 (22:20 +0100)
commit488e43525391e1279fefc17c381e664788680706
tree458af9db2818c88fd7c3f29b68cc8037aa2ba13e
parentff0fa50432af89a0efaa717d9a28c175257329cf
man: reword tmpfiles.d descriptions to refer less to previous descriptions

I think it is OK if some option is described as "similar to ..., but in
addition ...", as long as the "in addition" part is strictly additive this is
unambiguous. Otherwise, we'd have to repeat a lot of text, and then we'd
probably forget to adjust some of the descriptions when doing changes.

But when the "in addition" part is about replacing or removing parts of
functionality, it is better to avoid this pattern and describe the later option
from scratch.

Some paragraph breaks are added and minor changes made. UID/GID is changed to
user/group, since we generally expect user/group names to be used, not numeric
ids.

Fixes #11115.
man/tmpfiles.d.xml