[systemd-devel] html pages for aliases

Zbigniew Jędrzejewski-Szmek zbyszek at in.waw.pl
Thu Mar 7 17:53:45 PST 2013


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?


More information about the systemd-devel mailing list