Bug 55663 - Manual Page: WantedBy= of systemd.unit(5) is confusing.
Summary: Manual Page: WantedBy= of systemd.unit(5) is confusing.
Status: RESOLVED FIXED
Alias: None
Product: systemd
Classification: Unclassified
Component: general (show other bugs)
Version: unspecified
Hardware: Other All
: medium minor
Assignee: systemd-bugs
QA Contact: systemd-bugs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-10-05 12:41 UTC by Umut Tezduyar
Modified: 2013-07-14 03:38 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

Description Umut Tezduyar 2012-10-05 12:41:57 UTC
Following text is taken from the manual page of systemd.unit (man systemd.unit). 

 WantedBy=
           Installs a symlink in the .wants/ subdirectory for a unit. This has the effect that when the listed unit name is activated the unit listing it is activated too.  WantedBy=foo.service in a service bar.service is mostly equivalent to Alias=foo.service.wants/bar.service in the same file.

--------------------------

I believe it is not so clear to say, "Installs a symlink in the .wants/ subdirectory for a unit." By just editing this file, no symbolic link is created. It might have been better to say:
"A symbolic link is created in the .wants/ folder when the unit is activated by <systemctl enable>. 

I also tried to re-phrase the second sentenece:
When the unit assigned to "WantedBy=" is activated, the unit having "WantedBy=" is activated too. If bar.service unit has WantedBy=foo.service, it can be read as "foo.service wants bar.service".
Comment 1 Zbigniew Jedrzejewski-Szmek 2013-05-15 02:17:18 UTC
Yeah, looks like the text could be improved. Care to prepare a patch?
Comment 2 Zbigniew Jedrzejewski-Szmek 2013-07-14 03:38:13 UTC
Text changed in http://cgit.freedesktop.org/systemd/systemd/commit/?id=3eb1395.


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.