Kaydet (Commit) c0701236 authored tarafından Fred Drake's avatar Fred Drake

This never saw much use, so remove it.

üst b68c2456
api
doc
ext
icons
lib
mac
ref
tut
# Convenience Makefile for building HTML documentation. You probably need to
# set TEXINPUTS from the command line for this to be useful, unless you
# actually build the .dvi files in the top level directory.
#
# Note that the .dvi files must already be built and TEXINPUTS must include the
# directory where latex's working files (esp. *.aux) are kept.
PAPER=letter
TOPDIR=..
TOOLSDIR=$(TOPDIR)/tools
PAPERDIR=$(TOPDIR)/paper-$(PAPER)
TEXINPUTS=$(TOPDIR)/paper-$(PAPER):$(TOPDIR)/texinputs:
# Where are the various programs?
PYTHON= python
MKAUX= PAPER=$(PAPER) TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --aux
MKHTML= PAPER=$(PAPER) $(TOOLSDIR)/mkhtml.sh --numeric
KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
BUILDINDEX=$(TOOLSDIR)/buildindex.py
# make it clear to l2h, since our support only generates HTML 4.0
L2HARGS= -html_version 4.0
PYTHONDOCS='<hr>Send comments on this document to <a href="mailto:python-docs@python.org">python-docs@python.org</a>.'
HTMLBASE= file:`pwd`
INDEXFILES=api/api.html \
doc/doc.html \
ext/ext.html \
lib/lib.html \
mac/mac.html \
ref/ref.html \
tut/tut.html
COMMONPERL= $(TOPDIR)/perl/manual.perl \
$(TOPDIR)/perl/python.perl \
$(TOPDIR)/perl/l2hinit.perl
all: $(INDEXFILES) icons
.PHONY: api ext lib mac ref tut
api: api/api.html
doc: doc/doc.html
ext: ext/ext.html
lib: lib/lib.html
mac: mac/mac.html
ref: ref/ref.html
tut: tut/tut.html
$(INDEXFILES): $(COMMONPERL) \
$(TOPDIR)/html/about.dat
icons: ../html/icons
if [ ! -d icons ] ; then mkdir icons; fi
cp ../html/icons/*.* icons/
api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh
$(MKHTML) api $(L2HARGS) -split 3
doc/doc.html: $(DOCFILES) $(BUILDINDEX) $(TOPDIR)/perl/ltxmarkup.perl
$(TOOLSDIR)/mkhowto --numeric --split=3 --address $(PYTHONDOCS) \
--html $(TOPDIR)/doc/doc.tex
ext/ext.html: $(PAPERDIR)/ext.aux $(TOOLSDIR)/mkhtml.sh
$(MKHTML) ext $(L2HARGS) -split 3
lib/lib.html: $(PAPERDIR)/lib.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh
$(TOOLSDIR)/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
mv lib1.aux `$(KPSEWHICH) lib.aux`
$(MKHTML) lib $(L2HARGS) -split 3
mac/mac.html: $(MACFILES) $(BUILDINDEX)
$(TOOLSDIR)/mkhowto --numeric --split=3 --address $(PYTHONDOCS) \
--html $(TOPDIR)/mac/mac.tex
ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh
$(MKHTML) ref $(L2HARGS) -split 3
tut/tut.html: $(PAPERDIR)/tut.aux $(TOOLSDIR)/mkhtml.sh
$(MKHTML) tut $(L2HARGS) -split 3
include ../Makefile.deps
$(PAPERDIR)/api.aux: $(APIFILES)
(cd $(PAPERDIR); $(MKAUX) api)
$(PAPERDIR)/ext.aux: $(EXTFILES)
(cd $(PAPERDIR); $(MKAUX) ext)
$(PAPERDIR)/lib.aux: $(LIBFILES)
(cd $(PAPERDIR); $(MKAUX) lib)
$(PAPERDIR)/ref.aux: $(REFFILES)
(cd $(PAPERDIR); $(MKAUX) ref)
$(PAPERDIR)/tut.aux: $(TUTFILES)
(cd $(PAPERDIR); $(MKAUX) tut)
clean:
:
clobber:
rm -rf api/ doc/ ext/ lib/ mac/ ref/ tut/
"Long HTML" Version of the Python Documentation
===============================================
This package provides an alternate HTML formatting of the Python
documentation. Each HTML file represents one chapter from a manual,
or the entirety of a "How-To" document. This mwans there are far
fewer individual HTML files than the normal formatting.
The purpose of this alternate formatting is to provide on-demand
publishers with a format that is easier to convert to the
proprietary formats used in printing. This allows the printed
versions of the documentation to be kept up-to-date more easily than
would be the case if only the more user-centric HTML format were
provided.
Anyone is free to use this version for any purpose, so long as the
copyrights are maintained according to the license statement. These
files are available to all users, including competing on-demand
publishers and re-packagers.
Contact Information
-------------------
If you have questions regarding this distribution, please send email
to:
python-docs@python.org
Additional information and formats of these documents are available
on the Internet. For current packages of these documents and links
to additional materials, please see:
http://www.python.org/doc/
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment