From owner-freebsd-bugs  Sun Sep  8 19:10:07 1996
Return-Path: owner-bugs
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id TAA14590
          for bugs-outgoing; Sun, 8 Sep 1996 19:10:07 -0700 (PDT)
Received: (from gnats@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id TAA14582;
          Sun, 8 Sep 1996 19:10:03 -0700 (PDT)
Resent-Date: Sun, 8 Sep 1996 19:10:03 -0700 (PDT)
Resent-Message-Id: <199609090210.TAA14582@freefall.freebsd.org>
Resent-From: gnats (GNATS Management)
Resent-To: freebsd-bugs
Resent-Reply-To: FreeBSD-gnats@freefall.FreeBSD.org,
        obrien@Nuxi.cs.ucdavis.edu
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
X-Send-Pr-Version: 3.2
Subject: docs/1588: Incorrect LaTeX/PostScript Handbook output
Sender: owner-bugs@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk


>Number:         1588
>Category:       docs
>Synopsis:       Handbook Incorrect LaTeX/PostScript output
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep  8 19:10:02 PDT 1996
>Last-Modified:
>Originator:     David E. O'Brien
>Organization:
University of California, Davis
>Release:        FreeBSD 2.1.5-RELEASE i386
>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.
>Audit-Trail:
>Unformatted: