Bug 114182

Summary: [patch] SLIP is super-ultra-modern (handbook/install chapter)
Product: Documentation Reporter: minimarmot <minimarmot>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description minimarmot 2007-07-01 02:00:11 UTC
	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.

Fix: 

<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&nbsp;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.--3DzH7jMLq6vBr40XN08p3E3fTh9Cuqc6qSx4cp1Q9FECOUbh
Content-Type: text/plain; name="file.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="file.diff"

--- 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>
How-To-Repeat: 	http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-diff-media.html
Comment 1 dfilter service freebsd_committer freebsd_triage 2007-07-02 20:12:13 UTC
remko       2007-07-02 19:12:08 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/install chapter.sgml 
  Log:
  Move our cutting-edge SLIP documentation lower to the tree
  so that Ethernet is listed first (which is commonly used).
  
  PR:             docs/114182
  Submitted by:   Ben Kaduk <minimarmot at gmail dot com>
  
  Revision  Changes    Path
  1.356     +28 -29    doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 2 Remko Lodder freebsd_committer freebsd_triage 2007-07-02 20:13:55 UTC
State Changed
From-To: open->closed

I had committed the patch, thank you very much for your contribution!