From a686589b1f5d2e204dc8ae11779845064cda095a Mon Sep 17 00:00:00 2001
From: cohrs <cohrs>
Date: Thu, 12 Jun 2003 05:16:20 +0000
Subject: [PATCH] guidebook building command I found that the setting of
 GUIDECMD sys/unix/Makefile.doc didn't cut it with groff-1.18.  Also, the
 command was duplicated in the rule to generate Guidebook.txt.

---
 doc/fixes34.2         | 1 +
 sys/unix/Makefile.doc | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/fixes34.2 b/doc/fixes34.2
index 338b3443d..65edf9782 100644
--- a/doc/fixes34.2
+++ b/doc/fixes34.2
@@ -112,6 +112,7 @@ tiles: high priest tile had a couple bad pixels
 tiles: bad pixels in Croesus and Yeenoghu tiles
 FreeBSD: incorrect srandom declaration
 unix: don't autosave if hangup occurs after game is over
+linux: add example use of nroff on recent Linux distros
 
 
 General New Features
diff --git a/sys/unix/Makefile.doc b/sys/unix/Makefile.doc
index 076b2ba53..647e90ae0 100644
--- a/sys/unix/Makefile.doc
+++ b/sys/unix/Makefile.doc
@@ -19,7 +19,10 @@ COLCMD = col -bx
 PSCMD = groff
 
 # Use the "cat" GUIDECMD if nroff and/or tbl and/or col are not installed
+# Not appropriate for creating Guidebook.txt.
 # GUIDECMD = cat Guidebook.txt
+# The following works better with groff-1.18, eg on Linux
+# GUIDECMD = tbl tmac.n Guidebook.mn | nroff -c -Tascii | $(COLCMD)
 GUIDECMD = tbl tmac.n Guidebook.mn | nroff | $(COLCMD)
 
 # the basic guidebook
@@ -68,7 +71,7 @@ distrib: $(DISTRIB)
 	@echo "Plain text documentation is up to date."
 
 Guidebook.txt	: Guidebook.mn tmac.n
-	tbl tmac.n Guidebook.mn | nroff | $(COLCMD) > Guidebook.txt
+	$(GUIDECMD) > Guidebook.txt
 nethack.txt	: nethack.6
 	nroff -man nethack.6 | $(COLCMD) > nethack.txt
 lev_comp.txt	: lev_comp.6
-- 
2.50.1