Bug#657677: tex-common: missing files in /usr/share/doc/tex-common

["Brenda J. Butler" <bjb@sourcerer.ca>]

On Tue, Feb 07, 2012 at 12:08:55PM +0100, Frank K?ster wrote:
> Brenda J. Butler <bjb@sourcerer.ca> wrote:
> 
> > Package: tex-common
> > Version: 2.08.1
> > Severity: minor
> >
> >
> > I went to look at http://localhost/doc/tex-common/README.Debian.html,
> > which exists, but every link from that page is broken.  And the page
> > consists mostly of links.
> >
> > Those links point to things like:
> >
> > localhost/doc/tex-common/ch1.html
> > localhost/doc/tex-common/ch2.html#s-sec-texmf-trees
> > localhost/doc/tex-common/ch5.html
> >
> > And those documents do not exist in my filesystem.
> 
> That is a problem how symlinks are treated by the browser.
> README.Debian.html is a symlink to TeX-on-Debian.html/index.html.  If
> you open the latter file, the http links work, but since they are
> relative links, they don't work from README.Debian.html one directory
> level higher.
> 
> Does anybody have a clue how to fix this?

Suggestion 1: Take away the symbolic link and make people go to the
subdirectory to see the top-level file.


Suggestion 2:  Or, make a lot of symbolic links.


Suggestion 3: Or, make a subdirectory for the extra links, and make a
link to the subdirectory from the top.



Illustrating the last suggestion:

As it is now: (going from memory)
.../doc/tex-common/README.Debian.html   -> html/README.Debian.html
.../doc/tex-common/html/README.Debian.html
.../doc/tex-common/html/ch1.html
.../doc/tex-common/html/ch2.html

README.Debian.html contains links like:  ch1.html


Suggested arrangement:
.../doc/tex-common/README.Debian.html   -> html/README.Debian.html
.../doc/tex-common/more                 -> html/more
.../doc/tex-common/html/README.Debian.html
.../doc/tex-common/html/more/ch1.html
.../doc/tex-common/html/more/ch2.html

README.Debian.html contains links like:  more/ch1.html


HTH

bjb