Please read this before reporting a bug:
https://wiki.archlinux.org/title/Bug_reporting_guidelines
Do NOT report bugs when a package is just outdated, or it is in the AUR. Use the 'flag out of date' link on the package page, or the Mailing List.
REPEAT: Do NOT report bugs for outdated packages!
https://wiki.archlinux.org/title/Bug_reporting_guidelines
Do NOT report bugs when a package is just outdated, or it is in the AUR. Use the 'flag out of date' link on the package page, or the Mailing List.
REPEAT: Do NOT report bugs for outdated packages!
FS#38136 - [lighttpd] Request to change description in .service file
Attached to Project:
Arch Linux
Opened by nyuszika7h (nyuszika7h) - Saturday, 14 December 2013, 19:49 GMT
Last edited by Pierre Schmitz (Pierre) - Friday, 15 May 2015, 11:36 GMT
Opened by nyuszika7h (nyuszika7h) - Saturday, 14 December 2013, 19:49 GMT
Last edited by Pierre Schmitz (Pierre) - Friday, 15 May 2015, 11:36 GMT
|
DetailsThe description in lighttpd.service doesn't make it instantly obvious it's lighttpd, unlike other .service file descriptions, such as "GNOME Display Manager".
Here is the proposed patch: --- a/lighttpd.service +++ b/lighttpd.service @@ -1,5 +1,5 @@ [Unit] -Description=A secure, fast, compliant and very flexible web-server +Description=Lighttpd web server After=syslog.target network.target [Service] |
This task depends upon
lighttpd.service.patch
https://wiki.archlinux.org/index.php/PKGBUILD#pkgdesc
For projects that has several executables or services connected to them, like client and servers or desktops and display managers, including the name of the project is hard to avoid.
"GNOME Display Manager" is a good example of this, even though it should arguably rather be something like "Display manager for GNOME".
If you look at the other .service files on your system, few of the descriptions contains the name of the application:
systemctl --type=service --system
The purpose of a description is to describe what the service is, not to repeat the name of the service, which is already readily available.
Do you have a particular use case where the lack of the name in the description is a problem?
"A" and "very" does not add any information and the hyphen in "web-service" is a spelling mistake.
In either case, the description in Apache's .service file is "Apache Web Server", which is inconsistent with the rest. (Is the reason the same as GNOME?)
Cherokee also uses "Cherokee web server", but that's in the AUR.
For more general things such as polkit, it's not definitely necessary to mention the name of the application itself.
I'd also argue that descriptions like "Manage, Install and Generate Color Profiles" are not good because of how they're displayed:
[ OK ] Started Manage, Install and Generate Color Profiles.
That's out of the scope of this issue, though.
"Starting [Application name], a [Generic name]" would make more sense, IMO. ("Starting lighttpd, a Web server" for instance).
"Generic name" is already used in .desktop files.
I think both systemd and the color profile description should be fixed in this regard.
Description=
A free-form string describing the unit. This is intended for use in UIs to show
descriptive information along with the unit name. The description should contain a name
that means something to the end user. "Apache2 Web Server" is a good example. Bad
examples are "high-performance light-weight HTTP server" (too generic) or "Apache2" (too
specific and meaningless for people who do not know Apache).
Nothing wrong, just unusual. If not directly "at fault", I think it's fair to say that systemd could have chosen different another word than "Description", for clarity, since there are two special extra requirements (must fit after "Started" and must contain the name of what is being described). I agree that this particular bug report is about the problem with the lighttpd description.