docs/60049: [patch] suggestion for advanced-network/chapter.sgml

[FURUKAWA Jumpei]

>Number:         60049
>Category:       docs
>Synopsis:       [patch] suggestion for advanced-network/chapter.sgml
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 08 08:20:17 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     FURUKAWA Jumpei
>Release:        FreeBSD 5.1-RELEASE-p10 i386
>Organization:
>Environment:
System: FreeBSD pippo.f-bell.net 5.1-RELEASE-p10 FreeBSD 5.1-RELEASE-p10 #2: Sat Nov 1 22:21:31 JST 2003 bell at pippo.f-bell.net:/usr/src/sys/i386/compile/PIPPO i386

>Description:
	Since the display collapses, I consider that it is better to use <table> instead of <screen>. 
	
>How-To-Repeat:
>Fix:

--- chapter.sgml.orig	Tue Dec  9 00:07:31 2003
+++ chapter.sgml	Tue Dec  9 00:34:19 2003
@@ -7213,28 +7213,80 @@
 	<note><para>The IPv4 broadcast address (usually <hostid role="ipaddr">xxx.xxx.xxx.255</hostid>) is expressed
 	  by multicast addresses in IPv6.</para></note>
 
-      <para>Reserved IPv6 addresses:</para>
+      <table>
+	<title>Reserved IPv6 addresses</title>
+	<tgroup cols="4">
+	  <thead>
+	    <row>
+	      <entry>ipv6-address</entry>
+	      <entry>prefixlength (Bits)</entry>
+	      <entry>description</entry>
+	      <entry>Notes</entry>
+	    </row>
+	  </thead>
 
-<screen>ipv6-address 	prefixlength(Bits)	description	Notes
+	  <tbody>
+	    <row>
+	      <entry>::</entry>
+	      <entry>128 Bits</entry>
+	      <entry>unspecified</entry>
+	      <entry>cf. 0.0.0.0 in IPv4</entry>
+	    </row>
 
-	::			128 Bits			unspecified cf. 0.0.0.0 in IPv4 address
-	::1			128 Bits			loopback address cf. 127.0.0.1 in IPv4
-	::00:xx:xx:xx:xx	96 Bits				embedded IPv4	The lower 32 bits are the
-								address	IPv4 address. Also called
-								<quote>IPv4 compatible IPv6
-								address</quote>
-	::ff:xx:xx:xx:xx	96 Bits		IPv4 mapped     The lower 32 bits are the
-						IPv6 address	IPv4 address. For hosts
-								which do not support IPv6
-	fe80:: - feb::		10 Bits		link-local	cf. loopback address in
-						IPv4
-	fec0:: - fef::		10 Bits		site-local
-	ff::			8 Bits		multicast
-	001 (base 2)		3 Bits		global unicast	All global unicast
-								addresses are assigned from
-								this pool. The first 3 Bits
-								are <quote>001</quote>.</screen>
+	    <row>
+	      <entry>::1</entry>
+	      <entry>128 Bits</entry>
+	      <entry>loopback address</entry>
+	      <entry>cf. 127.0.0.1 in IPv4</entry>
+	    </row>
 
+	    <row>
+	      <entry>::00:xx:xx:xx:xx</entry>
+	      <entry>96 Bits</entry>
+	      <entry>embedded IPv4</entry>
+	      <entry>The lower 32 bits are the IPv4 address.
+		Also called <quote>IPv4 compatible IPv6 address</quote></entry>
+	    </row>
+				
+	    <row>
+	      <entry>::ff:xx:xx:xx:xx</entry>
+	      <entry>96 Bits</entry>
+	      <entry>IPv4 mapped IPv6 address</entry>
+	      <entry>The lower 32 bits are the IPv4 address.
+		For hosts which do not support IPv6.</entry>
+	    </row>
+
+	    <row>
+	      <entry>fe80:: - feb::</entry>
+	      <entry>10 Bits</entry>
+	      <entry>link-local</entry>
+	      <entry>cf. loopback address in IPv4</entry>
+	    </row>
+
+	    <row>
+	      <entry>fec0:: - fef::</entry>
+	      <entry>10 Bits</entry>
+	      <entry>site-local</entry>
+	      <entry> </entry>
+	    </row>
+
+	    <row>
+	      <entry>ff::</entry>
+	      <entry>8 Bits</entry>
+	      <entry>multicast</entry>
+	      <entry> </entry>
+	    </row>
+
+	    <row>
+	      <entry>001 (base 2)</entry>
+	      <entry>3 Bits</entry>
+	      <entry>global unicast</entry>
+	      <entry>All global unicast addresses are assigned from this pool.
+		The first 3 Bits are <quote>001</quote>.</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
     </sect2>
 
     <sect2>
>Release-Note:
>Audit-Trail:
>Unformatted: