diff --git a/handbook/boothelp.sgml b/handbook/boothelp.sgml new file mode 100644 index 0000000000..78db5f6c83 --- /dev/null +++ b/handbook/boothelp.sgml @@ -0,0 +1,50 @@ + + + + + + + + + +%authors; + + + +%sections; + +]> + + + + + FreeBSD Installation + <author> + <name></name> + </author> + + <abstract>Welcome to FreeBSD! This guide describes the + FreeBSD installation process. To navigate through the + sections in this guide using the <bf>up</bf> and + <bf>down</bf> arrow keys to select a section you wish to + read. Then use the <bf>right arrow</bf> or the <bf>enter + key</bf> to view the section. You can backtrack through + sections you have read by using the <bf>left arrow</bf>. + </abstract> + + <chapt><heading>General information</heading> + &nutshell; + &history; + &relnotes; + + &install; + &troubleshooting; + &bibliography; + &eresources; + &hw; + &contrib; + + </book> +</linuxdoc> diff --git a/handbook/handbook.sgml b/handbook/handbook.sgml index 594af96ba9..e6d76e862b 100644 --- a/handbook/handbook.sgml +++ b/handbook/handbook.sgml @@ -1,200 +1,161 @@ -<!-- $Id: handbook.sgml,v 1.26 1995-09-01 04:54:12 jfieber Exp $ --> +<!-- $Id: handbook.sgml,v 1.27 1995-09-03 21:12:27 jfieber Exp $ --> <!-- The FreeBSD Documentation Project --> <!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [ + +<!-- Conditional flags for this version of the document --> +<!ENTITY % boothelp.only "IGNORE"> +<!ENTITY % handbook.only "INCLUDE"> + +<!-- Entity shorthand for authors' names and email addresses --> <!ENTITY % authors SYSTEM "authors.sgml"> %authors; -<!ENTITY bibliography SYSTEM "bibliography.sgml"> -<!ENTITY basics SYSTEM "basics.sgml"> -<!ENTITY booting SYSTEM "booting.sgml"> -<!ENTITY contrib SYSTEM "contrib.sgml"> -<!ENTITY ctm SYSTEM "ctm.sgml"> -<!ENTITY current SYSTEM "current.sgml"> -<!ENTITY dialup SYSTEM "dialup.sgml"> -<!ENTITY diskless SYSTEM "diskless.sgml"> -<!ENTITY eresources SYSTEM "eresources.sgml"> -<!ENTITY glossary SYSTEM "glossary.sgml"> -<!ENTITY history SYSTEM "history.sgml"> -<!ENTITY hw SYSTEM "hw.sgml"> -<!ENTITY install SYSTEM "install.sgml"> -<!ENTITY kerberos SYSTEM "kerberos.sgml"> -<!ENTITY kernelconfig SYSTEM "kernelconfig.sgml"> -<!ENTITY kerneldebug SYSTEM "kerneldebug.sgml"> -<!ENTITY memoryuse SYSTEM "memoryuse.sgml"> -<!ENTITY mirrors SYSTEM "mirrors.sgml"> -<!ENTITY nfs SYSTEM "nfs.sgml"> -<!ENTITY nutshell SYSTEM "nutshell.sgml"> -<!ENTITY porting SYSTEM "porting.sgml"> -<!ENTITY ports SYSTEM "ports.sgml"> -<!ENTITY ppp SYSTEM "ppp.sgml"> -<!ENTITY relnotes SYSTEM "relnotes.sgml"> -<!ENTITY scsi SYSTEM "scsi.sgml"> -<!ENTITY slipc SYSTEM "slipc.sgml"> -<!ENTITY slips SYSTEM "slips.sgml"> -<!ENTITY submitters SYSTEM "submitters.sgml"> -<!ENTITY sup SYSTEM "sup.sgml"> -<!ENTITY troubleshooting SYSTEM "troubleshooting.sgml"> -<!ENTITY userppp SYSTEM "userppp.sgml"> +<!-- Entity definitions for all the parts --> +<!ENTITY % sections SYSTEM "sections.sgml"> +%sections; ]> -<!-- - -Potential target audience: - 1. Potential users - a. new to unix - b. somewhat familiar with unix - c. veterans - 2. Existing users - a. new to unix - b. somewhat familiar with unix - c. veterans - - -OUTLINE: - ---> - <linuxdoc> <book> <title>FreeBSD Handbook <author> <name>The FreeBSD Documentation Project</name> </author> <date>August 31, 1995</date> <abstract>Welcome to FreeBSD! This handbook covers the installation and day to day use of <bf>FreeBSD Release 2.0.5</bf>. This manual is a <bf>work in progress</bf> and is the work of many individials. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to &a.jfieber; or to the FreeBSD Documentation Project mailing list <tt><htmlurl url="mailto:doc@freebsd.org" name="<doc@freebsd.org>"></tt>. </abstract> <toc> <!-- ************************************************************ --> <part><heading>Basics</heading> <chapt><heading>Introduction</heading> &nutshell; &history; &relnotes; &install; &basics; <chapt><heading>Installing applications</heading> <sect><heading>* Installing packages</heading> &ports; &porting; <!-- ************************************************************ --> <part><heading>System Administration</heading> <chapt><heading>Reconfiguring the Kernel<label id="kernelconfig"></heading> <p>This section is in progress. Please contact Deborah Bennett <htmlurl url="mailto:deborah@gallifrey.microunity.com" name="<deborah@gallifrey.microunity.com>"> for more information. In the meantime, please refer to Kernel Configuration section of the <url url="../FAQ/freebsd-faq.html" name="FreeBSD FAQ">. <!-- &kernelconfig; --> <chapt><heading>Users, groups and security</heading> <sect><heading>* DES, MD5 and Crypt</heading> <sect><heading>* S/Key</heading> &kerberos; <sect><heading>* Firewalls</heading> <chapt><heading>Printing</heading> <p>This section is in progress. Please contact Sean Kelly <url url="mailto:kelly@fsl.noaa.gov" name="kelley@fsl.noaa.gov"> for more information. <chapt><heading>The X-Window System</heading> <p>Pending the completion of this section, please refer to documentation supplied by the <url url="http://www.xfree86.org/" name="The XFree86 Project, Inc">. <chapt><heading>Managing hardware</heading> &scsi; <sect><heading>* Adding and reconfiguring disks</heading> <sect><heading>* Tapes and backups</heading> <sect><heading>* Serial ports</heading> <sect><heading>* Sound cards</heading> <!-- ************************************************************ --> <part><heading>Network Communications</heading> <chapt><heading>Basic Networking</heading> <sect><heading>* Ethernet basics</heading> <sect><heading>* Serial basics</heading> <sect><heading>* Hardwired Terminals</heading> &dialup; <chapt><heading>PPP and SLIP</heading> <p>If your connection to the internet is through a modem, or you wish to provide other people with dialup connections to the internet using FreeBSD, you have the option of using PPP or SLIP. Furthermore, two varieties of PPP are provided: <em>user</em> (sometimes referred to as iijppp) and <em>kernel</em>. The procedures for configuring both types of PPP, and for setting up SLIP are described in this chapter. &userppp; &ppp; &slipc; &slips; <chapt><heading>Advanced networking</heading> <sect><heading>Gateways and routing</heading> <p>This section is in progress. Please contact Coranth Gryphon <htmlurl url="mailto:gryphon@healer.com" name="<gryphon@healer.com>"> for more information. &nfs; <sect><heading>* Yellow Pages/NIS</heading> &diskless; <sect><heading>* ISDN</heading> <chapt><heading>* Mail</heading> <!-- ************************************************************ --> <part><heading>Advanced topics</heading> ¤t; &ctm; ⊃ &kerneldebug; &submitters; &booting; &memoryuse; &troubleshooting; <!-- ************************************************************ --> <part><heading>Appendices</heading> &mirrors; &bibliography; &eresources; &hw; &contrib; &glossary; </book> </linuxdoc> diff --git a/handbook/sections.sgml b/handbook/sections.sgml new file mode 100644 index 0000000000..a5f50d4078 --- /dev/null +++ b/handbook/sections.sgml @@ -0,0 +1,38 @@ +<!-- $Id: sections.sgml,v 1.1 1995-09-03 21:12:29 jfieber Exp $ --> +<!-- The FreeBSD Documentation Project --> + +<!-- Entities containing all the pieces of the handbook are --> +<!-- defined here --> + +<!ENTITY bibliography SYSTEM "bibliography.sgml"> +<!ENTITY basics SYSTEM "basics.sgml"> +<!ENTITY booting SYSTEM "booting.sgml"> +<!ENTITY contrib SYSTEM "contrib.sgml"> +<!ENTITY ctm SYSTEM "ctm.sgml"> +<!ENTITY current SYSTEM "current.sgml"> +<!ENTITY dialup SYSTEM "dialup.sgml"> +<!ENTITY diskless SYSTEM "diskless.sgml"> +<!ENTITY eresources SYSTEM "eresources.sgml"> +<!ENTITY glossary SYSTEM "glossary.sgml"> +<!ENTITY history SYSTEM "history.sgml"> +<!ENTITY hw SYSTEM "hw.sgml"> +<!ENTITY install SYSTEM "install.sgml"> +<!ENTITY kerberos SYSTEM "kerberos.sgml"> +<!ENTITY kernelconfig SYSTEM "kernelconfig.sgml"> +<!ENTITY kerneldebug SYSTEM "kerneldebug.sgml"> +<!ENTITY memoryuse SYSTEM "memoryuse.sgml"> +<!ENTITY mirrors SYSTEM "mirrors.sgml"> +<!ENTITY nfs SYSTEM "nfs.sgml"> +<!ENTITY nutshell SYSTEM "nutshell.sgml"> +<!ENTITY porting SYSTEM "porting.sgml"> +<!ENTITY ports SYSTEM "ports.sgml"> +<!ENTITY ppp SYSTEM "ppp.sgml"> +<!ENTITY relnotes SYSTEM "relnotes.sgml"> +<!ENTITY scsi SYSTEM "scsi.sgml"> +<!ENTITY slipc SYSTEM "slipc.sgml"> +<!ENTITY slips SYSTEM "slips.sgml"> +<!ENTITY submitters SYSTEM "submitters.sgml"> +<!ENTITY sup SYSTEM "sup.sgml"> +<!ENTITY troubleshooting SYSTEM "troubleshooting.sgml"> +<!ENTITY userppp SYSTEM "userppp.sgml"> +