Bug#321395: gpc-2.1-3.3-doc: Broken links to standards.html (forwarded from Stepan Golosunov)
> AFAICS the document isn't included in the gpc sources.
>
> /usr/share/doc/gcc-3.3-base/pascal/gpcs.html has links to standards.html
> (examle: '<a href="standards.html#Mmap">Mmap (standards)</a>')
> but there is no standards.html in gpc-2.1-3.3-doc and no
> /usr/share/doc/gcc-3.3-base/pascal/standards.html in Debian:
Yes, Texinfo allows for cross-references to external sources. We
also have some to GCC, Bison, etc.
In Info output, they should work well, as info files are usually
stored in a global place (/usr/share/info/ or such). For TeX-based
output (DVI, PS, PDF), the references appear only in printed form,
so the users can/have to look for the referenced documents
themselves.
For HTML output (the newest one), I'm not aware of a general
solution. We have the same problem on our web site.
It would clearly be unreasonable for each package to include all
referenced documentation, for us GCC, Bison, etc., and recursively
anything they reference. Apart from size blow, there would be
version issues, etc.
So perhaps this is something for the distributors to solve globally,
either by putting or symlinking all Textinfo-generated HTML
documentation in one directory, or by fixing external links after
generation (automatically with some script or such) ...
Frank
--
Frank Heckenbach, frank@g-n-u.de
http://fjf.gnu.de/
GnuPG and PGP keys: http://fjf.gnu.de/plan (7977168E)
Reply to: