Add generalized definition of krb5_ui_4 and krb5_int32 to the documentation for bette...

[krb5.git] / doc / Makefile

diff --git a/doc/Makefile b/doc/Makefile
index dfbc9430f74a75b0f9fb24dec1c5a799be14b6cd..599da3f6cfbb3c0e1f3ec0dfae83f4670455e074 100644 (file)
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,15 +1,157 @@
-.SUFFIXES: .texi .dvi .ps .info
+SRCDIR=../src
+DVI=texi2dvi
+DVIPS=dvips -o "$@"
+PSPDF=ps2pdf
+INFO=makeinfo
+HTML=makeinfo --html --no-split
+RM=rm -f
+TAR=tar -chvf
+GZIP=gzip -9
+MANPS=./man2ps
+MANTXT=nroff -man 
+PERL=perl
+MANHTML=$(PERL) man2html
 
-all:: install.info  install.dvi
+ADMIN_INCLUDES=definitions.texinfo copyright.texinfo document-list.texinfo \
+       glossary.texinfo support-enc.texinfo salts.texinfo krb5conf.texinfo \
+       kdcconf.texinfo dnstxt.texinfo dnssrv.texinfo send-pr.texinfo
+ADMIN_DEPS=admin.texinfo $(ADMIN_INCLUDES)
 
-.texi.dvi:
-       texi2dvi $*.texi
+INSTALL_INCLUDES=definitions.texinfo copyright.texinfo document-list.texinfo \
+       dnstxt.texinfo dnssrv.texinfo build.texinfo bug-report.texinfo \
+       krb5conf.texinfo kdcconf.texinfo send-pr.texinfo
+INSTALL_DEPS=install.texinfo $(INSTALL_INCLUDES)
 
+MANPAGES=$(SRCDIR)/clients/kdestroy/kdestroy.M $(SRCDIR)/clients/kinit/kinit.M $(SRCDIR)/clients/klist/klist.M $(SRCDIR)/clients/ksu/ksu.M $(SRCDIR)/clients/kpasswd/kpasswd.M
 
-.texi.info:
-       makeinfo $*.texi
+USER_GUIDE_INCLUDES=definitions.texinfo copyright.texinfo glossary.texinfo
+USER_GUIDE_DEPS=user-guide.texinfo $(USER_GUIDE_INCLUDES)
 
+.PHONY: all
+all:: admin-guide-full install-guide-full user-guide-full clean-temp-ps clean-tex
 
