path: root/en_US.ISO8859-1/books
diff options
authorDenis Peplin <den@FreeBSD.org>2004-08-05 10:04:31 +0000
committerDenis Peplin <den@FreeBSD.org>2004-08-05 10:04:31 +0000
commitc12c11040e25b690cecaa0543a22c7aff8c3797c (patch)
treeb3f202a3e340e12cba0292a8201179d6a600d6a7 /en_US.ISO8859-1/books
parent2f69cd65ee273a00b79d7a1b906d7d5f0f52deb3 (diff)
Use url entities for links between docs
Notes: svn path=/head/; revision=21827
Diffstat (limited to 'en_US.ISO8859-1/books')
17 files changed, 115 insertions, 112 deletions
diff --git a/en_US.ISO8859-1/books/arch-handbook/book.sgml b/en_US.ISO8859-1/books/arch-handbook/book.sgml
index 35d03ce0b1..3401257fce 100644
--- a/en_US.ISO8859-1/books/arch-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/arch-handbook/book.sgml
@@ -53,7 +53,7 @@
variety of formats and compression options from the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP
server</ulink> or one of the numerous <ulink
- url="../handbook/mirrors-ftp.html">mirror
+ url="&url.books.handbook;/mirrors-ftp.html">mirror
diff --git a/en_US.ISO8859-1/books/developers-handbook/book.sgml b/en_US.ISO8859-1/books/developers-handbook/book.sgml
index b12155cd3d..3b0acaeca6 100644
--- a/en_US.ISO8859-1/books/developers-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/book.sgml
@@ -66,7 +66,7 @@
variety of formats and compression options from the <ulink
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP
server</ulink> or one of the numerous <ulink
- url="../handbook/mirrors-ftp.html">mirror
+ url="&url.books.handbook;/mirrors-ftp.html">mirror
diff --git a/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml b/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
index c5c841569f..22a5b4dd9b 100644
--- a/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
@@ -493,7 +493,7 @@
<programlisting>options DDB</programlisting>
to your config file, and rebuild. (See <ulink
- url="../handbook/index.html">The FreeBSD Handbook</ulink> for details on
+ url="&url.books.handbook;/index.html">The FreeBSD Handbook</ulink> for details on
configuring the FreeBSD kernel).</para>
diff --git a/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml b/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml
index 336ac5ec2b..aec9e1649d 100644
--- a/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/policies/chapter.sgml
@@ -268,7 +268,7 @@ obrien@FreeBSD.org - 30 March 1997</programlisting>
<para>Any encumbered file requires specific approval from the
- <ulink url="../../articles/contributors/staff-core.html">Core team</ulink> before it is added to the
+ <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> before it is added to the
CVS repository.</para>
@@ -299,9 +299,9 @@ obrien@FreeBSD.org - 30 March 1997</programlisting>
<para>Should always be in <filename>LINT</filename>, but the
- <ulink url="../../articles/contributors/staff-core.html">Core team</ulink> decides per case if it
+ <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> decides per case if it
should be commented out or not. The
- <ulink url="../../articles/contributors/staff-core.html">Core team</ulink> can, of course, change
+ <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> can, of course, change
their minds later on.</para>
@@ -318,13 +318,13 @@ obrien@FreeBSD.org - 30 March 1997</programlisting>
<indexterm><primary>core team</primary></indexterm>
- <para>The <ulink url="../../articles/contributors/staff-core.html">Core team</ulink> decides if
+ <para>The <ulink url="&url.articles.contributors;/staff-core.html">Core team</ulink> decides if
the code should be part of <command>make world</command>.</para>
<indexterm><primary>release engineer</primary></indexterm>
- <para>The <ulink url="../../articles/contributors/staff-who.html">Release Engineer</ulink>
+ <para>The <ulink url="&url.articles.contributors;/staff-who.html">Release Engineer</ulink>
decides if it goes into the release.</para>
diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 27d6bbb152..4ae09068ab 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -130,7 +130,7 @@
all over the world in their work, education and recreation.</para>
<para>For more detailed information on FreeBSD, please see the
- <ulink URL="../handbook/index.html">FreeBSD
+ <ulink URL="&url.books.handbook;/index.html">FreeBSD
@@ -233,7 +233,7 @@
such as &windows; and older versions of &macos;, expect to
invest additional time learning the &unix; way of doing
things. This FAQ and the <ulink
- url="../handbook/index.html">FreeBSD Handbook</ulink> are
+ url="&url.books.handbook;/index.html">FreeBSD Handbook</ulink> are
excellent places to start.</para>
@@ -351,15 +351,15 @@
- URL="../handbook/cutting-edge.html#CURRENT">FreeBSD-CURRENT</ulink>
+ URL="&url.books.handbook;/cutting-edge.html#CURRENT">FreeBSD-CURRENT</ulink>
is the development version of the operating system, which
will in due course become the new &os.stable; branch.
This is expected to happen around 5.3-RELEASE. As such, it is
really only of interest to developers working on the
system and die-hard hobbyists. See the <ulink
- URL="../handbook/cutting-edge.html#CURRENT">relevant
+ URL="&url.books.handbook;/cutting-edge.html#CURRENT">relevant
section</ulink> in the <ulink
- URL="../handbook/index.html">handbook</ulink> for details
+ URL="&url.books.handbook;/index.html">handbook</ulink> for details
on running -CURRENT.</para>
<para>If you are not familiar with the operating system or are
@@ -432,9 +432,9 @@
<para>Back when FreeBSD 2.0.5 was released, FreeBSD
development branched in two. One branch was named <ulink
- URL="../handbook/current-stable.html#STABLE">-STABLE</ulink>,
+ URL="&url.books.handbook;/current-stable.html#STABLE">-STABLE</ulink>,
one <ulink
- URL="../handbook/current-stable.html#CURRENT">-CURRENT</ulink>.
+ URL="&url.books.handbook;/current-stable.html#CURRENT">-CURRENT</ulink>.
FreeBSD-STABLE is intended for Internet Service Providers
and other commercial enterprises for whom sudden shifts or
experimental features are quite undesirable. It receives
@@ -542,10 +542,10 @@
<para>The key decisions concerning the FreeBSD project, such
as the overall direction of the project and who is allowed
to add code to the source tree, are made by a <ulink
- URL="../../articles/contributors/article.html#STAFF-CORE">core
+ URL="&url.articles.contributors;/article.html#STAFF-CORE">core
team</ulink> of 9 people. There is a much larger team of
more than 300 <ulink
- URL="../../articles/contributors/article.html#STAFF-COMMITTERS">committers</ulink>
+ URL="&url.articles.contributors;/article.html#STAFF-COMMITTERS">committers</ulink>
who are authorized to make changes directly to the FreeBSD
source tree.</para>
@@ -604,7 +604,7 @@
<para>Information about obtaining FreeBSD on CD, DVD, and other
- media can be found in <ulink url="../handbook/mirrors.html">the
+ media can be found in <ulink url="&url.books.handbook;/mirrors.html">the
@@ -616,7 +616,7 @@
<para>Information on setting up a FreeBSD mirror can be
- found in the <ulink url="../../articles/hubs/">Mirroring
+ found in the <ulink url="&url.articles.hubs;/">Mirroring
FreeBSD</ulink> article.</para>
@@ -640,7 +640,7 @@
currently disabled due to persistent abuse.</para>
<para>Before submitting a problem report, please read <ulink
- URL="../../articles/problem-reports/article.html">Writing
+ URL="&url.articles.problem-reports;/article.html">Writing
FreeBSD Problem Reports</ulink>, an article on how to write
good problem reports.</para>
@@ -1029,7 +1029,7 @@ File: +DESC (ignored)</screen>
<para>You can find full information in the <ulink
- URL="../handbook/eresources.html#ERESOURCES-MAIL">Handbook
+ URL="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">Handbook
entry on mailing-lists</ulink>.</para>
@@ -1052,7 +1052,7 @@ File: +DESC (ignored)</screen>
<para>You can find full information in the <ulink
- URL="../handbook/eresources-news.html">Handbook entry on
+ URL="&url.books.handbook;/eresources-news.html">Handbook entry on
@@ -1212,7 +1212,7 @@ File: +DESC (ignored)</screen>
<para>Full instructions on this procedure and a little bit more
about installation issues in general can be found in the
- <ulink URL="../handbook/install.html">Handbook entry on
+ <ulink URL="&url.books.handbook;/install.html">Handbook entry on
installing FreeBSD</ulink>.</para>
@@ -1263,7 +1263,7 @@ File: +DESC (ignored)</screen>
<quote>raw</quote>, using the low-level tools (e.g.
<command>fdimage</command> or <command>rawrite</command>)
described in the <ulink
- URL="../handbook/install.html">installation guide to
+ URL="&url.books.handbook;/install.html">installation guide to
@@ -1277,7 +1277,7 @@ File: +DESC (ignored)</screen>
<para>Installation instructions can be found in the
- <ulink URL="../handbook/install.html">Handbook entry on installing FreeBSD</ulink>.</para>
+ <ulink URL="&url.books.handbook;/install.html">Handbook entry on installing FreeBSD</ulink>.</para>
@@ -1332,7 +1332,7 @@ File: +DESC (ignored)</screen>
release, which will include your install floppy.</para>
<para>To make a custom release, follow the instructions in the
- <ulink url="../../articles/releng/article.html">Release
+ <ulink url="&url.articles.releng;/article.html">Release
Engineering</ulink> article.</para>
@@ -1344,7 +1344,7 @@ File: +DESC (ignored)</screen>
<para>Have a look at
- <ulink URL="../../articles/multi-os/index.html">
+ <ulink URL="&url.articles.multi-os;/index.html">
the multi-OS page</ulink>.</para>
@@ -1734,7 +1734,7 @@ sectors/track: 63</screen>
<para>Yes. Use a standard Laplink cable. If necessary, you
- can check out the <ulink url="../handbook/plip.html">PLIP
+ can check out the <ulink url="&url.books.handbook;/plip.html">PLIP
section of the Handbook</ulink> for details on parallel
port networking.</para>
@@ -2059,7 +2059,7 @@ sectors/track: 63</screen>
- <para><ulink URL="../handbook/kernelconfig.html">Rebuild
+ <para><ulink URL="&url.books.handbook;/kernelconfig.html">Rebuild
your kernel,</ulink> modify the wd configuration lines to
@@ -2240,9 +2240,9 @@ disk wd2 at wdc1 drive 1 # change from wd3 to wd2</programlisting
options that attempts to achieve the desired ratio of security
to convenience by enabling and disabling certain programs and
other settings. For full details, see the <ulink
- url="../handbook/install-post.html#SECURITYPROFILE">Security
+ url="&url.books.handbook;/install-post.html#SECURITYPROFILE">Security
Profile</ulink> section of the Handbook's <ulink
- url="../handbook/install-post.html">post-install
+ url="&url.books.handbook;/install-post.html">post-install
@@ -3014,7 +3014,7 @@ Protocol "SysMouse"</programlisting>
<para>There is a list of these in the <ulink
- URL="../handbook/install.html#INSTALL-MISC">Miscellaneous
+ URL="&url.books.handbook;/install.html#INSTALL-MISC">Miscellaneous
devices</ulink> section of the handbook.</para>
<para>Some unnamed clone cards have also been known to work,
@@ -3115,7 +3115,7 @@ Protocol "SysMouse"</programlisting>
<para>See the <ulink
- URL="../handbook/install.html#INSTALL-MISC">Handbook</ulink>
+ URL="&url.books.handbook;/install.html#INSTALL-MISC">Handbook</ulink>
for the list of other devices supported.</para>
@@ -3366,7 +3366,7 @@ ARRE (Auto Read Reallocation Enbld): 1</programlisting>
address range clash :), by bumping the kernel option
<literal>EISA_SLOTS</literal> to a value of 12. Configure and
compile a kernel, as described in the <ulink
- URL="../handbook/kernelconfig.html">Handbook entry on
+ URL="&url.books.handbook;/kernelconfig.html">Handbook entry on
configuring the kernel</ulink>.</para>
<para>Of course, this does present you with a chicken-and-egg
@@ -3442,9 +3442,9 @@ quit</programlisting>
<para>If the only problem is that the printer is terribly
slow, try changing your <ulink
- url="../handbook/printing-intro-setup.html#PRINTING-PARALLEL-PORT-MODE">printer
+ url="&url.books.handbook;/printing-intro-setup.html#PRINTING-PARALLEL-PORT-MODE">printer
port mode</ulink> as discussed in the <ulink
- url="../handbook/printing-intro-setup.html">Printer
+ url="&url.books.handbook;/printing-intro-setup.html">Printer
Setup</ulink> section of the Handbook.</para>
@@ -4245,9 +4245,9 @@ chip1@pci0:31:5: class=0x040100 card=0x00931028 chip=0x24158086 rev=0x02
This error message indicates you have exhausted the number
of available file descriptors on your system. Please see
the <ulink
- url="../handbook/configtuning-kernel-limits.html#KERN-MAXFILES">kern.maxfiles
+ url="&url.books.handbook;/configtuning-kernel-limits.html#KERN-MAXFILES">kern.maxfiles
</ulink>section of the <ulink
- url="../handbook/configtuning-kernel-limits.html">Tuning
+ url="&url.books.handbook;/configtuning-kernel-limits.html">Tuning
Kernel Limits</ulink> section of the Handbook for a
discussion and solution.</para>
@@ -4527,7 +4527,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
works flawlessly on FreeBSD. The easiest way to
install the &linux; version of StarOffice is through the
- <ulink url="../handbook/ports.html">FreeBSD Ports
+ <ulink url="&url.books.handbook;/ports.html">FreeBSD Ports
collection</ulink>. Future versions of the
open-source <ulink
@@ -4545,7 +4545,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<para>The Open Group has released the source code to &motif; 2.1.30.
You can install the <literal>open-motif</literal> package, or
compile it from ports. Refer to
- <ulink url="../handbook/ports.html">the ports section of the
+ <ulink url="&url.books.handbook;/ports.html">the ports section of the
Handbook</ulink> for more information on how to do this.
@@ -5197,7 +5197,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<emphasis>always</emphasis> update the
<literal>ports-base</literal> subcollection too! The reasons
are described <ulink
- url="../handbook/cvsup.html#CVSUP-COLLEC-PBASE-WARN">in the
+ url="&url.books.handbook;/cvsup.html#CVSUP-COLLEC-PBASE-WARN">in the
@@ -5237,7 +5237,7 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<para>Not at all! Check out the <ulink
- URL="../handbook/kernelconfig.html">
+ URL="&url.books.handbook;/kernelconfig.html">
kernel config section of the Handbook</ulink>.</para>
@@ -5442,7 +5442,7 @@ device sio5 at isa? port 0x2b8 tty flags 0x501 vector siointr</programlisting>
<para>See the Disk Formatting Tutorial at <ulink
- URL="../../articles/formatting-media/index.html">
+ URL="&url.articles.formatting-media;/index.html">
@@ -5470,7 +5470,7 @@ device sio5 at isa? port 0x2b8 tty flags 0x501 vector siointr</programlisting>
on both disks with &man.boot0cfg.8;, so that you can
dual boot to the old or new system after the copying
is done. See the <ulink
- url="../../articles/formatting-media/index.html">
+ url="&url.articles.formatting-media;/index.html">
formatting-media article</ulink> for details on this
@@ -6074,9 +6074,9 @@ C:\="DOS"</programlisting>
<para>You have to tell &man.mount.8; the type of the device
that you want to mount. This is described in the <ulink
- URL="../handbook/creating-cds.html"> Handbook section on
+ URL="&url.books.handbook;/creating-cds.html"> Handbook section on
optical media</ulink>, specifically the section <ulink
- URL="../handbook/creating-cds.html#MOUNTING-CD">Using Data
+ URL="&url.books.handbook;/creating-cds.html#MOUNTING-CD">Using Data
@@ -6091,7 +6091,7 @@ C:\="DOS"</programlisting>
<para>This generally means that there is no CDROM in the
CDROM drive, or the drive is not visible on the
bus. Please see the <ulink
- URL="../handbook/creating-cds.html#MOUNTING-CD">Using Data
+ URL="&url.books.handbook;/creating-cds.html#MOUNTING-CD">Using Data
CDs</ulink> section of the Handbook for a detailed
discussion of this issue.</para>
@@ -6107,9 +6107,9 @@ C:\="DOS"</programlisting>
<para>Your CDROM probably uses the <quote>Joliet</quote>
extension for storing information about files and
directories. This is discussed in the Handbook chapter on
- <ulink URL="../handbook/creating-cds.html">creating and
+ <ulink URL="&url.books.handbook;/creating-cds.html">creating and
using CDROMs</ulink>, specifically the section on <ulink
- URL="../handbook/creating-cds.html#MOUNTING-CD">Using Data
+ URL="&url.books.handbook;/creating-cds.html#MOUNTING-CD">Using Data
@@ -6123,10 +6123,10 @@ C:\="DOS"</programlisting>
<para>You most likely burned a raw file to your CD, rather
than creating an ISO 9660 filesystem. Take a look at the
- <ulink URL="../handbook/creating-cds.html">Handbook
+ <ulink URL="&url.books.handbook;/creating-cds.html">Handbook
chapter on creating CDROMs</ulink>, particularly the
section on <ulink
- URL="../handbook/creating-cds.html#RAWDATA-CD">burning raw
+ URL="&url.books.handbook;/creating-cds.html#RAWDATA-CD">burning raw
data CDs</ulink>.</para>
@@ -6138,9 +6138,9 @@ C:\="DOS"</programlisting>
<para>This is discussed in the Handbook section on <ulink
- url="../handbook/creating-cds.html#IMAGING-CD">duplicating
+ url="&url.books.handbook;/creating-cds.html#IMAGING-CD">duplicating
data CDs</ulink>. For more on working with CDROMs, see the
- <ulink url="../handbook/creating-cds.html">Creating CDs
+ <ulink url="&url.books.handbook;/creating-cds.html">Creating CDs
Section</ulink> in the Storage chapter in the
@@ -6310,10 +6310,10 @@ C:\="DOS"</programlisting>
<para>In the <ulink
- url="../handbook/config-tuning.html">Configuration and
+ url="&url.books.handbook;/config-tuning.html">Configuration and
Tuning</ulink> section of the Handbook, you will find a
- url="../handbook/adding-swap-space.html">section</ulink>
+ url="&url.books.handbook;/adding-swap-space.html">section</ulink>
describing how to do this.</para>
@@ -6504,7 +6504,7 @@ C:\="DOS"</programlisting>
<para>Please have a look at the Handbook entry on printing. It
should cover most of your problem. See the <ulink
- URL="../handbook/printing.html">
+ URL="&url.books.handbook;/printing.html">
Handbook entry on printing</ulink>.</para>
<para>Some printers require a host-based driver to do any
@@ -6525,9 +6525,9 @@ C:\="DOS"</programlisting>
<para>Please see the Handbook section on <ulink
- url="../handbook/using-localization.html">using
+ url="&url.books.handbook;/using-localization.html">using
localization</ulink>, specifically the section on <ulink
- url="../handbook/using-localization.html#SETTING-CONSOLE">console
+ url="&url.books.handbook;/using-localization.html#SETTING-CONSOLE">console
@@ -6935,7 +6935,7 @@ options SYSVMSG # enable for messaging</programlisting>
<para>For more information on version numbers and the
various CVS branches, refer to the
- <ulink url="../../articles/releng/article.html">Release
+ <ulink url="&url.articles.releng;/article.html">Release
Engineering</ulink> article.</para>
@@ -8319,7 +8319,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para><quote>Diskless booting</quote> means that the FreeBSD
box is booted over a network, and reads the necessary files
from a server instead of its hard disk. For full details,
- please read <ulink URL="../handbook/diskless.html">the
+ please read <ulink URL="&url.books.handbook;/diskless.html">the
Handbook entry on diskless booting</ulink></para>
@@ -8332,9 +8332,9 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>Yes. Please see the Handbook entry on <ulink
- url="../handbook/advanced-networking.html"> advanced
+ url="&url.books.handbook;/advanced-networking.html"> advanced
networking</ulink>, specifically the section on <ulink
- url="../handbook/network-routing.html">routing
+ url="&url.books.handbook;/network-routing.html">routing
and gateways</ulink>.</para>
@@ -8363,13 +8363,13 @@ Key F15 A A Menu Workplace Nop</programlisting>
<filename>/etc/rc.conf</filename>, and configure your
&windows; machine correctly, this should work fine. For more
information, please see the &man.ppp.8; manual page or the
- <ulink url="../handbook/userppp.html">Handbook entry on
+ <ulink url="&url.books.handbook;/userppp.html">Handbook entry on
user PPP</ulink>.</para>
<para>If you are using kernel-mode PPP or have an Ethernet
connection to the Internet, you need to use
&man.natd.8;. Please look at the <ulink
- url="../handbook/network-natd.html">natd</ulink> section
+ url="&url.books.handbook;/network-natd.html">natd</ulink> section
of the Handbook for a tutorial.</para>
@@ -8388,7 +8388,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
with outgoing connections.</para>
<para>For more information on how to use these, please see the
- <ulink url="../handbook/ppp-and-slip.html">Handbook chapter on
+ <ulink url="&url.books.handbook;/ppp-and-slip.html">Handbook chapter on
PPP and SLIP</ulink>.</para>
<para>If you only have access to the Internet through a
@@ -8408,10 +8408,10 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>Yes. If you want to use NAT over a user PPP
connection, please see the <ulink
- url="../handbook/userppp.html">Handbook entry on user
+ url="&url.books.handbook;/userppp.html">Handbook entry on user
PPP</ulink>. If you want to use NAT over some other sort
of network connection, please look at the <ulink
- url="../handbook/network-natd.html">natd</ulink> section
+ url="&url.books.handbook;/network-natd.html">natd</ulink> section
of the Handbook.</para>
@@ -8423,7 +8423,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
- <para>Please see the <ulink url="../handbook/plip.html">PLIP
+ <para>Please see the <ulink url="&url.books.handbook;/plip.html">PLIP
section</ulink> of the Handbook.</para>
@@ -8496,7 +8496,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
it mildly) and can sometimes cause problems with network
intensive applications like NFS.</para>
- <para>See <ulink URL="../handbook/nfs.html">
+ <para>See <ulink URL="&url.books.handbook;/nfs.html">
the Handbook entry on NFS</ulink> for more information on
this topic.</para>
@@ -8540,9 +8540,9 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>The most frequent problem is not understanding the
correct format of <filename>/etc/exports</filename>.
Please review &man.exports.5; and the <ulink
- url="../handbook/nfs.html">NFS</ulink> entry in the
+ url="&url.books.handbook;/nfs.html">NFS</ulink> entry in the
Handbook, especially the section on <ulink
- url="../handbook/nfs.html#CONFIGURING-NFS">configuring
+ url="&url.books.handbook;/nfs.html#CONFIGURING-NFS">configuring
@@ -8756,7 +8756,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>For further information on configuring a FreeBSD
- firewall, see the <ulink URL="../handbook/firewalls.html">
+ firewall, see the <ulink URL="&url.books.handbook;/firewalls.html">
Handbook section</ulink>.</para>
@@ -8768,9 +8768,9 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>Please see the Handbook's <ulink
- url="../handbook/firewalls.html">Firewalls</ulink>
+ url="&url.books.handbook;/firewalls.html">Firewalls</ulink>
section, specifically the section on <ulink
- url="../handbook/firewalls.html#IPFW-OVERHEAD">IPFW
+ url="&url.books.handbook;/firewalls.html#IPFW-OVERHEAD">IPFW
Overhead & Optimization</ulink>.</para>
@@ -8867,7 +8867,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<screen>&prompt.root; <userinput>sh MAKEDEV bpf0</userinput></screen>
<para>Please see the <ulink
- URL="../handbook/kernelconfig-nodes.html"> Handbook entry
+ URL="&url.books.handbook;/kernelconfig-nodes.html"> Handbook entry
on device nodes</ulink> for more information on managing
@@ -9285,7 +9285,7 @@ Key F15 A A Menu Workplace Nop</programlisting>
<para>You should first read the &man.ppp.8; manual page and
- the <ulink URL="../handbook/ppp-and-slip.html#USERPPP">
+ the <ulink URL="&url.books.handbook;/ppp-and-slip.html#USERPPP">
PPP section of the handbook</ulink>. Enable logging with
the command</para>
@@ -9384,7 +9384,7 @@ default UGSc 0 0 tun0
<para>from <filename>ppp.conf</filename>. If this is the
case, go back to the <ulink
- URL="../handbook/ppp-and-slip.html#USERPPP-FINAL"> Final
+ URL="&url.books.handbook;/ppp-and-slip.html#USERPPP-FINAL"> Final
system configuration</ulink> section of the
@@ -9414,7 +9414,7 @@ default UGSc 0 0 tun0
add 0 0 HISADDR</programlisting>
<para>Refer to the <ulink
- URL="../handbook/ppp-and-slip.html#USERPPP-DYNAMICIP">
+ URL="&url.books.handbook;/ppp-and-slip.html#USERPPP-DYNAMICIP">
PPP and Dynamic IP addresses</ulink> section of the handbook
for further details.</para>
@@ -9866,7 +9866,7 @@ set dfilter 3 permit 0/0 0/0</programlisting>
time, &man.sendmail.8; is the culprit. You should make
sure that you tell sendmail not to do any DNS lookups in
its configuration file. See the section on <ulink
- URL="../handbook/smtp-dialup.html">using email with a
+ URL="&url.books.handbook;/smtp-dialup.html">using email with a
dialup connection</ulink> in the FreeBSD Handbook for
details on how to create your own configuration file and
what should go into it. You may also want to add the
@@ -11202,7 +11202,7 @@ raisechar=^^</programlisting>
- <para>See the <ulink url="../fdp-primer/translations.html">
+ <para>See the <ulink url="&url.books.fdp-primer;/translations.html">
Translation FAQ</ulink> in the FreeBSD Documentation Project
@@ -11318,7 +11318,7 @@ raisechar=^^</programlisting>
<para>SUP is not bandwidth friendly, and has been retired.
The current recommended method to keep your sources up to
- date is <ulink URL="../handbook/synching.html#CVSUP">
+ date is <ulink URL="&url.books.handbook;/synching.html#CVSUP">
@@ -11784,7 +11784,7 @@ raisechar=^^</programlisting>
BSD-specific books that are still relevant.</para>
<para>For a list, please check the Handbook's <ulink
- URL="../handbook/bibliography-osinternals.html">Operating
+ URL="&url.books.handbook;/bibliography-osinternals.html">Operating
System Internals Bibliography</ulink>.</para>
@@ -11796,7 +11796,7 @@ raisechar=^^</programlisting>
<para>Please see the article on <ulink
- url="../../articles/contributing/article.html">Contributing
+ url="&url.articles.contributing;/article.html">Contributing
to FreeBSD</ulink> for specific advice on how to do this.
Assistance is more than welcome!</para>
@@ -11854,7 +11854,7 @@ raisechar=^^</programlisting>
<para>Please see the <ulink
- url="../../articles/releng/article.html">
+ url="&url.articles.releng;/article.html">
Release Engineering</ulink> article.</para>
@@ -11928,7 +11928,7 @@ raisechar=^^</programlisting>
<para>Yes, you can do this <emphasis>without</emphasis>
downloading the whole source tree by using the <ulink
- URL="../handbook/synching.html#CTM">CTM facility</ulink>.</para>
+ URL="&url.books.handbook;/synching.html#CTM">CTM facility</ulink>.</para>
@@ -11962,7 +11962,7 @@ ${RELEASEDIR}/tarballs/bindist/bin_tgz.)</programlisting>
<para>Please take a look at the article on <ulink
- URL="../../articles/contributing/article.html">Contributing
+ URL="&url.articles.contributing;/article.html">Contributing
to FreeBSD</ulink> to learn how to submit code.</para>
<para>And thanks for the thought!</para>
diff --git a/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml
index 074ae66502..0ce1e28bd8 100644
--- a/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml
@@ -48,7 +48,7 @@
- <para><ulink url="../handbook/index.html">The FreeBSD Handbook</ulink></para>
+ <para><ulink url="&url.books.handbook;/index.html">The FreeBSD Handbook</ulink></para>
diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
index a75a153da6..f92e1f7fbc 100644
--- a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
@@ -757,9 +757,9 @@
<para>The <ulink url="&url.base;/docs.html">FreeBSD
tutorials</ulink> are all marked up as articles, while this
- document, the <ulink url="../faq/index.html">FreeBSD
+ document, the <ulink url="&url.books.faq;/index.html">FreeBSD
FAQ</ulink>, and the <ulink
- url="../handbook/index.html">FreeBSD Handbook</ulink> are
+ url="&url.books.handbook;/index.html">FreeBSD Handbook</ulink> are
all marked up as books.</para>
diff --git a/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
index 64bcc18e80..9444ecc7af 100644
--- a/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
+++ b/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
@@ -52,7 +52,7 @@
<para>Set up a CVS repository. You need the directories www, doc and
ports in the CVS tree (plus the CVSROOT of course). Please read the
- <ulink url="../handbook/synching.html#CVSUP">CVSup introduction</ulink>
+ <ulink url="&url.books.handbook;/synching.html#CVSUP">CVSup introduction</ulink>
on how to mirror a CVS tree or parts of a CVS tree.</para>
<para>The essential cvsup collections are: <literal>www</literal>,
diff --git a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml
index f0685ad971..a82702f84c 100644
--- a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml
@@ -2739,7 +2739,7 @@ host margaux {
you need a good serial card in your computer.</para>
<para>You should read the <ulink
- url="../../articles/serial-uart/index.html">FreeBSD Serial
+ url="&url.articles.serial-uart;/index.html">FreeBSD Serial
Hardware</ulink> tutorial for a detailed understanding of
serial devices, and the differences between asynchronous and
synchronous serial ports.</para>
diff --git a/en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml b/en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml
index 74c259089e..9647102c58 100644
--- a/en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/bibliography/chapter.sgml
@@ -181,7 +181,7 @@
PostScript format.</para>
<para>An Italian <ulink
- url="../../../it_IT.ISO8859-15/books/unix-introduction/index.html">translation</ulink>
+ url="&url.doc.base;/it_IT.ISO8859-15/books/unix-introduction/index.html">translation</ulink>
of this document is available as part of the FreeBSD Italian
Documentation Project.</para>
@@ -374,7 +374,7 @@
Addison-Wesley, 1996. ISBN 0-201-54979-4</para>
<para>(Chapter 2 of this book is available <ulink
- url="../design-44bsd/book.html">online</ulink> as part of
+ url="&url.books.design-44bsd;/book.html">online</ulink> as part of
the FreeBSD Documentation Project, and chapter 9 <ulink
diff --git a/en_US.ISO8859-1/books/handbook/config/chapter.sgml b/en_US.ISO8859-1/books/handbook/config/chapter.sgml
index e7fed431e5..6f1ef25728 100644
--- a/en_US.ISO8859-1/books/handbook/config/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/config/chapter.sgml
@@ -557,7 +557,7 @@ HOME=/var/log
editor: the <command>cron</command> utility will notice that the file
has changed and immediately begin using the updated version.
- <ulink url="../faq/admin.html#ROOT-NOT-FOUND-CRON-ERRORS">
+ <ulink url="&url.books.faq;/admin.html#ROOT-NOT-FOUND-CRON-ERRORS">
this FAQ entry </ulink> for more information.</para>
diff --git a/en_US.ISO8859-1/books/handbook/install/chapter.sgml b/en_US.ISO8859-1/books/handbook/install/chapter.sgml
index f9f2a06c9c..8c46e4cc8d 100644
--- a/en_US.ISO8859-1/books/handbook/install/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/install/chapter.sgml
@@ -5477,7 +5477,7 @@ Please press any key to reboot.</screen>
specific to your modem, as the PPP dialer provides only a very
simple terminal emulator. Please refer to the user-ppp <link
linkend="userppp">handbook</link> and <ulink
- url="../faq/ppp.html">FAQ</ulink> entries for further information.
+ url="&url.books.faq;/ppp.html">FAQ</ulink> entries for further information.
If you have problems, logging can be directed to the screen using
the command <command>set log local ...</command>.</para>
diff --git a/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml b/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml
index 3d6aa38b12..77de3f4724 100644
--- a/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml
@@ -60,7 +60,7 @@
or the <link linkend="relnotes">current release</link>. If you
are interested in contributing something to the Project (code,
hardware, unmarked bills), see the <ulink
- url="../../articles/contributing/index.html">Contributing to FreeBSD</ulink> article.</para>
+ url="&url.articles.contributing;/index.html">Contributing to FreeBSD</ulink> article.</para>
<sect2 id="os-overview">
<title>What Can FreeBSD Do?</title>
@@ -690,7 +690,7 @@
process, being literally built from the contributions
of hundreds of people around the world, as can be seen from
our <ulink
- url="../../articles/contributors/article.html">list of
+ url="&url.articles.contributors;/article.html">list of
contributors</ulink>. FreeBSD's development infrastructure allow
these hundreds of developers to collaborate over the Internet.
We are constantly on the lookout for
@@ -777,7 +777,7 @@
ensuring that some large portion of the system works as
advertised. For a complete list of FreeBSD developers
and their areas of responsibility, please see the <ulink
- url="../../articles/contributors/article.html">Contributors
+ url="&url.articles.contributors;/article.html">Contributors
@@ -809,7 +809,7 @@
the various FreeBSD mailing lists.</para>
- url="../../articles/contributors/article.html">The
+ url="&url.articles.contributors;/article.html">The
FreeBSD Contributors List</ulink></citetitle> is a long
and growing one, so why not join it by contributing
something back to FreeBSD today?</para>
diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index 4262bf80e5..cbbc3ba36b 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -751,7 +751,7 @@ docbook =
<filename>pkg-message</filename>. The ports system uses these
files to handle special situations. If you want more details
on these files, and on ports in general, check out the <ulink
- url="../porters-handbook/index.html">FreeBSD Porter's
+ url="&url.books.porters-handbook;/index.html">FreeBSD Porter's
<para>The port includes instructions on how to build source
@@ -1262,7 +1262,7 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<para>Fix it! The <ulink
- url="../porters-handbook/index.html">Porter's
+ url="&url.books.porters-handbook;/index.html">Porter's
Handbook</ulink> includes detailed information on the
<quote>Ports</quote> infrastructure so that you can fix the occasional
broken port or even submit your own!</para>
diff --git a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
index d1983ca314..bbdda1767c 100644
--- a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
@@ -2092,7 +2092,7 @@ raisechar=^^</programlisting>
use as the serial console. The only use of this
flag is to designate the unit for kernel remote
debugging. See <ulink
- url="../developers-handbook/index.html">The
+ url="&url.books.developers-handbook;/index.html">The
Developer's Handbook</ulink> for more information on
remote debugging.</para>
diff --git a/en_US.ISO8859-1/books/porters-handbook/Makefile b/en_US.ISO8859-1/books/porters-handbook/Makefile
index b31fb33fb5..c0ffab6a1e 100644
--- a/en_US.ISO8859-1/books/porters-handbook/Makefile
+++ b/en_US.ISO8859-1/books/porters-handbook/Makefile
@@ -37,5 +37,7 @@ IMAGES_LIB+= callouts/8.png
IMAGES_LIB+= callouts/9.png
IMAGES_LIB+= callouts/10.png
+URL_RELPREFIX?= ../../../..
DOC_PREFIX?= ${.CURDIR}/../../..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 3fe9cf6cf5..d070d44550 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -18,7 +18,8 @@
<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN">
+<!ENTITY % urls PUBLIC "-//FreeBSD//ENTITIES DocBook URL Entities//EN">
@@ -368,7 +369,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
directory or the <filename>pkgname.tgz</filename> package, so delete
them now. Next, simply include the output of <command>shar `find
port_dir`</command> in a bug report and send it with the
- &man.send-pr.1; program (see <ulink url="../../articles/contributing/contrib-how.html#CONTRIB-GENERAL">Bug
+ &man.send-pr.1; program (see <ulink url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">Bug
Reports and General Commentary</ulink> for more information about
&man.send-pr.1;). If the uncompressed port is larger than 20KB,
you should compress it into a tarfile and use &man.uuencode.1;
@@ -408,7 +409,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<para>Once we have looked at your port, we will get back to you if necessary, and put
it in the tree. Your name will also appear in the list of
- <ulink url="../../articles/contributors/contrib-additional.html">Additional FreeBSD Contributors</ulink>
+ <ulink url="&url.articles.contributors;/contrib-additional.html">Additional FreeBSD Contributors</ulink>
and other files. Isn't that great?!? <!-- smiley
@@ -2844,7 +2845,7 @@ PATCHFILES= patch1:test</programlisting>
into your <filename>pkg-descr</filename>.</para>
<para>For a detailed description of the responsibilities of maintainers,
- refer to the <ulink url="../developers-handbook/policies.html#POLICIES-MAINTAINER">MAINTAINER on
+ refer to the <ulink url="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">MAINTAINER on
Makefiles</ulink> section.</para>
<para>If the maintainer of a port does not respond to an update
@@ -4775,7 +4776,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300
<chapter id="shared">
<title>Shared library versions</title>
- <para>Please read our <ulink url="../developers-handbook/policies-shlib.html">policy on
+ <para>Please read our <ulink url="&url.books.developers-handbook;/policies-shlib.html">policy on
shared library versioning</ulink> to understand what to do with
shared library versions in general. Do not blindly assume software
authors know what they are doing; many of them do not. It is very
@@ -5336,7 +5337,7 @@ IGNORE=POINTYHAT is not supported
ports, you will probably find it easier to use
<application>CVSup</application> to keep your whole ports collection
up-to-date, as described in the
- <ulink url="../handbook/synching.html#CVSUP-CONFIG">Handbook</ulink>.
+ <ulink url="&url.books.handbook;/synching.html#CVSUP-CONFIG">Handbook</ulink>.
This will have the added benefit of tracking all the ports'
@@ -5395,7 +5396,7 @@ IGNORE=POINTYHAT is not supported
and this is an area where more volunteers are always needed.
(For a detailed description of the responsibilities of maintainers,
refer to the
- <ulink url="../developers-handbook/policies.html#POLICIES-MAINTAINER">
+ <ulink url="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">
MAINTAINER on Makefiles</ulink> section.)</para>
<para> The best way to
@@ -5413,7 +5414,7 @@ IGNORE=POINTYHAT is not supported
as is.</para>
<para>Before you &man.send-pr.1;, you should review the
- <ulink url="../../articles/problem-reports/pr-writing.html">
+ <ulink url="&url.articles.problem-reports;/pr-writing.html">
Writing the problem report</ulink> section in the Problem
Reports article; it contains far more information about how to write
useful problem reports.</para>
@@ -5965,7 +5966,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
the porting process. You should check your own port against this list,
but you can also check ports in the <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">PR database</ulink> that others have
submitted. Submit any comments on ports you check as described in
- <ulink url="../../articles/contributing/contrib-how.html#CONTRIB-GENERAL">Bug Reports and General
+ <ulink url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">Bug Reports and General
Commentary</ulink>. Checking ports in the PR database will both make
it faster for us to commit them, and prove that you know what you are
@@ -6036,7 +6037,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<para>Do not write anything to files outside
<makevar>WRKDIR</makevar>. <makevar>WRKDIR</makevar> is the only
place that is guaranteed to be writable during the port build (see
- <ulink url="../handbook/ports-using.html#PORTS-CD">
+ <ulink url="&url.books.handbook;/ports-using.html#PORTS-CD">
installing ports from a CDROM</ulink> for an
example of building ports from a read-only tree). If you need to
modify one of the <filename>pkg-<replaceable>*</replaceable></filename>