[systemd-devel] [PATCH] man: ship systemd-udevd as the real manpage

[Lennart Poettering]

On Sun, 29.07.12 12:43, Zbigniew Jędrzejewski-Szmek (zbyszek at in.waw.pl) wrote:

Heya,

> >> Instead of making systemd-udevd a so-link to systemd-udevd.service,
> >> ship the real page as systemd-udevd to integrate better with distros
> >> where udevd might be run standalone.
> > 
> > Sorry, but no.
> Hi,
> sorry for committing this, I didn't think it would be controversial.

No problem. I do appreciate the that you committed it actually.

> > We name all the service man pages after the service name, since that is
> > how people will primarily come in contact with it (i.e. they'll do
> > "systemctl start systemd-udevd.service", but never run
> > /usr/lib/systemd/systemd-udevd directly).
> > 
> > We design this stuff so that it is nicely integrated and uniform in its
> > behaviour. We'll not depart from that because people who don't use
> > systemd might be confused. 
> 
> I'm not interested in installing without systemd myself, but I still
> don't think this is a bad idea: the change is transparent in current
> default installation (if we ignore the change in the title of a
> manpage), and apparently it helps people who install without systemd.

It's actually not transparent, since the man page lists both names
anyway and the primary name exposed in URLs such as
http://www.freedesktop.org/software/systemd/man/systemd-udevd.service.html
are actually very much visible. 

I mean, this is admittedly all more on the side of nitpicking, rather
then anything important, but I think it is nice to keep things as
straightforward as possible, and stick to one scheme and one scheme only
for naming things. And that scheme is: if its in /usr/bin, then name it
by executable name, otherwise by service name.

Lennart

-- 
Lennart Poettering - Red Hat, Inc.