[systemd-devel] html pages for aliases

[Michael Biebl]

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?

Michael

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