warden/early-roguelike
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Generate text documentation from the troff source files.

Browse source 
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.
This commit is contained in:
John "Elwin" Edwards 2016-02-21 20:47:12 -05:00
parent eab5aa2ec4
commit c6f7d67623
16 changed files with 133 additions and 2801 deletions
Download patch file Download diff file Expand all files Collapse all files

33
rogue4/Makefile.in
View file

@ -45,6 +45,7 @@ CFILES= vers.c extern.c armor.c chase.c command.c daemon.c daemons.c \
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 @@ MKDIR=mkdir
CHGRP=chgrp
CHMOD=chmod
INSTALL=@INSTALL@
GROFF=@GROFF@
NROFF=@NROFF@
COLCRT=@COLCRT@
TBL=@TBL@
SF=
NAMELIST=
@ -70,7 +75,9 @@ MACHDEP=
# @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: prob.o extern.o xs.o
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 @@ install: $(PROGRAM)
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 @@ install: $(PROGRAM)
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)