[systemd-devel] html pages for aliases

Michael Biebl mbiebl at gmail.com
Thu Mar 7 18:09:21 PST 2013

2013/3/8 Zbigniew Jędrzejewski-Szmek <zbyszek at in.waw.pl>:
> Hi,
> Michael Biebl pointed out that some links in
> www.freedesktop.org/software/systemd/man/index.html are
> broken. Unfortunately all links to man page aliases are broken. This
> is because only man includes are generated (e.g. build/man/init.1
> contains only '.so man1/systemd.1'). There are a few options how to
> deal with this problem:
> 1. modify generation logic to link to the target page directly, not
>    the alias
> 2. add stub HTML pages which contain a redirect (probably both
>    <meta http-equiv="refresh" content=""> and javascript and an
>    explicit link to be safe).
> 3. add server redirects in a .htaccess file. .htaccess would be
>    generated along with the index.
> I don't like option 1. because it break the property that "one
> can go to www.freedesktop.org/software/systemd/man/xxx.html and
> see the man page for xxx".
> Option 3. would be nicest but would require allowing .htaccess on
> fd.o, which is currently not allowed. Option 2. would work too.
> Thoughts, solutions, comments?

I'd prefer 2/ since that doesn't require a running webserver.
javascript required is probably overkill. The refresh meta tag +
explicit link should be sufficient.

But couldn't we just create file symlinks?


Why is it that all of the instruments seeking intelligent life in the
universe are pointed away from Earth?

More information about the systemd-devel mailing list