mirror of
https://github.com/python/cpython.git
synced 2026-01-06 23:42:34 +00:00
89de74ee94
(which is not to say it's right), so re-enable it. Documenting Python and Installing Python Modules still have problems when converting to GNU info, so we'll continue to leave them out for now.
70 lines
2.1 KiB
Makefile
70 lines
2.1 KiB
Makefile
# Generate the Python "info" documentation.
|
|
|
|
TOPDIR=..
|
|
TOOLSDIR=$(TOPDIR)/tools
|
|
HTMLDIR=$(TOPDIR)/html
|
|
|
|
# The emacs binary used to build the info docs. GNU Emacs 21 is required.
|
|
EMACS=emacs
|
|
|
|
MKINFO=$(TOOLSDIR)/mkinfo
|
|
SCRIPTS=$(TOOLSDIR)/checkargs.pm $(TOOLSDIR)/mkinfo $(TOOLSDIR)/py2texi.el
|
|
|
|
# set VERSION to code the VERSION number into the info file name
|
|
# allowing installation of more than one set of python info docs
|
|
# into the same directory
|
|
VERSION=
|
|
|
|
all: check-emacs-version \
|
|
python$(VERSION)-api.info python$(VERSION)-ext.info \
|
|
python$(VERSION)-lib.info python$(VERSION)-ref.info \
|
|
python$(VERSION)-tut.info python$(VERSION)-dist.info \
|
|
python$(VERSION)-mac.info
|
|
|
|
# python$(VERSION)-doc.info python$(VERSION)-inst.info
|
|
|
|
check-emacs-version:
|
|
@v="`$(EMACS) --version 2>&1 | egrep '^(GNU |X)Emacs [12]*'`"; \
|
|
if `echo "$$v" | grep '^GNU Emacs 21' >/dev/null 2>&1`; then \
|
|
echo "Using $(EMACS) to build the info docs"; \
|
|
else \
|
|
echo "GNU Emacs 21 is required to build the info docs"; \
|
|
echo "Found $$v"; \
|
|
false; \
|
|
fi
|
|
|
|
python$(VERSION)-api.info: ../api/api.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
python$(VERSION)-ext.info: ../ext/ext.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
python$(VERSION)-lib.info: ../lib/lib.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
# Not built by default; the conversion doesn't really handle it well.
|
|
python$(VERSION)-mac.info: ../mac/mac.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
python$(VERSION)-ref.info: ../ref/ref.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
python$(VERSION)-tut.info: ../tut/tut.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
# Not built by default; the conversion doesn't handle it at all.
|
|
python$(VERSION)-doc.info: ../doc/doc.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
python$(VERSION)-dist.info: ../dist/dist.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
# Not built by default; the conversion chokes on two @end multitable's
|
|
python$(VERSION)-inst.info: ../inst/inst.tex $(SCRIPTS)
|
|
EMACS=$(EMACS) $(MKINFO) $< $*.texi $@
|
|
|
|
clean:
|
|
rm -f *.texi~ *.texi
|
|
|
|
clobber: clean
|
|
rm -f *.texi python*-*.info python*-*.info-[0-9]*
|