[Patch] pdf output from doc build has broken links
I noticed whenever a url link is nested inside a <file> tag, the
pdflatex output is incorrect and unlinked. The patch below fixes that
in the woody install manual.
Also, some links are made relative links by the web build process. Those
links work fine in the html format, but in the pdf format they are broken.
If you click on one of these links, acrobat reports a relative link not found
error. In sgml, the links work out to be absolute links, so there must be
something in the build process that causes this to occur.
Index: appendix.sgml
===================================================================
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/appendix.sgml,v
retrieving revision 1.9
diff -u -r1.9 appendix.sgml
--- appendix.sgml 2001/09/16 20:02:14 1.9
+++ appendix.sgml 2001/09/26 07:02:11
@@ -72,9 +72,9 @@
special action to download directly to a file, in raw binary mode. For
example, in Netscape you need to hold the shift key when clicking on
the URL to retrieve the file. Files can be downloaded from the URLs
-in this document, which are within the www server's <file><url
-id="&url-boot-floppies;" name=".../current/"></file> directory, or you can
-retrieve them via ftp from
+in this document, which are within the www server's <url
+id="&url-boot-floppies;" name=".../current/"> directory, or you can
+retrieve them via ftp from <url id=
"&disturlftp;main/disks-&architecture;/current/">. You can also use
the corresponding directory on any of the <url
id="&url-debian-mirrors;" name="Debian mirror sites">.
@@ -267,7 +267,7 @@
These files contain the base system which will be installed on your
Linux partition during the installation process. This is the bare
minimum necessary for you to be able to install the rest of the
-packages. The <file>&base-disk-tarball;</file> file is for installation
+packages. The &base-disk-tarball; file is for installation
from non-floppy media, i.e., CD-ROM, harddisk, or NFS.
</taglist>
-->
Index: inst-methods.sgml
===================================================================
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/inst-methods.sgml,v
retrieving revision 1.72
diff -u -r1.72 inst-methods.sgml
--- inst-methods.sgml 2001/09/10 10:28:42 1.72
+++ inst-methods.sgml 2001/09/26 07:02:15
@@ -298,10 +298,9 @@
<p>
Unfortunately, these <prgn>MILO</prgn> images could not be tested and
might not work for all sub-architectures. If you find it doesn't work
-for you, try copying the appropriate <prgn>MILO</prgn> binary from the
-potato release onto the floppy (<url
-id="ftp://ftp.debian.org/debian/dists/potato/main/disks-alpha/current/MILO/";>).
-Note that those <prgn>MILO</prgn>s don't support ext2 ``sparse
+for you, try copying the appropriate <prgn>MILO</prgn> binary onto the
+floppy (<url id="&disturlftp;main/disks-alpha/current/MILO/">). Note
+that those <prgn>MILO</prgn>s don't support ext2 ``sparse
superblocks'', so you can't use them to load kernels from newly
generated ext2 file systems. As a workaround, you can put your kernel
onto the FAT partition next to the <prgn>MILO</prgn>.
@@ -313,7 +312,7 @@
<![ %i386 [
<p>
In addition to the files above, you will need
-<file>&loadlin.exe;</file> (see <ref id="rescue-images">). ]]>
+&loadlin.exe; (see <ref id="rescue-images">). ]]>
<![ %m68k [
<sect2 id="amiga-install-files">AmigaOS Installation Files
@@ -452,7 +451,7 @@
<p>
<![ %workaround-bug-99926 [
-<!-- <file>&rawrite2.exe;</file> this file is currently broken -->
+<!-- &rawrite2.exe; this file is currently broken -->
If you have access to an i386 machine, you can use one of the
following programs to copy images to floppies.
@@ -479,9 +478,8 @@
<!-- this block waiting for rawrite2 to be fixed:
If you have access to an i386 machine, you can use the
-<file>&rawrite2.exe;</file>
-program to write the floppy disk images.
-There's also a <file>&rawrite2.txt;</file> file containing
+&rawrite2.exe; program to write the floppy disk images.
+There's also a &rawrite2.txt; file containing
instructions for using <prgn>rawrite2</prgn>.
<p>
To write the floppy disk image files to the floppy disks, first make
Index: kernel.sgml
===================================================================
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/kernel.sgml,v
retrieving revision 1.2
diff -u -r1.2 kernel.sgml
--- kernel.sgml 2001/08/09 03:28:30 1.2
+++ kernel.sgml 2001/09/26 07:02:15
@@ -262,7 +262,7 @@
If you are installing the base system from NFS, then choose NFS and
continue. You'll be prompted to specify the server, the share on the
server, and the subdirectory within that share where the
-<file>&base-disk-tarball;</file> file can be found. If you have
+&base-disk-tarball; file can be found. If you have
problems mounting NFS, make sure that the system time on the NFS
server more or less agrees with the system time on the client. You
can set your date on <file>tty2</file> using the <tt>date</tt>
Reply to: