Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 18 Apr 1997 13:02:38 -0700 (PDT)
From:      iwasaki@jp.freebsd.org
To:        freebsd-gnats-submit@freebsd.org
Subject:   docs/3326: FAQ.sgml has some wrong tags, <code>.
Message-ID:  <199704182002.NAA29609@freefall.freebsd.org>
Resent-Message-ID: <199704182010.NAA00232@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         3326
>Category:       docs
>Synopsis:       FAQ.sgml has some wrong tags, <code>.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Apr 18 13:10:01 PDT 1997
>Last-Modified:
>Originator:     Mitsuru IWASAKI
>Organization:
AISDEL; SIRIM
>Release:        FreeBSD-current
>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/


>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199704182002.NAA29609>