diff rogue4/Makefile.in @ 223:0e99eade579c

Generate text documentation from the troff source files. This is done by make, in the 'docs' target, which is now part of the normal build process. Unfortunately, not all the games include troff sources. Getting decent HTML output from groff is still a difficult process which will not be attempted at this time. There are a few bugs in the 'install' and 'uninstall' rules. Not to mention that the documentation is sometimes inaccurate.
author John "Elwin" Edwards
date Sun, 21 Feb 2016 20:47:12 -0500
parents 97f8fdf9595c
children 4d0f53998e8a
line wrap: on
line diff
--- a/rogue4/Makefile.in	Fri Feb 12 15:12:37 2016 -0500
+++ b/rogue4/Makefile.in	Sun Feb 21 20:47:12 2016 -0500
@@ -45,6 +45,7 @@
 	rooms.c save.c scrolls.c state.c sticks.c things.c weapons.c wizard.c \
 	mach_dep.c xcrypt.c mdport.c
 MISC=	Makefile LICENSE.TXT rogue.6 rogue.me
+DOCS=	$(PROGRAM).cat $(PROGRAM).doc
 
 CFLAGS=
 CPPFLAGS=@DEFS@
@@ -56,6 +57,10 @@
 CHGRP=chgrp
 CHMOD=chmod
 INSTALL=@INSTALL@
+GROFF=@GROFF@
+NROFF=@NROFF@
+COLCRT=@COLCRT@
+TBL=@TBL@
 
 SF=
 NAMELIST=
@@ -70,7 +75,9 @@
 #	@cc -c $(CFLAGS) x.c
 #	@mv x.o $*.o
 
-@PROGRAM@: $(HDRS) $(OBJS) # xs.o
+all: $(PROGRAM) docs
+
+$(PROGRAM): $(HDRS) $(OBJS) # xs.o
 #	@rm -f x.c
 #	$(CC) $(LDFLAGS) xs.o $(OBJS) $(CRLIB) 
 	$(CC) $(LDFLAGS) $(OBJS) $(LIBS) -o $@
@@ -100,8 +107,24 @@
 prob.o: prob.c rogue.h
 	$(CC) -O -c prob.c
 
+docs: $(DOCS)
+
+$(PROGRAM).cat: rogue.6
+	if test "x$(GROFF)" != "x" ; then \
+	$(GROFF) -P-c -P-b -P-u -Tascii -man rogue.6 > $(PROGRAM).cat ;\
+	elif test "x$(NROFF)" != "x" -a "x$(COLCRT)" != "x" ; then \
+	$(NROFF) -man rogue.6 | colcrt - > $(PROGRAM).cat ;\
+	fi
+
+$(PROGRAM).doc: rogue.me
+	if test "x$(GROFF)" != "x" ; then \
+	$(GROFF) -P-c -P-b -P-u -t -me -Tutf8 rogue.me > $(PROGRAM).doc ;\
+	elif test "x$(NROFF)" != "x" -a "x$(COLCRT)" != "x" -a "x$(TBL)" != "x" ; then \
+	$(TBL) rogue.me | $(NROFF) -me | $(COLCRT) - > $(PROGRAM).doc ;\
+	fi
+
 clean:
-	rm -f $(POBJS) $(OBJS) core a.out p.out @PROGRAM@ strings make.out rogue.tar vgrind.* x.c x.o xs.c xs.o linterrs findpw distmod.o xs.po xstr rogue rogue.exe rogue.tar.gz rogue.cat rogue.doc xstr.exe
+	rm -f $(POBJS) $(OBJS) core a.out p.out $(PROGRAM) strings make.out rogue.tar vgrind.* x.c x.o xs.c xs.o linterrs findpw distmod.o xs.po xstr rogue rogue.exe rogue.tar.gz $(DOCS) xstr.exe
 
 maintainer-clean:
 	make clean
@@ -137,6 +160,8 @@
 	    then $(MKDIR) -p $(DESTDIR)$(docdir) ; fi
 	-$(INSTALL) -m 0644 LICENSE.TXT $(DESTDIR)$(docdir)/LICENSE.TXT
 	-$(INSTALL) -m 0644 rogue.me $(DESTDIR)$(docdir)/$(PROGRAM).me
+	-$(INSTALL) -m 0644 $(PROGRAM).doc $(DESTDIR)$(docdir)/$(PROGRAM).doc
+	-$(INSTALL) -m 0644 $(PROGRAM).cat $(DESTDIR)$(docdir)/$(PROGRAM).cat
 	-if test "x$(LOCKFILE)" != "x" && test ! -f $(DESTDIR)$(LOCKFILE) ; then \
 	    $(INSTALL) -m 0666 test $(DESTDIR)$(LOCKFILE)  ; \
 	    $(RM) $(DESTDIR)$(LOCKFILE) ; \
@@ -146,7 +171,9 @@
 uninstall:	
 	-$(RM) $(DESTDIR)$(bindir)/$(PROGRAM)
 	-$(RM) $(DESTDIR)$(man6dir)/$(PROGRAM).6
-	-$(RM) $(DESTDIR)$(docdir)$(PROGRAM)/$(PROGRAM).doc
+	-$(RM) $(DESTDIR)$(docdir)/$(PROGRAM).doc
+	-$(RM) $(DESTDIR)$(docdir)/$(PROGRAM).cat
+	-$(RM) $(DESTDIR)$(docdir)/$(PROGRAM).me
 	-$(RM) $(DESTDIR)$(LOCKFILE)
 	-$(RMDIR) $(DESTDIR)$(docdir)$(PROGRAM)