From obrien@Nuxi.cs.ucdavis.edu  Sun Sep  8 19:01:04 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 ESMTP id TAA13945
          for <FreeBSD-gnats-submit@freebsd.org>; Sun, 8 Sep 1996 19:01:03 -0700 (PDT)
Received: (from obrien@localhost) by relay.nuxi.com (8.7.5/8.6.12) id TAA10014; Sun, 8 Sep 1996 19:01:44 -0700 (PDT)
Message-Id: <199609090201.TAA10014@relay.nuxi.com>
Date: Sun, 8 Sep 1996 19:01:44 -0700 (PDT)
From: "David E. O'Brien" <obrien@Nuxi.cs.ucdavis.edu>
Reply-To: obrien@Nuxi.cs.ucdavis.edu
To: FreeBSD-gnats-submit@freebsd.org
Cc: obrien@Nuxi.com
Subject: Incorrect LaTeX/PostScript Handbook output
X-Send-Pr-Version: 3.2

>Number:         1588
>Category:       docs
>Synopsis:       Handbook Incorrect LaTeX/PostScript output
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    jfieber
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep  8 19:10:02 PDT 1996
>Closed-Date:    Mon May 26 10:03:10 PDT 1997
>Last-Modified:  Mon May 26 10:09:09 PDT 1997
>Originator:     David E. O'Brien
>Release:        FreeBSD 2.1.5-RELEASE i386
>Organization:
University of California, Davis
>Environment:

	Handbook from -current, sgml, teTex, dvips from 2.1.5-RELEASE

>Description:

	In the printed handbook section on printing generated from the sgml
	sources via LaTeX 2e , ``&'' used in lpr filters are printed out 
	as ``\&''.  

	This is *quite* annoying.  Today I spent much time puzzled why things
	didn't work because of this.  While I should have known better (the
	purpose of the &'s and the bogusness of the \&, I still bindly followed
	the handbook (as I should be able to).  When later viewing the ascii
	version of the handbook, I found the correct information.	

>How-To-Repeat:

	cd /usr/src/doc/handbook ; make FORMATS=latex ; \
	latex handbook.tex ; latex handbook.tex ; latex handbook.tex ; \
	dvips handbook.dvi ; {lpr,ghostview} handbook.ps

>Fix:
	
	Don't know enought sgml to give the fix.  But you shouldn't be using
	escaping ``&'' in \begin{verbatim} ... \end{verbatim} sections
	in LaTeX.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->jfieber 
Responsible-Changed-By: wosch 
Responsible-Changed-When: Thu Sep 26 17:18:18 PDT 1996 
Responsible-Changed-Why:  
Mr. handbook. 
State-Changed-From-To: open->closed 
State-Changed-By: jfieber 
State-Changed-When: Mon May 26 10:03:10 PDT 1997 
State-Changed-Why:  
LaTeX support has been depriciated in for 2.2 on.  The SGML 
documents are being moved out of the source tree entirely, including 
for the 2.1.x branch, and the processing tools will migrate 
into the ports collection, rendering the processing tools in 
2.1.x obsolete. 

>Unformatted:
