[systemd-bugs] [Bug 55663] New: Manual Page: WantedBy= of systemd.conf is confusing.

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=55663

          Priority: medium
            Bug ID: 55663
          Assignee: systemd-bugs at lists.freedesktop.org
           Summary: Manual Page: WantedBy= of systemd.conf is confusing.
        QA Contact: systemd-bugs at lists.freedesktop.org
          Severity: minor
    Classification: Unclassified
                OS: All
          Reporter: umuttl at axis.com
          Hardware: Other
            Status: NEW
           Version: unspecified
         Component: general
           Product: systemd

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".

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
You are the assignee for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/systemd-bugs/attachments/20121005/d4320d60/attachment.html>