aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/mirrors
diff options
context:
space:
mode:
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/mirrors')
-rw-r--r--en_US.ISO8859-1/books/handbook/mirrors/chapter.xml243
1 files changed, 106 insertions, 137 deletions
diff --git a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
index f46b6db93e..4a8bf7c0c3 100644
--- a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
@@ -4,11 +4,10 @@
$FreeBSD$
-->
-
-<appendix id="mirrors">
+<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="mirrors">
<title>Obtaining &os;</title>
- <sect1 id="mirrors-cdrom">
+ <sect1 xml:id="mirrors-cdrom">
<title>CDROM and DVD Publishers</title>
<sect2>
@@ -20,7 +19,7 @@
<itemizedlist>
<listitem>
<address>
- <otheraddr>&os; Mall, Inc.</otheraddr>
+ &os; Mall, Inc.
<street>2420 Sand Creek Rd C-1 #347</street>
<city>Brentwood</city>,
<state>CA</state>
@@ -29,72 +28,67 @@
Phone: <phone>+1 925 240-6652</phone>
Fax: <fax>+1 925 674-0821</fax>
Email: <email>info@freebsdmall.com</email>
- WWW: <otheraddr><ulink
- url="http://www.freebsdmall.com/"></ulink></otheraddr>
+ WWW: <otheraddr xlink:href="http://www.freebsdmall.com/">http://www.freebsdmall.com/</otheraddr>
</address>
</listitem>
<listitem>
<address>
- <otheraddr>Dr. Hinner EDV</otheraddr>
+ Dr. Hinner EDV
<street>Kochelseestr. 11</street>
<postcode>D-81371</postcode> <city>M&uuml;nchen</city>
<country>Germany</country>
Phone: <phone>(0177) 428 419 0</phone>
- WWW: <otheraddr><ulink
- url="http://www.hinner.de/linux/freebsd.html"></ulink></otheraddr>
+ WWW: <otheraddr xlink:href="http://www.hinner.de/linux/freebsd.html">http://www.hinner.de/linux/freebsd.html</otheraddr>
</address>
</listitem>
<listitem>
<address>
- <otheraddr>Linux Distro UK</otheraddr>
+ Linux Distro UK
<street>42 Wharfedale Road</street>
<city>Margate</city>
<postcode>CT9 2TB</postcode>
<country>United Kingdom</country>
- WWW: <otheraddr><ulink
- url="https://linux-distro.co.uk/"></ulink></otheraddr>
+ WWW: <otheraddr xlink:href="https://linux-distro.co.uk/">https://linux-distro.co.uk/</otheraddr>
</address>
</listitem>
<listitem>
<address>
- <otheraddr>The Linux Emporium</otheraddr>
+ The Linux Emporium
<street>The Techno Centre, Puma Way</street>
<city>Parkside</city>
<postcode>CV1 2TT</postcode>
<country>United Kingdom</country>
Phone: <phone>+44 (0)247 615 8121</phone>
Fax: <fax>+44 1491 837016</fax>
- WWW: <otheraddr><ulink
- url="http://www.linuxemporium.co.uk/products/bsd/"></ulink></otheraddr>
+ WWW: <otheraddr xlink:href="http://www.linuxemporium.co.uk/products/bsd/">http://www.linuxemporium.co.uk/products/bsd/</otheraddr>
</address>
</listitem>
<listitem>
<address>
- <otheraddr>LinuxCenter.Ru</otheraddr>
+ LinuxCenter.Ru
<street>Galernaya Street, 55</street>
<city>Saint-Petersburg</city>
<postcode>190000</postcode>
<country>Russia</country>
Phone: <phone>+7-812-3125208</phone>
Email: <email>info@linuxcenter.ru</email>
- WWW: <otheraddr><ulink
- url="http://linuxcenter.ru/shop/freebsd"></ulink></otheraddr>
+ WWW: <otheraddr xlink:href="http://linuxcenter.ru/shop/freebsd">http://linuxcenter.ru/shop/freebsd</otheraddr>
</address>
</listitem>
</itemizedlist>
</sect2>
</sect1>
- <sect1 id="mirrors-ftp">
+ <sect1 xml:id="mirrors-ftp">
<title>FTP Sites</title>
<para>The official sources for &os; are available via anonymous
FTP from a worldwide set of mirror sites. The site
- <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/"></ulink> is well
+ <uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/">ftp://ftp.FreeBSD.org/pub/FreeBSD/</uri> is well
connected and allows a large number of connections to it, but
you are probably better off finding a <quote>closer</quote>
mirror site (especially if you decide to set up some sort of
@@ -121,7 +115,7 @@
&chap.mirrors.ftp.inc;
</sect1>
- <sect1 id="anoncvs">
+ <sect1 xml:id="anoncvs">
<title>Anonymous CVS (Deprecated)</title>
<sect2>
@@ -130,13 +124,13 @@
<warning>
<para>CVS has been deprecated by the project, and its use is
not recommended.
- <ulink url="&url.books.handbook;/svn.html">Subversion</ulink>
+ <link xlink:href="&url.books.handbook;/svn.html">Subversion</link>
should be used instead.</para>
</warning>
</sect2>
</sect1>
- <sect1 id="ctm">
+ <sect1 xml:id="ctm">
<title>Using CTM</title>
<indexterm>
@@ -176,8 +170,7 @@
caveats related to working directly from the development
sources rather than a pre-packaged release. This is
particularly true if you choose the <quote>current</quote>
- sources. It is recommended that you read <link
- linkend="current">Staying current with &os;</link>.</para>
+ sources. It is recommended that you read <link linkend="current">Staying current with &os;</link>.</para>
</sect2>
<sect2>
@@ -200,11 +193,9 @@
the following FTP sites support access to
<application>CTM</application>:</para>
- <para><ulink
- url="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>
- <para>or see section <link
- linkend="mirrors-ctm">mirrors</link>.</para>
+ <para>or see section <link linkend="mirrors-ctm">mirrors</link>.</para>
<para>FTP the relevant directory and fetch the
<filename>README</filename> file, starting from there.</para>
@@ -428,7 +419,7 @@
been all that high yet.</para>
</sect2>
- <sect2 id="mirrors-ctm">
+ <sect2 xml:id="mirrors-ctm">
<title>CTM Mirrors</title>
<para><link linkend="ctm">CTM</link>/&os; is available via
@@ -446,8 +437,7 @@
<listitem>
<itemizedlist>
<listitem>
- <para><ulink
- url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>
</listitem>
</itemizedlist>
</listitem>
@@ -459,8 +449,7 @@
<listitem>
<itemizedlist>
<listitem>
- <para><ulink
- url="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/">ftp://ftp.za.FreeBSD.org/pub/FreeBSD/CTM/</uri></para>
</listitem>
</itemizedlist>
</listitem>
@@ -472,18 +461,15 @@
<listitem>
<itemizedlist>
<listitem>
- <para><ulink
- url="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>
</listitem>
<listitem>
- <para><ulink
- url="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm2.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>
</listitem>
<listitem>
- <para><ulink
- url="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/"></ulink></para>
+ <para><uri xlink:href="ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/">ftp://ctm3.tw.FreeBSD.org/pub/FreeBSD/development/CTM/</uri></para>
</listitem>
</itemizedlist>
</listitem>
@@ -491,33 +477,29 @@
</variablelist>
<para>If you did not find a mirror near to you or the mirror is
- incomplete, try to use a search engine such as <ulink
- url="http://www.alltheweb.com/">alltheweb</ulink>.</para>
+ incomplete, try to use a search engine such as <link xlink:href="http://www.alltheweb.com/">alltheweb</link>.</para>
</sect2>
</sect1>
- <sect1 id="svn">
+ <sect1 xml:id="svn">
<title>Using <application>Subversion</application></title>
<indexterm>
<primary>Subversion</primary>
</indexterm>
- <sect2 id="svn-intro">
+ <sect2 xml:id="svn-intro">
<title>Introduction</title>
- <para>As of July 2012, &os; uses <ulink
- url="http://subversion.apache.org/">Subversion</ulink>
+ <para>As of July 2012, &os; uses <link xlink:href="http://subversion.apache.org/">Subversion</link>
(<emphasis>svn</emphasis>) as the primary version control
system for storing all of &os;'s source code, documentation,
and the Ports Collection.</para>
<note>
<para>Subversion is generally a developer tool. Most users
- should use <link
- linkend="updating-upgrading-freebsdupdate">FreeBSD
- Update</link> to update the &os; base system, and <link
- linkend="updating-upgrading-portsnap">Portsnap</link> to
+ should use <link linkend="updating-upgrading-freebsdupdate">FreeBSD
+ Update</link> to update the &os; base system, and <link linkend="updating-upgrading-portsnap">Portsnap</link> to
update the &os; Ports Collection.</para>
</note>
@@ -532,11 +514,11 @@
documentation. For example, the URL
<literal>svn://svn0.us-east.FreeBSD.org/ports/head/</literal>
specifies the main branch of the ports repository on the
- <hostid role="fqdn">svn0.us-east.FreeBSD.org</hostid> mirror,
+ <systemitem class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem> mirror,
using the <literal>svn</literal> protocol.</para>
</sect2>
- <sect2 id="svn-install">
+ <sect2 xml:id="svn-install">
<title>Installation</title>
<para><application>Subversion</application> must be installed
@@ -561,7 +543,7 @@
<screen>&prompt.root; <userinput>pkg install devel/subversion</userinput></screen>
</sect2>
- <sect2 id="svn-usage">
+ <sect2 xml:id="svn-usage">
<title>Running <application>Subversion</application></title>
<para>The <command>svn</command> command is used to fetch a
@@ -581,7 +563,7 @@
<para>A checkout from a given repository is performed with a
command like this:</para>
- <screen>&prompt.root; <userinput>svn checkout <replaceable>svn-mirror</replaceable>/<replaceable>repository</replaceable>/<replaceable>branch</replaceable> <replaceable>lwcdir</replaceable></userinput></screen>
+ <screen>&prompt.root; <userinput>svn checkout svn-mirror/repository/branch lwcdir</userinput></screen>
<para>where:</para>
@@ -619,11 +601,11 @@
<para><replaceable>lwcdir</replaceable> is the target
directory where the contents of the specified branch
should be placed. This is usually
- <filename class="directory">/usr/ports</filename> for
+ <filename>/usr/ports</filename> for
<literal>ports</literal>,
- <filename class="directory">/usr/src</filename> for
+ <filename>/usr/src</filename> for
<literal>base</literal>, and
- <filename class="directory">/usr/doc</filename> for
+ <filename>/usr/doc</filename> for
<literal>doc</literal>.</para>
</listitem>
</itemizedlist>
@@ -631,12 +613,12 @@
<para>This example checks out the Ports Collection from the
western US repository using the <acronym>HTTPS</acronym>
protocol, placing the local working copy in
- <filename class="directory">/usr/ports</filename>. If
- <filename class="directory">/usr/ports</filename> is already
+ <filename>/usr/ports</filename>. If
+ <filename>/usr/ports</filename> is already
present but was not created by <command>svn</command>,
remember to rename or delete it before the checkout.</para>
- <screen>&prompt.root; <userinput>svn checkout <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/ports/head /usr/ports</userinput></screen>
+ <screen>&prompt.root; <userinput>svn checkout https://svn0.us-west.FreeBSD.org/ports/head /usr/ports</userinput></screen>
<para>Because the initial checkout has to download the full
branch of the remote repository, it can take a while. Please
@@ -645,10 +627,10 @@
<para>After the initial checkout, the local working copy can be
updated by running:</para>
- <screen>&prompt.root; <userinput>svn update <replaceable>lwcdir</replaceable></userinput></screen>
+ <screen>&prompt.root; <userinput>svn update lwcdir</userinput></screen>
<para>To update
- <filename class="directory">/usr/ports</filename> created in
+ <filename>/usr/ports</filename> created in
the example above, use:</para>
<screen>&prompt.root; <userinput>svn update /usr/ports</userinput></screen>
@@ -658,12 +640,12 @@
<para>An alternate way of updating the local working copy after
checkout is provided by the <filename>Makefile</filename> in
- the <filename class="directory">/usr/ports</filename>,
- <filename class="directory">/usr/src</filename>, and
- <filename class="directory">/usr/doc</filename> directories.
- Set <makevar>SVN_UPDATE</makevar> and use the
- <maketarget>update</maketarget> target. For example, to
- update <filename class="directory">/usr/src</filename>:</para>
+ the <filename>/usr/ports</filename>,
+ <filename>/usr/src</filename>, and
+ <filename>/usr/doc</filename> directories.
+ Set <varname>SVN_UPDATE</varname> and use the
+ <buildtarget>update</buildtarget> target. For example, to
+ update <filename>/usr/src</filename>:</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make update SVN_UPDATE=yes</userinput></screen>
@@ -675,14 +657,14 @@
<para>For other information about using
<application>Subversion</application>, please see the
<quote>Subversion Book</quote>, titled
- <ulink url="http://svnbook.red-bean.com/">Version Control with
- Subversion</ulink>, or the
- <ulink url="http://subversion.apache.org/docs/">Subversion
- Documentation</ulink>.</para>
+ <link xlink:href="http://svnbook.red-bean.com/">Version Control with
+ Subversion</link>, or the
+ <link xlink:href="http://subversion.apache.org/docs/">Subversion
+ Documentation</link>.</para>
</sect2>
</sect1>
- <sect1 id="svn-mirrors">
+ <sect1 xml:id="svn-mirrors">
<title><application>Subversion</application> Mirror Sites</title>
<indexterm>
@@ -693,12 +675,11 @@
<para>All mirrors carry all repositories.</para>
<para>The master &os; <application>Subversion</application>
- server, <hostid role="fqdn">svn.FreeBSD.org</hostid>, is
+ server, <systemitem class="fqdomainname">svn.FreeBSD.org</systemitem>, is
publicly accessible, read-only. That may change in the future,
so users are encouraged to use one of the official mirrors. To
view the &os; <application>Subversion</application> repositories
- through a browser, use <ulink
- url="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</ulink>.</para>
+ through a browser, use <link xlink:href="http://svnweb.FreeBSD.org/">http://svnweb.FreeBSD.org/</link>.</para>
<note>
<para>The &os; svn mirror network is still in its early days,
@@ -727,13 +708,10 @@
<tbody>
<row>
- <entry><hostid
- role="fqdn">svn0.us-west.FreeBSD.org</hostid></entry>
+ <entry><systemitem class="fqdomainname">svn0.us-west.FreeBSD.org</systemitem></entry>
- <entry>svn, <ulink
- url="http://svn0.us-west.FreeBSD.org/">http</ulink>,
- <ulink
- url="https://svn0.us-west.FreeBSD.org/">https</ulink></entry>
+ <entry>svn, <link xlink:href="http://svn0.us-west.FreeBSD.org/">http</link>,
+ <link xlink:href="https://svn0.us-west.FreeBSD.org/">https</link></entry>
<entry>USA, California</entry>
@@ -742,13 +720,10 @@
</row>
<row>
- <entry><hostid
- role="fqdn">svn0.us-east.FreeBSD.org</hostid></entry>
+ <entry><systemitem class="fqdomainname">svn0.us-east.FreeBSD.org</systemitem></entry>
- <entry>svn, <ulink
- url="http://svn0.us-east.FreeBSD.org/">http</ulink>,
- <ulink
- url="https://svn0.us-east.FreeBSD.org/">https</ulink>, rsync</entry>
+ <entry>svn, <link xlink:href="http://svn0.us-east.FreeBSD.org/">http</link>,
+ <link xlink:href="https://svn0.us-east.FreeBSD.org/">https</link>, rsync</entry>
<entry>USA, New Jersey</entry>
@@ -757,13 +732,10 @@
</row>
<row>
- <entry><hostid
- role="fqdn">svn0.eu.FreeBSD.org</hostid></entry>
+ <entry><systemitem class="fqdomainname">svn0.eu.FreeBSD.org</systemitem></entry>
- <entry>svn, <ulink
- url="http://svn0.eu.FreeBSD.org/">http</ulink>,
- <ulink
- url="https://svn0.eu.FreeBSD.org/">https</ulink>, rsync</entry>
+ <entry>svn, <link xlink:href="http://svn0.eu.FreeBSD.org/">http</link>,
+ <link xlink:href="https://svn0.eu.FreeBSD.org/">https</link>, rsync</entry>
<entry>Europe, UK</entry>
@@ -802,7 +774,7 @@ Certificate information:
the server, and the verification step will be repeated on the
next connection. Accepting the certificate permanently will
store the authentication credentials in
- <filename class="directory">~/.subversion/auth/</filename> and
+ <filename>~/.subversion/auth/</filename> and
the user will not be asked to verify the fingerprint again until
the certificate expires.</para>
@@ -812,10 +784,10 @@ Certificate information:
<acronym>HTTP</acronym>.</para>
</sect1>
- <sect1 id="cvsup">
+ <sect1 xml:id="cvsup">
<title>Using CVSup (Deprecated)</title>
- <sect2 id="cvsup-intro">
+ <sect2 xml:id="cvsup-intro">
<title>Introduction</title>
<warning>
@@ -867,17 +839,16 @@ Certificate information:
</note>
</sect2>
- <sect2 id="cvsup-install">
+ <sect2 xml:id="cvsup-install">
<title>Installation</title>
<para>The easiest way to install
<application>CVSup</application> is to use the precompiled
- <filename role="package">net/cvsup</filename> package from the
+ <package>net/cvsup</package> package from the
&os; <link linkend="ports">packages collection</link>. If you
prefer to build <application>CVSup</application> from source,
- you can use the <filename role="package">net/cvsup</filename>
- port instead. But be forewarned: the <filename
- role="package">net/cvsup</filename> port depends on the
+ you can use the <package>net/cvsup</package>
+ port instead. But be forewarned: the <package>net/cvsup</package> port depends on the
Modula-3 system, which takes a substantial amount of time and
disk space to download and build.</para>
@@ -887,19 +858,17 @@ Certificate information:
have <application>&xorg;</application> installed, such as a
server, be sure to use the port which does not include the
<application>CVSup</application> <acronym>GUI</acronym>,
- <filename
- role="package">net/cvsup-without-gui</filename>.</para>
+ <package>net/cvsup-without-gui</package>.</para>
</note>
</sect2>
- <sect2 id="cvsup-config">
+ <sect2 xml:id="cvsup-config">
<title>CVSup Configuration</title>
<para><application>CVSup</application>'s operation is controlled
by a configuration file called the
<filename>supfile</filename>. There are some sample
- <filename>supfiles</filename> in the directory <ulink
- url="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></ulink>.</para>
+ <filename>supfiles</filename> in the directory <link xlink:href="file://localhost/usr/share/examples/cvsup/"><filename>/usr/share/examples/cvsup/</filename></link>.</para>
<para>The information in a <filename>supfile</filename> answers
the following questions for
@@ -981,7 +950,7 @@ Certificate information:
<itemizedlist>
<listitem>
- <para><anchor id="cvsup-config-files"/>Which files do you
+ <para><anchor xml:id="cvsup-config-files"/>Which files do you
want to receive?</para>
<para>The files available via
@@ -1001,7 +970,7 @@ Certificate information:
</listitem>
<listitem>
- <para><anchor id="cvsup-config-vers"/>Which version(s) of
+ <para><anchor xml:id="cvsup-config-vers"/>Which version(s) of
them do you want?</para>
<para>With <application>CVSup</application>, you can receive
@@ -1080,7 +1049,7 @@ Certificate information:
</listitem>
<listitem>
- <para><anchor id="cvsup-config-where"/>Where do you want to
+ <para><anchor xml:id="cvsup-config-where"/>Where do you want to
get them from?</para>
<para>We use the <literal>host=</literal> field to tell
@@ -1090,7 +1059,7 @@ Certificate information:
will do, though you should try to select one that is close
to you in cyberspace. In this example we will use a
fictional &os; distribution site,
- <hostid role="fqdn">cvsup99.FreeBSD.org</hostid>:</para>
+ <systemitem class="fqdomainname">cvsup99.FreeBSD.org</systemitem>:</para>
<programlisting>*default host=cvsup99.FreeBSD.org</programlisting>
@@ -1103,7 +1072,7 @@ Certificate information:
</listitem>
<listitem>
- <para><anchor id="cvsup-config-dest"/>Where do you want to
+ <para><anchor xml:id="cvsup-config-dest"/>Where do you want to
put them on your own machine?</para>
<para>The <literal>prefix=</literal> field tells
@@ -1119,7 +1088,7 @@ Certificate information:
</listitem>
<listitem>
- <para><anchor id="cvsup-config-status"/>Where should
+ <para><anchor xml:id="cvsup-config-status"/>Where should
<command>cvsup</command> maintain its status files?</para>
<para>The <application>CVSup</application> client maintains
@@ -1191,7 +1160,7 @@ src-all</programlisting>
</listitem>
</itemizedlist>
- <sect3 id="cvsup-refuse-file">
+ <sect3 xml:id="cvsup-refuse-file">
<title>The <filename>refuse</filename> File</title>
<para>As mentioned above, <application>CVSup</application>
@@ -1214,7 +1183,7 @@ src-all</programlisting>
files from the server. The <filename>refuse</filename> file
can be found (or, if you do not yet have one, should be
placed) in
- <filename><replaceable>base</replaceable>/sup/</filename>.
+ <filename>base/sup/</filename>.
<replaceable>base</replaceable> is defined in your
<filename>supfile</filename>; our defined
<replaceable>base</replaceable> is
@@ -1245,10 +1214,10 @@ usr.bin/</programlisting>
<para>You are now ready to try an update. The command line for
doing this is quite simple:</para>
- <screen>&prompt.root; <userinput>cvsup <replaceable>supfile</replaceable></userinput></screen>
+ <screen>&prompt.root; <userinput>cvsup supfile</userinput></screen>
<para>where
- <filename><replaceable>supfile</replaceable></filename> is of
+ <filename>supfile</filename> is of
course the name of the <filename>supfile</filename> you have
just created. Assuming you are running under X11,
<command>cvsup</command> will display a GUI window with some
@@ -1257,7 +1226,7 @@ usr.bin/</programlisting>
<para>Since you are updating your actual
<filename>/usr/src</filename> tree in this example, you will
- need to run the program as <username>root</username> so that
+ need to run the program as <systemitem class="username">root</systemitem> so that
<command>cvsup</command> has the permissions it needs to
update your files. Having just created your configuration
file, and having never used this program before, that might
@@ -1280,14 +1249,14 @@ usr.bin/</programlisting>
versions of those files will be written into the specified
directory. As long as you have read access to
<filename>/usr/src</filename>, you do not even need to be
- <username>root</username> to perform this kind of trial
+ <systemitem class="username">root</systemitem> to perform this kind of trial
run.</para>
<para>If you are not running X11 or if you just do not like
GUIs, you should add a couple of options to the command line
when you run <command>cvsup</command>:</para>
- <screen>&prompt.root; <userinput>cvsup -g -L 2 <replaceable>supfile</replaceable></userinput></screen>
+ <screen>&prompt.root; <userinput>cvsup -g -L 2 supfile</userinput></screen>
<para>The <option>-g</option> tells
<application>CVSup</application> not to use its GUI. This is
@@ -1312,7 +1281,7 @@ usr.bin/</programlisting>
use its GUI when running it from &man.cron.8;.</para>
</sect2>
- <sect2 id="cvsup-collec">
+ <sect2 xml:id="cvsup-collec">
<title><application>CVSup</application> File Collections</title>
<para>The file collections available via
@@ -1658,8 +1627,8 @@ usr.bin/</programlisting>
<para>For the <application>CVSup</application> FAQ and other
information about <application>CVSup</application>, see
- <ulink url="http://www.cvsup.org">The
- CVSup Home Page</ulink>.</para>
+ <link xlink:href="http://www.cvsup.org">The
+ CVSup Home Page</link>.</para>
<para>Most &os;-related discussion of
<application>CVSup</application> takes place on the
@@ -1668,11 +1637,11 @@ usr.bin/</programlisting>
<para>For questions or bug reports about
<application>CVSup</application> take a look at the
- <ulink url="http://www.cvsup.org/faq.html#bugreports">
- CVSup FAQ</ulink>.</para>
+ <link xlink:href="http://www.cvsup.org/faq.html#bugreports">
+ CVSup FAQ</link>.</para>
</sect2>
- <sect2 id="cvsup-mirrors">
+ <sect2 xml:id="cvsup-mirrors">
<title>CVSup Sites</title>
<para><link linkend="cvsup">CVSup</link> servers for &os; are
@@ -1687,7 +1656,7 @@ usr.bin/</programlisting>
</sect2>
</sect1>
- <sect1 id="cvs-tags">
+ <sect1 xml:id="cvs-tags">
<title>CVS Tags</title>
<warning>
@@ -2096,16 +2065,16 @@ usr.bin/</programlisting>
<para>These tags refer to a specific point in time when a
particular version of &os; was released. The release
engineering process is documented in more detail by the
- <ulink url="&url.base;/releng/">Release Engineering
- Information</ulink> and
- <ulink url="&url.articles.releng;/release-proc.html">Release
- Process</ulink> documents. The
- <filename class="directory">src</filename> tree uses tag names
+ <link xlink:href="&url.base;/releng/">Release Engineering
+ Information</link> and
+ <link xlink:href="&url.articles.releng;/release-proc.html">Release
+ Process</link> documents. The
+ <filename>src</filename> tree uses tag names
that start with <literal>RELENG_</literal> tags. The
- <filename class="directory">ports</filename> and
- <filename class="directory">doc</filename> trees use tags
+ <filename>ports</filename> and
+ <filename>doc</filename> trees use tags
whose names begin with <literal>RELEASE</literal> tags.
- Finally, the <filename class="directory">www</filename> tree
+ Finally, the <filename>www</filename> tree
is not tagged with any special name for releases.</para>
<variablelist>
@@ -2528,7 +2497,7 @@ usr.bin/</programlisting>
</sect2>
</sect1>
- <sect1 id="mirrors-rsync">
+ <sect1 xml:id="mirrors-rsync">
<title><application>rsync</application> Sites</title>
<para>The following sites make &os; available through the rsync
@@ -2541,7 +2510,7 @@ usr.bin/</programlisting>
&os; FTP server, or the CVS repository. The
<application>rsync</application> suite is available for many
operating systems, on &os;, see the
- <filename role="package">net/rsync</filename>
+ <package>net/rsync</package>
port or use the package.</para>
<variablelist>