From kaduk@prolepsis.scs.uiuc.edu  Sun Jul  1 00:54:38 2007
Return-Path: <kaduk@prolepsis.scs.uiuc.edu>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id C376516A421
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  1 Jul 2007 00:54:38 +0000 (UTC)
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: from prolepsis.scs.uiuc.edu (74-139-211-128.dhcp.insightbb.com [74.139.211.128])
	by mx1.freebsd.org (Postfix) with ESMTP id 5B1C313C46C
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  1 Jul 2007 00:54:38 +0000 (UTC)
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: from prolepsis.scs.uiuc.edu (localhost [127.0.0.1])
	by prolepsis.scs.uiuc.edu (8.13.8/8.13.8) with ESMTP id l610ro40002380
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 1 Jul 2007 00:53:50 GMT
	(envelope-from kaduk@prolepsis.scs.uiuc.edu)
Received: (from kaduk@localhost)
	by prolepsis.scs.uiuc.edu (8.13.8/8.13.8/Submit) id l610roYc002379;
	Sun, 1 Jul 2007 00:53:50 GMT
	(envelope-from kaduk)
Message-Id: <200707010053.l610roYc002379@prolepsis.scs.uiuc.edu>
Date: Sun, 1 Jul 2007 00:53:50 GMT
From: minimarmot@gmail.com
Reply-To: minimarmot@gmail.com
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: SLIP is super-ultra-modern (handbook/install chapter)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         114182
>Category:       docs
>Synopsis:       [patch] SLIP is super-ultra-modern (handbook/install chapter)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 01 01:00:11 GMT 2007
>Closed-Date:    Mon Jul 02 19:13:57 GMT 2007
>Last-Modified:  Mon Jul  2 19:20:04 GMT 2007
>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@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&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.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Mon Jul 2 19:13:55 UTC 2007 
State-Changed-Why:  
I had committed the patch, thank you very much for your contribution! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=114182 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/114182: commit references a PR
Date: Mon,  2 Jul 2007 19:12:13 +0000 (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"
 
>Unformatted:
