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

[Dave Reisner]

On Sun, Jul 29, 2012 at 11:58:19AM +0200, Lennart Poettering wrote:
> On Fri, 27.07.12 20:46, Dave Reisner (dreisner at archlinux.org) wrote:
> 
> > 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.
> 
> 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).

This page describes exactly how to invoke the binary by its full path
and has each flag detailed. Seems like an open invitation to me.

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

Sure, they're confused because they don't have a manpage for
systemd-udevd without systemd being installed. I can respect that naming
is an important part of any project, but this doesn't get rid of any of
it. `man systemd-udevd.service' still does exactly the same thing. What
you're nitpicking here comes down to the names displayed in the header
and footer of the docs.

> They'll be confused anyway, simply because the thing is called
> "systemd-udevd" now, not "udevd" anymore...

Right, a direct result of a "cosmetic" change.

> 
> Sorry,
> 
> Lennart
> 
> -- 
> Lennart Poettering - Red Hat, Inc.