-clean:: 
-       rm -f *.log *.info *.dvi *.aux *.toc *.cp *.fn *.vr *.tp *.ky \
-               *.pg *.ps *.info-?
+.PHONY: admin-guide-full
+admin-guide-full:: admin-guide admin-guide-info admin-guide-html
+
+.PHONY: admin-guide
+admin-guide:: admin-guide.ps admin-guide.pdf
+
+admin-guide.ps: $(ADMIN_DEPS)
+       $(DVI) admin.texinfo
+       $(DVIPS) admin
+
+admin-guide.pdf: admin-guide.ps
+       $(PSPDF) admin-guide.ps admin-guide.pdf
+
+.PHONY: admin-guide-html
+admin-guide-html:: admin.html
+
+admin.html: $(ADMIN_DEPS)
+       $(HTML) admin.texinfo
+
+.PHONY: admin-guide-info
+admin-guide-info:: krb5-admin.info
+
+krb5-admin.info: $(ADMIN_DEPS)
+       $(INFO) admin.texinfo
+
+.PHONY: install-guide-full
+install-guide-full:: install-guide install-guide-info install-guide-html
+
+.PHONY: install-guide
+install-guide:: install-guide.ps install-guide.pdf
+
+install-guide.ps: $(INSTALL_DEPS)
+       $(DVI) install.texinfo
+       $(DVIPS) install
+
+install-guide.pdf: install-guide.ps
+       $(PSPDF) install-guide.ps install-guide.pdf
+
+.PHONY: install-guide-html
+install-guide-html:: install.html
+
+install.html:: $(INSTALL_DEPS)
+       $(HTML) install.texinfo         
+
+.PHONY: install-guide-info
+install-guide-info:: krb5-install.info
+
+krb5-install.info: $(INSTALL_DEPS)
+       $(INFO) install.texinfo
+
+.PHONY: user-guide-full
+user-guide-full:: user-guide user-guide-info user-guide-html
+
+.PHONY: user-guide
+user-guide:: user-guide.ps user-guide.pdf
+
+user-guide.ps: $(USER_GUIDE_DEPS)
+       $(DVI) user-guide.texinfo
+       $(MANPS) $(MANPAGES)
+       $(DVIPS) user-guide
+
+user-guide.pdf: user-guide.ps
+       $(PSPDF) user-guide.ps user-guide.pdf
+
+.PHONY: user-guide-info
+user-guide-info:: krb5-user.info
+
+krb5-user.info: $(USER_GUIDE_DEPS)
+       $(INFO) user-guide.texinfo
+
+.PHONY: user-guide-html
+user-guide-html:: user-guide.html
+
+user-guide.html: $(USER_GUIDE_DEPS)
+       $(MANTXT) $(SRCDIR)/clients/kdestroy/kdestroy.M | $(MANHTML) > kdestroy.html
+       $(MANTXT) $(SRCDIR)/clients/kinit/kinit.M | $(MANHTML) > kinit.html
+       $(MANTXT) $(SRCDIR)/clients/klist/klist.M | $(MANHTML) > klist.html
+       $(MANTXT) $(SRCDIR)/clients/ksu/ksu.M | $(MANHTML) > ksu.html
+       $(MANTXT) $(SRCDIR)/clients/kpasswd/kpasswd.M | $(MANHTML) > kpasswd.html
+       $(HTML) user-guide.texinfo              
+
+.PHONY: implementor.ps implementor.pdf implementor.info
+implementor.pdf: implementor.ps
+       $(PSPDF) implementor.ps
+implementor.ps: implementor.texinfo
+       $(DVI) implementor.texinfo
+       $(DVIPS) implementor
+implementor.info: implementor.texinfo
+       $(INFO) implementor.texinfo
+
+.PHONY: clean
+clean:: clean-all
+
+.PHONY: clean-all
+clean-all:: clean-tex clean-backup clean-final clean-tarfiles
+
+.PHONY: clean-final
+clean-final::
+       $(RM) *.ps *.info *.info-? *.html *.pdf
+
+.PHONY: clean-tex
+clean-tex::
+       $(RM) *.aux *.cp *.dvi *.fn *.ky *.log *.pg *.toc *.tp *.vr *.fns *.vrs *.tps
+
+.PHONY: clean-backup
+clean-backup::
+       $(RM) *~ #*
+
+.PHONY: clean-tarfiles
+clean-tarfiles::
+       $(RM) *.tar *.tar.gz *.tgz
+
+.PHONY: clean-temp-ps
+clean-temp-ps::
+       $(RM) ftp?.ps kinit?.ps klist?.ps kdestroy?.ps ksu?.ps rlogin?.ps \
+               rcp?.ps rsh?.ps telnet?.ps kpasswd?.ps
+
+.PHONY: tgz
+tgz::
+       $(TAR) krb5-docs.tar admin.texinfo build.texinfo copyright.texinfo definitions.texinfo document-list.texinfo glossary.texinfo install.texinfo texinfo.tex user-guide.texinfo *-guide.ps *.info *.info-? *.html
+       $(GZIP) krb5-docs.tar
+       $(MV) krb5-docs.tar.gz krb5-docs.tgz
+
+../NOTICE: notice.texinfo definitions.texinfo copyright.texinfo
+       makeinfo --plaintext -o $@ notice.texinfo