Red Hat Bugzilla – Bug 978954
DOC: man page: no info what NAME means
Last modified: 2014-06-17 20:35:02 EDT
Description of problem:
man page: no info what NAME means
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. systemctl [OPTIONS...] COMMAND [NAME...]
2. there is no explanation what NAME means
no explanation what NAME means
* what NAME means
* not obvious that you need '.service' in the comand
* not obvious that you need '=' in '--unit=NetworkManager.service', a space should work as well
I think that this is sufficiently explained later in commands section, for example:
Start (activate) one or more units specified on the command line.
From above statement it is obvious that NAME corresponds to unit name.
I think it would be helpful and not terribly burdensome to add a short explanation of usage to the top of the man page, in the DESCRIPTION section, which is currently very terse.
# man systemctl
I can see this in Description section (as mentioned in comment #4):
For Unit Commands the NAME represents full name of unit.
systemctl start foo.service
For Unit File Commands the NAME represents full name of the unit file, or absolute path to the unit file.
systemctl start /path/to/foo.service
Just one thing:
As far as I know: There should not be comma ',' before 'or' in english. :)
Additional information for comment #6:
It was tested with systemd-207-8.el7.x86_64.
This request was resolved in Red Hat Enterprise Linux 7.0.
Contact your manager or support representative in case you have further questions about the request.