From nobody@FreeBSD.org  Wed Dec 29 14:16:36 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id D687716A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Dec 2004 14:16:36 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8563F43D3F
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Dec 2004 14:16:36 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id iBTEGZ7S037473
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 29 Dec 2004 14:16:36 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id iBTEGZ8p037467;
	Wed, 29 Dec 2004 14:16:35 GMT
	(envelope-from nobody)
Message-Id: <200412291416.iBTEGZ8p037467@www.freebsd.org>
Date: Wed, 29 Dec 2004 14:16:35 GMT
From: David Adam <zanchey@ucc.gu.uwa.edu.au>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Advanced Networking Wireless section cleanup
X-Send-Pr-Version: www-2.3

>Number:         75610
>Category:       docs
>Synopsis:       Advanced Networking Wireless section cleanup
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Dec 29 14:20:18 GMT 2004
>Closed-Date:    Fri Aug 05 18:34:20 GMT 2005
>Last-Modified:  Fri Aug 05 18:34:20 GMT 2005
>Originator:     David Adam
>Release:        FreeBSD-5.3
>Organization:
University Computer Club, UWA
>Environment:
CYGWIN_NT-5.1 owl 1.5.12(0.116/4/2) 2004-11-10 08:34 i686 unknown unknown Cygwin (hey, you don't need a BSD machine to do Docs!)
>Description:
Given the current focus on FreeBSD 5.3-RELEASE and above for the Handbook, I believe the attached change is in order. Also included is minor grammar cleanup (which - in my opinion - the entire Wireless section needs).

As I have no access to a FreeBSD 4.x machine and cannot find the PR that originated this sysctl change, I'm not sure whether or not my comments about 4.x are appropriate. Can someone confirm for me?
>How-To-Repeat:
-
>Fix:
(My first real diff, so here goes...)

--- chapter.sgml.orig	2004-12-29 21:37:24.623057600 +0800
+++ chapter.sgml	2004-12-29 21:55:09.994987200 +0800
@@ -808,15 +808,15 @@
           tell the FreeBSD kernel which interfaces to bridge together.
           We do that by using &man.sysctl.8;:</para>
 
-         <screen>&prompt.root; <userinput>sysctl net.link.ether.bridge=1</userinput>
-&prompt.root; <userinput>sysctl net.link.ether.bridge_cfg="wi0,xl0"</userinput>
+	<screen>&prompt.root; <userinput>sysctl net.link.ether.bridge.enable=1</userinput>
+&prompt.root; <userinput>sysctl net.link.ether.bridge.config="wi0,xl0"</userinput>
 &prompt.root; <userinput>sysctl net.inet.ip.forwarding=1</userinput></screen>
 
-	<para>On &os;&nbsp;5.2-RELEASE and later, you have to use
-	  instead the following options:</para>
+	<para>On &os; versions earlier than 5.2-RELEASE (including releases in the 4.x line),
+	you need to use the following options instead:</para>
 
-	<screen>&prompt.root; <userinput>sysctl net.link.ether.bridge.enable=1</userinput>
-&prompt.root; <userinput>sysctl net.link.ether.bridge.config="wi0,xl0"</userinput>
+         <screen>&prompt.root; <userinput>sysctl net.link.ether.bridge=1</userinput>
+&prompt.root; <userinput>sysctl net.link.ether.bridge_cfg="wi0,xl0"</userinput>
 &prompt.root; <userinput>sysctl net.inet.ip.forwarding=1</userinput></screen>
 
          <para>Now it is time for the wireless card setup.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Fri Aug 5 18:33:25 GMT 2005 
State-Changed-Why:  
These changes were committed in r1.357.  Thanks for the submission! 
Grammar improvements for the rest of the section would be much 
appreciated. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=75610 
>Unformatted:
