Doc/info/Makefile

   1 # Generate the Python "info" documentation.
   2
   3 TOPDIR=..
   4 TOOLSDIR=$(TOPDIR)/tools
   5 HTMLDIR=$(TOPDIR)/html
   6
   7 # The emacs binary used to build the info docs. GNU Emacs 21 is required.
   8 EMACS=emacs
   9
  10 MKINFO=$(TOOLSDIR)/mkinfo
  11 SCRIPTS=$(TOOLSDIR)/checkargs.pm $(TOOLSDIR)/mkinfo $(TOOLSDIR)/py2texi.el
  12
  13 # set VERSION to code the VERSION number into the info file name
  14 # allowing installation of more than one set of python info docs
  15 # into the same directory
  16 VERSION=
  17
  18 all:    check-emacs-version \
  19         python$(VERSION)-api.info python$(VERSION)-ext.info \
  20         python$(VERSION)-lib.info python$(VERSION)-ref.info \
  21         python$(VERSION)-tut.info python$(VERSION)-dist.info
  22
  23 #       python$(VERSION)-doc.info python$(VERSION)-inst.info
  24 #       python$(VERSION)-mac.info
  25
  26 check-emacs-version:
  27         @v="`$(EMACS) --version 2>&1 | egrep '^(GNU |X)Emacs [12]*'`"; \
  28         if `echo "$$v" | grep '^GNU Emacs 21' >/dev/null 2>&1`; then \
  29           echo "Using $(EMACS) to build the info docs"; \
  30         else \
  31           echo "GNU Emacs 21 is required to build the info docs"; \
  32           echo "Found $$v"; \
  33           false; \
  34         fi
  35
  36 python$(VERSION)-api.info:      ../api/api.tex $(SCRIPTS)
  37         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  38
  39 python$(VERSION)-ext.info:      ../ext/ext.tex $(SCRIPTS)
  40         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  41
  42 python$(VERSION)-lib.info:      ../lib/lib.tex $(SCRIPTS)
  43         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  44
  45 # Not built by default; the conversion doesn't really handle it well.
  46 python$(VERSION)-mac.info:      ../mac/mac.tex $(SCRIPTS)
  47         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  48
  49 python$(VERSION)-ref.info:      ../ref/ref.tex $(SCRIPTS)
  50         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  51
  52 python$(VERSION)-tut.info:      ../tut/tut.tex $(SCRIPTS)
  53         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  54
  55 # Not built by default; the conversion doesn't handle it at all.
  56 python$(VERSION)-doc.info:      ../doc/doc.tex $(SCRIPTS)
  57         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  58
  59 python$(VERSION)-dist.info:     ../dist/dist.tex $(SCRIPTS)
  60         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  61
  62 # Not built by default; the conversion chokes on two @end multitable's
  63 python$(VERSION)-inst.info:     ../inst/inst.tex $(SCRIPTS)
  64         EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
  65
  66 clean:
  67         rm -f *.texi~ *.texi
  68
  69 clobber: clean
  70         rm -f *.texi python*-*.info python*-*.info-[0-9]*