From root@magpie.zpfe.com  Tue Aug 20 13:41:22 2002
Return-Path: <root@magpie.zpfe.com>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7FFD437B400
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Aug 2002 13:41:22 -0700 (PDT)
Received: from zpfe.com (dev06.eqp.zpfe.com [209.46.51.22])
	by mx1.FreeBSD.org (Postfix) with SMTP id 911A543E42
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 Aug 2002 13:41:21 -0700 (PDT)
	(envelope-from root@magpie.zpfe.com)
Received: (qmail 51183 invoked by uid 0); 20 Aug 2002 20:41:10 -0000
Message-Id: <20020820204110.51182.qmail@magpie.zpfe.com>
Date: 20 Aug 2002 20:41:10 -0000
From: steve@zpfe.com
Reply-To: steve@zpfe.com
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: documentation update to bridging section in handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         41826
>Category:       docs
>Synopsis:       documentation update to bridging section in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 20 13:50:01 PDT 2002
>Closed-Date:    Tue Aug 27 12:20:23 PDT 2002
>Last-Modified:  Tue Aug 27 12:20:23 PDT 2002
>Originator:     Steve Peterson
>Release:        FreeBSD 4.6.2-RELEASE i386
>Organization:
self
>Environment:
System: FreeBSD magpie.zpfe.com 4.6.2-RELEASE FreeBSD 4.6.2-RELEASE #4: Sat Aug 17 14:22:34 CDT 2002 root@magpie.zpfe.com:/usr/obj/usr/src/sys/MAGPIE i386

>Description:
	Updates to bridge module require change to handbook section.
>How-To-Repeat:
>Fix:

This patch is for
/doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml rev 1.1459

--- chapter.sgml.diff begins here ---
*** chapter.sgml	Sat Aug 17 11:31:56 2002
--- /root/chapter.sgml	Tue Aug 20 15:36:22 2002
***************
*** 615,622 ****
        <programlisting>net.link.ether.bridge=1</programlisting>
  
        <para>to <filename>/etc/sysctl.conf</filename> to enable the bridge at
! 	runtime.  If you want the bridged packets to be filtered by &man.ipfw.8;, 
! 	you should add:</para>
  
        <programlisting>net.link.ether.bridge_ipfw=1</programlisting>
  
--- 615,627 ----
        <programlisting>net.link.ether.bridge=1</programlisting>
  
        <para>to <filename>/etc/sysctl.conf</filename> to enable the bridge at
! 	runtime, and the line:</para>
! 
!       <programlisting>net.link.ether.bridge_cfg=&lt;--if1--&gt; &lt;--if2&gt;</programlisting>
! 
! 	  <para>to enable bridging on the specified interfaces (replace if1 and 
! 	  if2 with the names of your two network interfaces).  If you want the
! 	   bridged packets to be filtered by &man.ipfw.8;, you should add:</para>
  
        <programlisting>net.link.ether.bridge_ipfw=1</programlisting>
  
--- chapter.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Tue Aug 20 13:54:50 PDT 2002 
Responsible-Changed-Why:  
I seem to remember volunteering to commit this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41826 
State-Changed-From-To: open->feedback 
State-Changed-By: ceri 
State-Changed-When: Tue Aug 27 09:43:58 PDT 2002 
State-Changed-Why:  
Waiting to hear from originator. 

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

From: Ceri Davies <ceri@FreeBSD.org>
To: steve@zpfe.com
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/41826: documentation update to bridging section in handbook
Date: Tue, 27 Aug 2002 17:43:38 +0100

 On Tue, Aug 20, 2002 at 08:41:10PM -0000, steve@zpfe.com wrote:
 
 > !       <programlisting>net.link.ether.bridge_cfg=&lt;--if1--&gt; &lt;--if2&gt;</programlisting>
 
 According to the manpage for bridge(4), this should look something like :
 
 	net.link.ether.bridge_cfg=if1,if2
 
 With your patch, this is coming out as :
 
 	net.link.ether.bridge_cfg=<--if1--> <--if2>
 
 What was the intention ?
 If you wanted to add emphasis that the tokens if1 and if2 should be replaced
 then we can use <replaceable> markup here.
 
 Otherwise, can you let me know how you wanted this to be displayed ?
 
 I'm all for the change, but can't see what you wanted here.
 
 Thanks,
 
 Ceri
 
 -- 
 you can't see when light's so strong
 you can't see when light is gone

From: Steve Peterson <steve@zpfe.com>
To: Ceri Davies <ceri@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/41826: documentation update to bridging section in
  handbook
Date: Tue, 27 Aug 2002 14:08:47 -0500

 I think your proposed change is fine.
 
 The goal is to have the user replace:
 
 <--if1-->
 
 with the actual name of their interface.
 
 I thought that the <--...--> was a standard, but with a closer look at the 
 page I took it from 
 (http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/routing.html), 
 it's now clear that it isn't.
 
 S
 
 
State-Changed-From-To: feedback->closed 
State-Changed-By: ceri 
State-Changed-When: Tue Aug 27 12:19:37 PDT 2002 
State-Changed-Why:  
The revised change has been committed. 
Thanks for your contribution. 

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