X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=blobdiff_plain;f=doc%2FMakefile;h=e7bf287e028ea506081c158d61e316588714bc46;hb=91653a10c6e6b9d57688e1d7dd7403625ea670a0;hp=18d30e388289c490396a9ff916924f136834e6e6;hpb=54a4337c6afca452270a8513c9439aee056b135c;p=PuTTY.git diff --git a/doc/Makefile b/doc/Makefile index 18d30e38..e7bf287e 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,11 +1,77 @@ -CHAPTERS = blurb intro gs config pscp plink pubkey pageant trouble +all: man index.html + +# Decide on the versionid policy. +# +# If the user has passed in $(VERSION) on the command line (`make +# VERSION="Release 0.56"'), we use that as an explicit version string. +# Otherwise, we use `svnversion' to examine the checked-out +# documentation source, and if that returns a single revision number +# then we invent a version string reflecting just that number. Failing +# _that_, we resort to versionids.but which gives 'version +# unavailable'. +# +# So here, we define VERSION using svnversion if it isn't already +# defined ... +ifndef VERSION +SVNVERSION=$(shell test -d .svn && svnversion .) +BADCHARS=$(findstring :,$(SVNVERSION))$(findstring S,$(SVNVERSION)) +ifeq ($(BADCHARS),) +ifneq ($(SVNVERSION),) +ifneq ($(SVNVERSION),exported) +VERSION=Built from revision $(patsubst M,,$(SVNVERSION)) +endif +endif +endif +endif +# ... and now, we condition our build behaviour on whether or not +# VERSION _is_ defined. +ifdef VERSION +VERSIONIDS=vstr +vstr.but: FORCE + printf '\\versionid $(VERSION)\n' > vstr.but +FORCE:; +else +VERSIONIDS=vids +endif + +CHAPTERS := $(SITE) copy blurb intro gs using config pscp psftp plink +CHAPTERS += pubkey pageant errors faq feedback licence udp pgpkeys sshnames +CHAPTERS += index $(VERSIONIDS) INPUTS = $(patsubst %,%.but,$(CHAPTERS)) # This is temporary. Hack it locally or something. -BUTTRESS = $(HOME)/src/buttress/build/buttress +HALIBUT = halibut + +index.html: $(INPUTS) + $(HALIBUT) --text --html --winhelp $(INPUTS) + +# During formal builds it's useful to be able to build this one alone. +putty.hlp: $(INPUTS) + $(HALIBUT) --winhelp $(INPUTS) + +putty.info: $(INPUTS) + $(HALIBUT) --info $(INPUTS) + +chm: putty.hhp +putty.hhp: $(INPUTS) chm.but + $(HALIBUT) --html $(INPUTS) chm.but + +MKMAN = $(HALIBUT) --man=$@ mancfg.but $< +MANPAGES = putty.1 puttygen.1 plink.1 pscp.1 psftp.1 puttytel.1 pterm.1 \ + pageant.1 +man: $(MANPAGES) + +putty.1: man-putt.but mancfg.but; $(MKMAN) +puttygen.1: man-pg.but mancfg.but; $(MKMAN) +plink.1: man-pl.but mancfg.but; $(MKMAN) +pscp.1: man-pscp.but mancfg.but; $(MKMAN) +psftp.1: man-psft.but mancfg.but; $(MKMAN) +puttytel.1: man-ptel.but mancfg.but; $(MKMAN) +pterm.1: man-pter.but mancfg.but; $(MKMAN) +pageant.1: man-pag.but mancfg.but; $(MKMAN) -Contents.html: $(INPUTS) - $(HOME)/src/buttress/build/buttress $(INPUTS) - rm -f index.html - ln -s Contents.html index.html +mostlyclean: + rm -f *.html *.txt *.hlp *.cnt *.1 *.info vstr.but *.hh[pck] +clean: mostlyclean + rm -f *.chm