From owner-freebsd-doc@FreeBSD.ORG Sun May 20 07:30:05 2007 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0003116A46E for ; Sun, 20 May 2007 07:30:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.freebsd.org (Postfix) with ESMTP id BCD9513C4C9 for ; Sun, 20 May 2007 07:30:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id l4K7U4vh034101 for ; Sun, 20 May 2007 07:30:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l4K7U4xB034100; Sun, 20 May 2007 07:30:04 GMT (envelope-from gnats) Resent-Date: Sun, 20 May 2007 07:30:04 GMT Resent-Message-Id: <200705200730.l4K7U4xB034100@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, ighighi Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7FD0016A421 for ; Sun, 20 May 2007 07:24:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [69.147.83.33]) by mx1.freebsd.org (Postfix) with ESMTP id 734D913C448 for ; Sun, 20 May 2007 07:24:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id l4K7OL5R039978 for ; Sun, 20 May 2007 07:24:21 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id l4K7JJK7037095; Sun, 20 May 2007 07:19:19 GMT (envelope-from nobody) Message-Id: <200705200719.l4K7JJK7037095@www.freebsd.org> Date: Sun, 20 May 2007 07:19:19 GMT From: ighighi To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: docs/112804: groff(1) command should be called to explicitly use "ps" as output X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 May 2007 07:30:05 -0000 >Number: 112804 >Category: docs >Synopsis: groff(1) command should be called to explicitly use "ps" as output >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun May 20 07:30:03 GMT 2007 >Closed-Date: >Last-Modified: >Originator: ighighi >Release: 6.2-STABLE >Organization: >Environment: FreeBSD orion 6.2-STABLE FreeBSD 6.2-STABLE #1: Fri May 18 01:56:15 VET 2007 root@orion:/usr/obj/usr/src/sys/CUSTOM i386 >Description: The following line in /usr/share/mk/doc.images.mk should contain "-Tps" to prevent groff(1) from using the GROFF_TYPESETTER environment variable PIC2PS?= ${GROFF} -p -S -Wall -mtty-char -man When set to something other than "ps" the build fails, so adding "-Tps" would allow the user building the documentation have GROFF_TYPESETTER in ~/.profile without interfering with the build. I usually have this variable set to "latin1" or "ascii" so "man -t whatever" makes groff(1) use any output device I want. IMO, It doesn't hurt to add a "-Tps" to the line above as it would make the intended usage explicit. >How-To-Repeat: export GROFF_TYPESETTER=latin1 cd /usr/doc make FORMATS="html html-single" >Fix: Attached patch. Patch attached with submission follows: --- share/mk/doc.images.mk.orig Fri Jul 23 14:58:56 2004 +++ share/mk/doc.images.mk Fri May 18 13:10:56 2007 @@ -154,7 +154,7 @@ EPSTOPDF?= ${PREFIX}/bin/epstopdf EPSTOPDFOPTS?= ${EPSTOPDFFLAGS} # -PIC2PS?= ${GROFF} -p -S -Wall -mtty-char -man +PIC2PS?= ${GROFF} -Tps -p -S -Wall -mtty-char -man # PS2EPS?= ${PREFIX}/bin/gs PS2EPSOPTS?= -q -dNOPAUSE -dSAFER -dDELAYSAFER \ >Release-Note: >Audit-Trail: >Unformatted: