[systemd-devel] html pages for aliases

[Zbigniew Jędrzejewski-Szmek]

On Fri, Mar 08, 2013 at 03:09:21AM +0100, Michael Biebl wrote:
> 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?
But, but, but, ...., I know that for some reason I didn't want to do that,
but now I have no idea why not. That should work.

Zbyszek