Start populating the handbook with useful cross reference targets.

All cross reference labels start with name of the file that contains
them.  A label for the top section level is simply the name of the
file (omitting the .sgml).  Other references within the file append a
colon and onother name.  For example, the label on the mailing list
section in the file eresources.sgml is eresources:mail.  This gives
each file its own cross reference namespace.
This commit is contained in:
John Fieber 1995-06-30 17:37:53 +00:00
parent d2a2d5ec41
commit 1e30867d53
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=9380
27 changed files with 74 additions and 75 deletions

View File

@ -1,10 +1,10 @@
<!-- $Id: basics.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: basics.sgml,v 1.2 1995/06/14 18:38:49 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>Unix Basics</heading>
<chapt><heading>Unix Basics<label id="basics"></heading>
<sect>
<heading>The online manual</heading>
<heading>The online manual<label id="basics:man"></heading>
<p>The most comprehensive documentation on FreeBSD is in
the form of <em>man pages</em>. Nearly every program
@ -60,7 +60,7 @@
descriptions.
<sect>
<heading>GNU Info files</heading>
<heading>GNU Info files<label id="basics:info"></heading>
<p>FreeBSD includes many applications and utilities
produced by the Free Software Foundation (FSF). In

View File

@ -1,8 +1,8 @@
<!-- $Id:$ -->
<!-- $Id: bibliography.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt>
<heading>Bibliography</heading>
<heading>Bibliography<label id="bibliography"></heading>
<p>While the manual pages provide the definative reference
for individual pieces of the FreeBSD operating system,

View File

@ -3,7 +3,7 @@
This conversion has been made by Ollivier Robert.
$Id: booting.sgml,v 1.2 1995/05/10 11:34:06 jfieber Exp $
$Id: booting.sgml,v 1.3 1995/06/14 18:38:50 jfieber Exp $
<!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN">
@ -22,7 +22,7 @@
<toc>
-->
<chapt><heading>The FreeBSD Booting Process</heading>
<chapt><heading>The FreeBSD Booting Process<label id="booting"></heading>
<p><em>Contributed by &a.phk;. v1.1, April 26th.</em>

View File

@ -3,7 +3,7 @@
#
# Converted by Ollivier RObert <roberto@FreeBSD.ORG>
#
# $Id: m_ctm.sgml,v 1.1 1995/04/10 02:35:55 jfieber Exp $
# $Id: ctm.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $
#
# ----------------------------------------------------------------------------
# "THE BEER-WARE LICENSE" (Revision 42):
@ -14,7 +14,7 @@
#
-->
<sect><heading>CTM</heading>
<sect><heading>CTM<label id="ctm"></heading>
<p><em>Contributed by &a.phk;. Updated 16-Mar-1995.</em>

View File

@ -1,8 +1,8 @@
<!-- $Id: current.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: current.sgml,v 1.2 1995/05/18 03:05:03 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>Staying current with FreeBSD<label id="current:"></heading>
<chapt><heading>Staying current with FreeBSD<label id="current"></heading>
<p><em>Contributed by &a.jkh;.</em>
@ -10,7 +10,7 @@
THE FREEBSD CURRENT POLICY
Last updated: $Date: 1995/04/28 16:19:59 $
Last updated: $Date: 1995/05/18 03:05:03 $
This document attempts to explain the rationale behind FreeBSD-current,
what you should expect should you decide to run it, and states some

View File

@ -1,6 +1,6 @@
<!-- This is an SGML document in the linuxdoc DTD of the Tutorial for
Configuring a FreeBSD for Dialup Services by Guy Helmer.
$Id: m_dialup.sgml,v 1.1 1995/04/10 02:35:59 jfieber Exp $
$Id: dialup.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $
<!DOCTYPE linuxdoc PUBLIC "-//Linux//DTD linuxdoc//EN">
@ -15,7 +15,7 @@ Configuring FreeBSD for Dialup Services
-->
<sect><heading>Dialup access</heading>
<sect><heading>Dialup access<label id="dialup"></heading>
<p><em>Contributed by &a.ghelmer;.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: m_diskless.sgml,v 1.1 1995/04/10 02:36:01 jfieber Exp $ -->
<!-- $Id: diskless.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Diskless operation</heading>
<sect><heading>Diskless operation<label id="diskless"></heading>
<p><em>Contributed by &a.martin;.</em>

View File

@ -1,8 +1,8 @@
<!-- $Id: eresources.sgml,v 1.2 1995/05/18 03:05:06 jfieber Exp $ -->
<!-- $Id: eresources.sgml,v 1.4 1995/06/20 16:42:48 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt>
<heading>Resources on the Internet</heading>
<heading>Resources on the Internet<label id="eresources"></heading>
<p>The rapid pace of FreeBSD progress makes print media
impractical as a means for following the latest

