docs/114182: SLIP is super-ultra-modern (handbook/install chapter)

Sun Jul 1 01:00:14 UTC 2007

>Number:         114182
>Category:       docs
>Synopsis:       SLIP is super-ultra-modern (handbook/install chapter)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 01 01:00:11 GMT 2007
>Closed-Date:
>Last-Modified:
>Originator:     Ben Kaduk
>Release:        FreeBSD 7.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD prolepsis.scs.uiuc.edu 7.0-CURRENT FreeBSD 7.0-CURRENT #1: Sun Apr 1 16:59:00 UTC 2007 kaduk at prolepsis.scs.uiuc.edu:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	There is a subsection of ``Advanced Installation'' on installing
over a network.  This subsection describes methods for SLIP, PPP,
and Ethernet networking.  We sound rather archaic if we lead off the
list with the (in the words of Murray Stokely) super cutting-edge
SLIP protocol.
>How-To-Repeat:
	http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-diff-media.html
>Fix:

--- chapter.sgml.orig   Sat Jun 30 17:15:48 2007
+++ chapter.sgml        Sat Jun 30 17:23:11 2007
@@ -4569,9 +4594,34 @@
          <tertiary>Ethernet</tertiary>
        </indexterm>
        <para>There are three types of network installations available.
-         Serial port (SLIP or PPP), Parallel port (PLIP (laplink cable)),
-         or Ethernet (a standard Ethernet controller (includes some
-         PCMCIA)).</para>
+         Ethernet (a standard Ethernet controller), Serial port
+         (SLIP or PPP), or Parallel port (PLIP (laplink cable)).</para>
+
+       <para>For the fastest possible network installation, an
+         Ethernet adapter is always a good choice!  FreeBSD supports most
+         common PC Ethernet cards; a table of supported cards (and their
+         required settings) is provided in the Hardware Notes for each
+         release of FreeBSD.  If you are using one of the supported PCMCIA
+         Ethernet cards, also be sure that it is plugged in
+         <emphasis>before</emphasis> the laptop is powered on!  FreeBSD does
+         not, unfortunately, currently support hot insertion of PCMCIA cards
+         during installation.</para>
+
+       <para>You will also need to know your IP address on the network,
+         the netmask value for your address class, and the name of your
+         machine.  If you are installing over a PPP connection and do not
+         have a static IP, fear not, the IP address can be dynamically
+         assigned by your ISP.  Your system administrator can tell you
+         which values to use for your particular network setup.  If you
+         will be referring to other hosts by name rather than IP address,
+         you will also need a name server and possibly the address of a
+         gateway (if you are using PPP, it is your provider's IP address)
+         to use in talking to it.  If you want to install by FTP via a
+         HTTP proxy, you will also need the proxy's address.
+         If you do not know the answers to all or most of these questions,
+         then you should really probably talk to your system administrator
+         or ISP <emphasis>before</emphasis> trying this type of
+         installation.</para>

        <para>The SLIP support is rather primitive, and limited primarily
          to hard-wired links, such as a serial cable running between a
@@ -4604,32 +4654,6 @@
          over the parallel port is much higher than what is typically
          possible over a serial line (up to 50 kbytes/sec), thus resulting
          in a quicker installation.</para>
-
-       <para>Finally, for the fastest possible network installation, an
-         Ethernet adapter is always a good choice!  FreeBSD supports most
-         common PC Ethernet cards; a table of supported cards (and their
-         required settings) is provided in the Hardware Notes for each
-         release of FreeBSD.  If you are using one of the supported PCMCIA
-         Ethernet cards, also be sure that it is plugged in
-         <emphasis>before</emphasis> the laptop is powered on!  FreeBSD does
-         not, unfortunately, currently support hot insertion of PCMCIA cards
-         during installation.</para>
-
-       <para>You will also need to know your IP address on the network,
-         the netmask value for your address class, and the name of your
-         machine.  If you are installing over a PPP connection and do not
-         have a static IP, fear not, the IP address can be dynamically
-         assigned by your ISP.  Your system administrator can tell you
-         which values to use for your particular network setup.  If you
-         will be referring to other hosts by name rather than IP address,
-         you will also need a name server and possibly the address of a
-         gateway (if you are using PPP, it is your provider's IP address)
-         to use in talking to it.  If you want to install by FTP via a
-         HTTP proxy, you will also need the proxy's address.
-         If you do not know the answers to all or most of these questions,
-         then you should really probably talk to your system administrator
-         or ISP <emphasis>before</emphasis> trying this type of
-         installation.</para>

        <sect3>
          <title>Before Installing via NFS</title>


---------
Unless something got lost in PR-land, this is all I've got in terms
of minor grammar and style corrections for the install chapter.

>Release-Note:
>Audit-Trail:
>Unformatted:

