[Python-checkins] python/dist/src/Doc/info Makefile,1.7,1.8 python.dir,1.3,1.4
fdrake@sourceforge.net
fdrake@sourceforge.net
Thu, 02 May 2002 21:50:53 -0700
Update of /cvsroot/python/python/dist/src/Doc/info
In directory usw-pr-cvs1:/tmp/cvs-serv17494/info
Modified Files:
Makefile python.dir
Log Message:
Integrated SF patch #539487 by Matthias Klose:
This patch adds Milan Zamazal's conversion script and
modifies the mkinfo script to build the info doc files
from the LaTeX sources. Currently, the mac, doc and
inst TeX files are not handled.
Explicitly checks for GNU Emacs 21.
Index: Makefile
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/info/Makefile,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** Makefile 17 Jul 2001 16:48:55 -0000 1.7
--- Makefile 3 May 2002 04:50:51 -0000 1.8
***************
*** 5,41 ****
HTMLDIR=$(TOPDIR)/html
MKINFO=$(TOOLSDIR)/mkinfo
! SCRIPTS=$(TOOLSDIR)/html2texi.pl $(TOOLSDIR)/checkargs.pm $(TOOLSDIR)/mkinfo \
! $(TOOLSDIR)/fixinfo.el
! all: python-api.info python-ext.info python-lib.info \
! python-ref.info python-tut.info \
! python-dist.info python-inst.info
! python-api.info: $(HTMLDIR)/api/api.html $(SCRIPTS)
! $(MKINFO) $<
! python-ext.info: $(HTMLDIR)/ext/ext.html $(SCRIPTS)
! $(MKINFO) $<
! python-lib.info: $(HTMLDIR)/lib/lib.html $(SCRIPTS)
! $(MKINFO) $<
# Not built by default; the conversion doesn't really handle it well.
! python-mac.info: $(HTMLDIR)/mac/mac.html $(SCRIPTS)
! $(MKINFO) $<
! python-ref.info: $(HTMLDIR)/ref/ref.html $(SCRIPTS)
! $(MKINFO) $<
! python-tut.info: $(HTMLDIR)/tut/tut.html $(SCRIPTS)
! $(MKINFO) $<
! python-dist.info: $(HTMLDIR)/dist/dist.html $(SCRIPTS)
! $(MKINFO) $<
! python-inst.info: $(HTMLDIR)/inst/inst.html $(SCRIPTS)
! $(MKINFO) $<
clean:
--- 5,66 ----
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)-doc.info python$(VERSION)-inst.info
! # python$(VERSION)-mac.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) $< $@
!
! python$(VERSION)-ext.info: ../ext/ext.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
!
! python$(VERSION)-lib.info: ../lib/lib.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
# Not built by default; the conversion doesn't really handle it well.
! python$(VERSION)-mac.info: ../mac/mac.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
! python$(VERSION)-ref.info: ../ref/ref.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
! python$(VERSION)-tut.info: ../tut/tut.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
! # Not built by default; the conversion doesn't handle it at all.
! python$(VERSION)-doc.info: ../doc/doc.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
! python$(VERSION)-dist.info: ../dist/dist.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
!
! # Not built by default; the conversion chokes on two @end multitable's
! python$(VERSION)-inst.info: ../inst/inst.tex $(SCRIPTS)
! EMACS=$(EMACS) $(MKINFO) $< $@
clean:
***************
*** 43,73 ****
clobber: clean
! rm -f *.texi python-*.info python-*.info-[0-9]*
!
!
! # This makes sure we can build info files from a "clean" tree,
! # in case we haven't already built the HTML:
!
! $(HTMLDIR)/api/api.html:
! cd $(HTMLDIR) && $(MAKE) api
!
! $(HTMLDIR)/ext/ext.html:
! cd $(HTMLDIR) && $(MAKE) ext
!
! $(HTMLDIR)/lib/lib.html:
! cd $(HTMLDIR) && $(MAKE) lib
!
! $(HTMLDIR)/mac/mac.html:
! cd $(HTMLDIR) && $(MAKE) mac
!
! $(HTMLDIR)/ref/ref.html:
! cd $(HTMLDIR) && $(MAKE) ref
!
! $(HTMLDIR)/tut/tut.html:
! cd $(HTMLDIR) && $(MAKE) tut
!
! $(HTMLDIR)/dist/dist.html:
! cd $(HTMLDIR) && $(MAKE) dist
!
! $(HTMLDIR)/inst/inst.html:
! cd $(HTMLDIR) && $(MAKE) inst
--- 68,70 ----
clobber: clean
! rm -f *.texi python*-*.info python*-*.info-[0-9]*
Index: python.dir
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/info/python.dir,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** python.dir 17 Jan 2002 21:27:00 -0000 1.3
--- python.dir 3 May 2002 04:50:51 -0000 1.4
***************
*** 3,10 ****
* Python Library: (python-lib). Python Library Reference
* Python Reference: (python-ref). Python Reference Manual
- * Python Distutils: (python-dist). Distributing Python Modules
* Python API: (python-api). Python/C API Reference Manual
* Python Extending: (python-ext). Extending & Embedding Python
- * Python Mac Modules: (python-mac). Python Macintosh Modules
* Python Tutorial: (python-tut). Python Tutorial
--- 3,12 ----
* Python Library: (python-lib). Python Library Reference
+ * Python Mac Modules: (python-mac). Python Macintosh Modules
* Python Reference: (python-ref). Python Reference Manual
* Python API: (python-api). Python/C API Reference Manual
* Python Extending: (python-ext). Extending & Embedding Python
* Python Tutorial: (python-tut). Python Tutorial
+ * Documenting Python: (python-doc). Documenting Python
+ * Installing Modules: (python-inst). Installing Python Modules
+ * Distributing Modules: (python-dist). Distributing Python Modules