View File

@ -1,5 +1,5 @@
<!-- $Id: glossary.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: glossary.sgml,v 1.2 1995/06/14 18:38:51 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>* Glossary</heading>
<chapt><heading>* Glossary<label id="glossary"></heading>

View File

@ -1,4 +1,4 @@
<!-- $Id: handbook.sgml,v 1.10 1995/06/20 16:51:38 jfieber Exp $ -->
<!-- $Id: handbook.sgml,v 1.11 1995/06/22 13:47:05 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [
@ -98,7 +98,7 @@ OUTLINE:
<part><heading>System Administration</heading>
<chapt><heading>* Reconfiguring the Kernel<label id="kernelconfig:"></heading>
<chapt><heading>* Reconfiguring the Kernel<label id="kernelconfig"></heading>
<!-- &kernelconfig; -->
<chapt><heading>Users, groups and security</heading>

View File

@ -1,7 +1,7 @@
<!-- $Id:$ -->
<!-- $Id: history.sgml,v 1.1 1995/05/10 22:12:01 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>A brief history of FreeBSD</heading>
<sect><heading>A brief history of FreeBSD<label id="history"></heading>
<p><em>Contributed by &a.jkh;</em>.

View File

@ -1,10 +1,10 @@
<!-- $Id:$ -->
<!-- $Id: install.sgml,v 1.1 1995/06/14 18:38:54 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!--
<!DOCTYPE linuxdoc PUBLIC '-//FreeBSD//DTD linuxdoc//EN'>
-->
<chapt><heading>Installing FreeBSD</heading>
<chapt><heading>Installing FreeBSD<label id="install"></heading>
<sect>MS-DOS user's Questions and Answers

View File

@ -1,7 +1,7 @@
<!-- $Id: kerberos.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: kerberos.sgml,v 1.2 1995/05/11 22:31:28 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Kerberos</heading>
<sect><heading>Kerberos<label id="kerberos"></heading>
<p><em>Contributed by &a.mark; (based on contribution by &a.md;).</em>

View File

@ -1,4 +1,4 @@
<!-- $Id:$ -->
<!-- $Id: kerneldebug.sgml,v 1.1 1995/06/14 18:38:55 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!--
@ -8,7 +8,7 @@
]>
-->
<chapt><heading>Kernel Debugging</heading>
<chapt><heading>Kernel Debugging<label id="kerneldebug"></heading>
<p><em>Contributed by &a.paul; and &a.joerg;</em>
@ -30,7 +30,7 @@ options DODUMP
</verb></tscreen>
in your config file in order to get kernel core dumps.
-->
See <ref id="kernelconfig:" name="Kernel Configuration"> for
See <ref id="kernelconfig" name="Kernel Configuration"> for
details on configuring the FreeBSD kernel.
<em><bf>Note:</bf> In the following, the term `<tt>kgdb</tt>' refers
@ -253,7 +253,7 @@ options DODUMP
<tscreen><verb>
options DDB
</verb></tscreen>
to your config file, and rebuild. (See <ref id="kernelconfig:"
to your config file, and rebuild. (See <ref id="kernelconfig"
name="Kernel Configuration"> for details on configuring the
FreeBSD kernel. Note that if you have an older version of the
boot blocks, your debugger symbols might not be loaded at all.

View File

@ -1,7 +1,7 @@
<!-- $Id:$ -->
<!-- $Id: memoryuse.sgml,v 1.1 1995/05/18 03:05:11 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>PC memory utilization</heading>
<chapt><heading>PC memory utilization<label id="memoryuse"></heading>
<p><em>Contributed by &a.joerg;.<newline>
16 Apr 1995.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: m_nfs.sgml,v 1.1 1995/04/10 02:36:04 jfieber Exp $ -->
<!-- $Id: nfs.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>NFS</heading>
<sect><heading>NFS<label id="nfs"></heading>
<p><em>Contributed by &a.john;.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: nutshell.sgml,v 1.1 1995/05/11 02:03:38 jfieber Exp $ -->
<!-- $Id: nutshell.sgml,v 1.2 1995/06/22 13:47:06 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>FreeBSD in a nutshell</heading>
<sect><heading>FreeBSD in a nutshell<label id="nutshell"></heading>
<p>FreeBSD is a state of the art operating system for
personal computers based on the Intel CPU architecture, which

View File

@ -1,7 +1,7 @@
<!-- $Id: porting.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: porting.sgml,v 1.2 1995/05/18 03:05:15 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Porting applications<label id="porting:"></heading>
<sect><heading>Porting applications<label id="porting"></heading>
<p><em>Contributed by &a.jkh;.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: ports.sgml,v 1.2 1995/05/18 03:05:19 jfieber Exp $ -->
<!-- $Id: ports.sgml,v 1.3 1995/06/23 13:59:37 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>The Ports collection<label id="ports:"></heading>
<sect><heading>The Ports collection<label id="ports"></heading>
<p><em>Contributed by &a.gpalmer; and &a.jkh;.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: ppp.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: ppp.sgml,v 1.2 1995/06/22 13:47:08 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Setting up a PPP link</heading>
<sect><heading>Setting up a PPP link<label id="ppp"></heading>
<p><em>Contributed by &a.gena;.</em>

View File

@ -1,11 +1,11 @@
<!-- $Id: relnotes.sgml,v 1.1 1995/06/14 18:38:56 jfieber Exp $ -->
<!-- $Id: relnotes.sgml,v 1.2 1995/06/22 13:47:09 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!--
<!DOCTYPE linuxdoc PUBLIC '-//FreeBSD//DTD linuxdoc//EN'>
<linuxdoc><book><chapt>foo
-->
<sect>About this release
<sect>About this release<label id="relnotes">
<p>Since our first release of FreeBSD 1.0 nearly two
years ago, FreeBSD has changed dramatically. Since
@ -52,7 +52,7 @@
as a pre-compiled package which can be installed with
the <tt>pkg_add(1)</tt> command for those who do not
wish to compile their own ports from source. See <ref
id="ports:" name="The Ports Collection"> for a more
id="ports" name="The Ports Collection"> for a more
complete description.
<!-- XXX make xref

View File

@ -1,4 +1,4 @@
<!-- $Id: m_scsi.sgml,v 1.1 1995/04/10 02:36:14 jfieber Exp $ -->
<!-- $Id: scsi.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!--
@ -13,7 +13,7 @@
</abstract>
-->
<sect><heading>SCSI</heading>
<sect><heading>SCSI<label id="scsi"></heading>
<p><em>&copy; 1995, &a.wilko;.</em>
@ -28,7 +28,7 @@
standard allowing devices from different vendors to work together.
This effort was recognised in the ANSI SCSI-1 standard. The SCSI-1
standard (approx 1985) is now more or less obsolete. The current
standard is SCSI-2 (see <ref id="further-reading" name="Further
standard is SCSI-2 (see <ref id="scsi:further-reading" name="Further
reading">), with SCSI-3 on the drawing boards.
In addition to a physical interconnection standard, SCSI defines a
@ -177,7 +177,7 @@
differential SCSI bus was introduced in the SCSI-2 standard.
For connector pinning and connector types please refer to the
SCSI-2 standard (see <ref id="further-reading" name="Further
SCSI-2 standard (see <ref id="scsi:further-reading" name="Further
reading">) itself, connectors etc are listed there in
painstaking detail.
@ -627,7 +627,7 @@ options "TUNE_1542" #dynamic tune of bus DMA speed
If possible, configure your hostadapter to use slow bus speeds.
</itemize>
<sect1><heading>Further reading<label id="further-reading"></>
<sect1><heading>Further reading<label id="scsi:further-reading"></>
<p>
If you intend to do some serious SCSI hacking, you might want to
have the official standard at hand:

View File

@ -1,7 +1,7 @@
<!-- $Id: m_slip_c.sgml,v 1.1 1995/04/10 02:36:16 jfieber Exp $ -->
<!-- $Id: slipc.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Setting up a SLIP client</heading>
<sect><heading>Setting up a SLIP client<label id="slipc"></heading>
<p><em>Contributed by &a.asami;.</em>
@ -17,20 +17,19 @@ mileage may vary.
-->
Note: for 1.1 systems (not 1.1.5), you need to use /dev/tty01 instead
of /dev/cua01. substitute all the occurences of "cua" in this document
with "tty".
of /dev/cuaa1.
Note: the default 1.1.5(.1) system only comes with cua/ttyd pairs for
the last two ports (2 and 3), so if your modem is at sio0/sio1
(COM1/COM2), you need to make the devices. Try "cd /dev; sh MAKEDEV
cua01" to make the new special files for sio1 (ditto for sio0). This
cuaa1" to make the new special files for sio1 (ditto for sio0). This
will delete tty01, but you shouldn't need it anymore...or you can make
a symbolic link /dev/tty01 -> ttyd1 if you don't want to hunt down all
occurences of tty01 in your setup files.
I actually have a symbolic link /dev/modem -> cua01 (and /dev/mouse ->
I actually have a symbolic link /dev/modem -> cuaa1 (and /dev/mouse ->
ttyd0). I use only the modem/mouse names in my configuration files.
This helped a lot when I switched from 1.1 to 1.1.5.1 (tty01 => cua01)
This helped a lot when I switched from 1.1 to 1.1.5.1 (tty01 => cuaa1)
and when I had to move my modem temporarily to sio2 to enable the
RS-232C port on the serial card. It can become quite cumbersome when
you need to fix a bunch of files in /etc and .kermrc's all over the
@ -99,7 +98,7 @@ nameserver 128.32.136.12
<verb>
# kermit setup
set modem hayes
set line /dev/cua01
set line /dev/cuaa1
set speed 57600
set parity none
set flow rts/cts
@ -128,7 +127,7 @@ output ***\x0d, echo \x0aCONNECTED\x0a
<item> Leave the kermit there (you can suspend it by "z") and as root,
type
<verb>
slattach -h -c -s 57600 /dev/cua01
slattach -h -c -s 57600 /dev/cuaa1
</verb>
if you are able to "ping" hosts on campus, you are connected!
If it doesn't work, you might want to try "-a" instead of "-c".

View File

@ -11,7 +11,7 @@ Setting up FreeBSD as a SLIP Server
-->
<sect><heading>Setting up a SLIP server</heading>
<sect><heading>Setting up a SLIP server<label id="slips"></heading>
<p><em>Contribudted by &a.ghelmer;.<newline>
v1.0, 15 May 1995.</em>
@ -35,7 +35,7 @@ problem.
For FreeBSD 1.x users, all of the files referenced in the directory
<tt>/etc/sliphome</tt> are actually in the <tt>/etc</tt> directory.
<sect1><heading>Prerequisites<label id="prereqs"></>
<sect1><heading>Prerequisites<label id="slips:prereqs"></>
<p>
This document is very technical in nature, so background knowledge is
@ -249,7 +249,7 @@ going to use ``proxy ARP'' on your SLIP server (it's not ``true''
proxy ARP, but that is the terminology used in this document to
describe it). If you're not sure which method to select or how to
assign IP addresses, please refer to the TCP/IP books referenced in
the <ref id="prereqs"> section and/or consult your IP network manager.
the <ref id="slips:prereqs"> section and/or consult your IP network manager.
If you are going to use a separate subnet for your SLIP clients, you
will need to allocate the subnet number out of your assigned IP

View File

@ -1,7 +1,7 @@
<!-- $Id: submitters.sgml,v 1.2 1995/05/18 03:05:22 jfieber Exp $ -->
<!-- $Id: submitters.sgml,v 1.3 1995/06/20 16:29:55 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>Contributing to FreeBSD</heading>
<chapt><heading>Contributing to FreeBSD<label id="submitters"></heading>
<p><em>Contributed by &a.jkh;.</em>
@ -66,7 +66,7 @@ are each, in their own way, quite significant to the project.
state of the core FreeBSD development. There is a special on-going release
of FreeBSD known as ``FreeBSD-current'' and made available in a variety of
ways for the convenience of developers who wish to actively work on the
system. See <ref id="current:" name="Staying current with
system. See <ref id="current" name="Staying current with
FreeBSD"> for more information about getting and using FreeBSD-current.
Working from older sources unfortunately means that your changes may
@ -203,7 +203,7 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
$Id: submitters.sgml,v 1.2 1995/05/18 03:05:22 jfieber Exp $
$Id: submitters.sgml,v 1.3 1995/06/20 16:29:55 jfieber Exp $
</verb></tscreen>
For your convenience, a copy of this text can be found in
<tt>/usr/share/examples/etc/bsd-style-copyright</tt>.
@ -220,9 +220,9 @@ collection''. This collection enables a new user to get a
complete overview of what's available in a short time, and with a
logical framework. The ports collection also saves
considerable space by not actually containing the the majority of
the sources being ported. See <ref id="ports:" name="The ports
the sources being ported. See <ref id="ports" name="The ports
collection"> for more information on using the ports collection
and <ref id="porting:" name="Porting applications"> for
and <ref id="porting" name="Porting applications"> for
guidelines on creating new ports. You may also send mail to
<tt>&lt;ports@freebsd.org&gt;</tt>.

View File

@ -1,8 +1,8 @@
<!-- $Id: sup.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- $Id: sup.sgml,v 1.2 1995/05/03 14:32:27 ache Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>SUP</heading>
<sect><heading>SUP<label id="sup"></heading>
<p><em>Contributed by &a.jkh; and &a.gclarkii;.</em>

View File

@ -1,7 +1,7 @@
<!-- $Id: m_troubleshooting.sgml,v 1.1 1995/04/10 02:36:24 jfieber Exp $ -->
<!-- $Id: troubleshooting.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>Troubleshooting</heading>
<chapt><heading>Troubleshooting<label id="troubleshooting"></heading>
<p>The following tips and tricks may help you turn a
failing (or failed) installation attempt into a success.