From nobody  Fri Apr 18 13:02:38 1997
Received: (from nobody@localhost)
          by freefall.freebsd.org (8.8.5/8.8.5) id NAA29609;
          Fri, 18 Apr 1997 13:02:38 -0700 (PDT)
Message-Id: <199704182002.NAA29609@freefall.freebsd.org>
Date: Fri, 18 Apr 1997 13:02:38 -0700 (PDT)
From: iwasaki@jp.freebsd.org
To: freebsd-gnats-submit@freebsd.org
Subject: FAQ.sgml has some wrong tags, <code>.
X-Send-Pr-Version: www-1.0

>Number:         3326
>Category:       docs
>Synopsis:       FAQ.sgml has some wrong tags, <code>.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pds
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Apr 18 13:10:01 PDT 1997
>Closed-Date:    Sun Apr 20 04:56:20 PDT 1997
>Last-Modified:  Sun Apr 20 04:57:21 PDT 1997
>Originator:     Mitsuru IWASAKI
>Release:        FreeBSD-current
>Organization:
AISDEL; SIRIM
>Environment:
N/A

>Description:
In FAQ.sgml, there are some <code> tags which will be converted to &lt;hr&gt;<pre> in HTML files.
It seems many WWW browser (netscape navigator, lynx, w3.el) cannot handle these HTML files
with <hr> tags correctly.
I suggest that all of <code> tags in FAQ.sgml need to be changed to <verb>.

# I'm not sure if this is a FAQ.sgml problem or sgmlfmt or else :-(

>How-To-Repeat:
lynx /usr/share/doc/FAQ/FAQ77.html
in -current (as of 18 Apr.).

>Fix:
--- /usr/src/share/doc/FAQ/FAQ.sgml     Thu Apr 10 21:20:54 1997
+++ FAQ.sgml    Sat Apr 19 03:41:34 1997
@@ -1777,21 +1777,21 @@
         <p>
           You first need to edit the <tt>/etc/sysconfig</tt> in the last
           section to change the following variable to <tt/YES/:
-          <code>
+          <verb>
             # Set to YES if you want ibcs2 (SCO) emulation loaded at startup
             ibcs2=NO
-          </code>
+          </verb>
           It will load the <tt/ibcs2/ kernel module at startup.

           You'll then need to set up /compat/ibcs2/dev to look like:

-          <code>
+          <verb>
 lrwxr-xr-x  1 root  wheel         9 Oct 15 22:20 X0R@ -> /dev/null
 lrwxr-xr-x  1 root  wheel         7 Oct 15 22:20 nfsd@ -> socksys
 -rw-rw-r--  1 root  wheel         0 Oct 28 12:02 null
 lrwxr-xr-x  1 root  wheel         9 Oct 15 22:20 socksys@ -> /dev/null
 crw-rw-rw-  1 root  wheel   41,   1 Oct 15 22:14 spx
-          </code>
+          </verb>
           You just need socksys to go to <tt>/dev/null</tt> to fake the
           open &amp; close. The code in -current will handle the rest.
           This is much cleaner than the way it was done before.  If you
@@ -2711,9 +2711,9 @@
           memory information...but for now we're stuck with the kernel
           option.

-          <code>
+          <verb>
             options "MAXMEM=<n>"
-          </code>
+          </verb>
           Where <tt/n/ is your memory in Kilobytes. For a 128 MB machine,
           you'd want to use <tt/131072/

@@ -2727,9 +2727,9 @@
           network buffers (specifically, mbuf clusters). You can increase
           the amount of VM available for mbuf clusters by adding:

-          <code>
+          <verb>
             options "NMBCLUSTERS=<n>"
-          </code>
+          </verb>

           to your kernel config file, where &lt;n&gt; is a number in the
           range 512-4096, depending on the number of concurrent TCP
@@ -3175,7 +3175,7 @@
         <p>
           Here is a list compiled by Glen Foster
           <tt/&lt;gfoster@driver.nsta.org&gt;/:
-<code>
+<verb>
 Vendor          Model
 - --------------------------------------------------------
 ASUS            PCI-L101-TB
@@ -3192,7 +3192,7 @@
 SMC             EtherPower (Model 8432)
 TopWare         TE-3500P
 Zynx            ZX342
-</code>
+</verb>
       </sect1>
       <sect1>
         <heading>Why do I have to use the FQDN for hosts on my site?</heading>
@@ -3875,14 +3875,14 @@
       <heading>ACKNOWLEDGMENTS</heading>

       <p>
-        <code>
+        <verb>
           If you see a problem with this FAQ, or wish to submit an entry,
           please mail us at <FAQ@FreeBSD.ORG>.  We appreciate your
           feedback, and cannot make this a better FAQ without your help!


                                               FreeBSD Core Team
-        </code>
+        </verb>

         <descrip>
           <tag/Gary Clark II/


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->pds 
Responsible-Changed-By: jkh 
Responsible-Changed-When: Fri Apr 18 14:17:00 PDT 1997 
Responsible-Changed-Why:  
Peter is the FAQ maintainer. 
State-Changed-From-To: open->closed 
State-Changed-By: pds 
State-Changed-When: Sun Apr 20 04:56:20 PDT 1997 
State-Changed-Why:  
Fixed (changed some to <tt> instead of <verb>). 
>Unformatted:
