From obrien@Nuxi.cs.ucdavis.edu  Tue Jul  9 10:04:17 1996
Received: from relay.nuxi.com (nuxi.cs.ucdavis.edu [128.120.56.38])
          by freefall.freebsd.org (8.7.5/8.7.3) with SMTP id KAA22077
          for <FreeBSD-gnats-submit@freebsd.org>; Tue, 9 Jul 1996 10:04:17 -0700 (PDT)
Received: (from obrien@localhost) by relay.nuxi.com (8.6.12/8.6.12) id KAA00901; Tue, 9 Jul 1996 10:04:24 -0700
Message-Id: <199607091704.KAA00901@relay.nuxi.com>
Date: Tue, 9 Jul 1996 10:04:24 -0700
From: "David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu>
Reply-To: obrien@Nuxi.cs.ucdavis.edu
To: FreeBSD-gnats-submit@freebsd.org
Subject: sgmlfmt generated freebsd-faq.tex does not LaTeX
X-Send-Pr-Version: 3.2

>Number:         1378
>Category:       docs
>Synopsis:       sgmlfmt generated freebsd-faq.tex does not LaTeX
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul  9 10:10:01 PDT 1996
>Closed-Date:    Tue Jul 9 16:06:26 PDT 1996
>Last-Modified:  Tue Nov 27 19:22:32 PST 2001
>Originator:     David E. O'Brien
>Release:        FreeBSD 2.1.0-RELEASE tools, -current FAQ source file
>Organization:
University of California, Davis
>Environment:

	Using sgmlfmt and LaTeX 2e package from 2.1-RELEASE

>Description:

	The freebsd-faq.tex file generated by sgmlfmt is not LaTeX'able.
	The problem line in the sgml file is:

            <item> Enter <tt/-c/ at the bootprompt. <newline>
              &lsqb; the kernel goes into configuration mode &rsqb;
            <item> Disable <tt/sio0/, <tt/sio1/, <tt/sio2/ and <tt/sio3/

	In the tex file this becomes:

	    \item  Enter {\tt -c} at the bootprompt. \\
	    [ the kernel goes into configuration mode ]
	    \item  Disable {\tt sio0}, {\tt sio1}, {\tt sio2} and {\tt sio3}

	When LaTeX is run on this is errors with:

		[27] [28] [29] [30] [31] [32]
		! Missing number, treated as zero.
		<to be read again> 
                   		t
		l.1799 [ the kernel goes into configuration mode ]

		? 

	The problem is LaTeX doesn't like the ``['' and ``]''.  
	I manually fixed it by changing ``['' to ``\['' or ``(''.
  

>How-To-Repeat:

	sgmlfmt -f latex freebsd-faq.sgm
	latex freebsd-faq.tex

>Fix:
	
	Don't know any sgml.  Sorry.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: gpalmer 
State-Changed-When: Tue Jul 9 16:06:26 PDT 1996 
State-Changed-Why:  
James Raynard says he fixed this in rev. 1.51 of freebsd-faq.sgml 

From: James Raynard <fbugs@jraynard.demon.co.uk>
To: FreeBSD-gnats@freefall.freebsd.org, obrien@nuxi.cs.ucdavis.edu
Cc:  Subject: Re: docs/1378: sgmlfmt generated freebsd-faq.tex does not LaTeX
Date: Tue, 9 Jul 1996 20:23:52 GMT

 >>>>> "David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu> writes:
 > 
 > 	The freebsd-faq.tex file generated by sgmlfmt is not LaTeX'able.
 > 	The problem line in the sgml file is:
 > 
 >             <item> Enter <tt/-c/ at the bootprompt. <newline>
 >               &lsqb; the kernel goes into configuration mode &rsqb;
 >             <item> Disable <tt/sio0/, <tt/sio1/, <tt/sio2/ and <tt/sio3/
 
 Interesting. There's an lsqb-rsqb combination right at the start of
 the FAQ which it seems to have accepted...
 
 Anyway, I'll be committing a version of the FAQ tonight which will fix
 this. Thanks for the report.
 
 -- 
 James Raynard, Edinburgh, Scotland
 james@jraynard.demon.co.uk
 http://www.freebsd.org/~jraynard/
>Unformatted:
