mirror of https://github.com/python/cpython
Relocating file to Doc/tools.
This commit is contained in:
Fred Drake
parent
0b0e7b5686
commit
2023d38a58
|
|
@ -1,73 +0,0 @@
|
|||
# Generate custlib.tex, which is a site-specific library document.
|
||||
|
||||
# Phase I: list all the things that can be imported
|
||||
|
||||
import glob, os, sys, string
|
||||
modules={}
|
||||
|
||||
for modname in sys.builtin_module_names:
|
||||
modules[modname]=modname
|
||||
|
||||
for dir in sys.path:
|
||||
# Look for *.py files
|
||||
filelist=glob.glob(os.path.join(dir, '*.py'))
|
||||
for file in filelist:
|
||||
path, file = os.path.split(file)
|
||||
base, ext=os.path.splitext(file)
|
||||
modules[string.lower(base)]=base
|
||||
|
||||
# Look for shared library files
|
||||
filelist=(glob.glob(os.path.join(dir, '*.so')) +
|
||||
glob.glob(os.path.join(dir, '*.sl')) +
|
||||
glob.glob(os.path.join(dir, '*.o')) )
|
||||
for file in filelist:
|
||||
path, file = os.path.split(file)
|
||||
base, ext=os.path.splitext(file)
|
||||
if base[-6:]=='module': base=base[:-6]
|
||||
modules[string.lower(base)]=base
|
||||
|
||||
# Minor oddity: the types module is documented in libtypes2.tex
|
||||
if modules.has_key('types'):
|
||||
del modules['types'] ; modules['types2']=None
|
||||
|
||||
# Phase II: find all documentation files (lib*.tex)
|
||||
# and eliminate modules that don't have one.
|
||||
|
||||
docs={}
|
||||
filelist=glob.glob('lib*.tex')
|
||||
for file in filelist:
|
||||
modname=file[3:-4]
|
||||
docs[modname]=modname
|
||||
|
||||
mlist=modules.keys()
|
||||
mlist=filter(lambda x, docs=docs: docs.has_key(x), mlist)
|
||||
mlist.sort()
|
||||
mlist=map(lambda x, docs=docs: docs[x], mlist)
|
||||
|
||||
modules=mlist
|
||||
|
||||
# Phase III: write custlib.tex
|
||||
|
||||
# Write the boilerplate
|
||||
# XXX should be fancied up.
|
||||
print """\documentstyle[twoside,11pt,myformat]{report}
|
||||
\\title{Python Library Reference}
|
||||
\\input{boilerplate}
|
||||
\\makeindex % tell \\index to actually write the .idx file
|
||||
\\begin{document}
|
||||
\\pagenumbering{roman}
|
||||
\\maketitle
|
||||
\\input{copyright}
|
||||
\\begin{abstract}
|
||||
\\noindent This is a customized version of the Python Library Reference.
|
||||
\\end{abstract}
|
||||
\\pagebreak
|
||||
{\\parskip = 0mm \\tableofcontents}
|
||||
\\pagebreak\\pagenumbering{arabic}"""
|
||||
|
||||
for modname in mlist:
|
||||
print "\\input{lib%s}" % (modname,)
|
||||
|
||||
# Write the end
|
||||
print """\\input{custlib.ind} % Index
|
||||
\\end{document}"""
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
; load the new texinfo package (2.xx) if not installed by default
|
||||
; (setq load-path (cons "/ufs/guido/lib/emacs/texinfo-2.14" load-path))
|
||||
(find-file "temp.texi")
|
||||
(texinfo-all-menus-update t)
|
||||
(texinfo-all-menus-update t)
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
#!/bin/sh
|
||||
sed -e 's/{\\ptt[ ]*\\char[ ]*'"'"'137}/_/g' <"$1" > "@$1" && mv "@$1" $1
|
||||
|
|
@ -1,3 +0,0 @@
|
|||
#! /usr/bin/sed -f
|
||||
s/{\\tt \\hackscore {}\\hackscore {}/\\sectcode{__/
|
||||
s/\\hackscore {}\\hackscore {}/__/
|
||||
|
|
@ -1,92 +0,0 @@
|
|||
#! /usr/bin/env python
|
||||
|
||||
"""Combine similar index entries into an entry and subentries.
|
||||
|
||||
For example:
|
||||
|
||||
\item {foobar} (in module flotz), 23
|
||||
\item {foobar} (in module whackit), 4323
|
||||
|
||||
becomes
|
||||
|
||||
\item {foobar}
|
||||
\subitem in module flotz, 23
|
||||
\subitem in module whackit, 4323
|
||||
|
||||
Note that an item which matches the format of a collapsable item but which
|
||||
isn't part of a group of similar items is not modified.
|
||||
"""
|
||||
__version__ = '$Revision$'
|
||||
|
||||
import re
|
||||
import string
|
||||
import StringIO
|
||||
import sys
|
||||
|
||||
|
||||
def cmp_entries(e1, e2, lower=string.lower):
|
||||
return cmp(lower(e1[1]), lower(e2[1])) or cmp(e1, e2)
|
||||
|
||||
|
||||
def dump_entries(write, entries):
|
||||
if len(entries) == 1:
|
||||
write(" \\item %s (%s)%s\n" % entries[0])
|
||||
return
|
||||
write(" \item %s\n" % entries[0][0])
|
||||
# now sort these in a case insensitive manner:
|
||||
if len(entries) > 0:
|
||||
entries.sort(cmp_entries)
|
||||
for xxx, subitem, pages in entries:
|
||||
write(" \subitem %s%s\n" % (subitem, pages))
|
||||
|
||||
|
||||
breakable_re = re.compile(
|
||||
r" \\item (.*) [(](.*)[)]((?:(?:, \d+)|(?:, \\[a-z]*\{\d+\}))+)")
|
||||
|
||||
def main():
|
||||
import getopt
|
||||
outfile = None
|
||||
opts, args = getopt.getopt(sys.argv[1:], "o:")
|
||||
for opt, val in opts:
|
||||
if opt in ("-o", "--output"):
|
||||
outfile = val
|
||||
filename = args[0]
|
||||
outfile = outfile or filename
|
||||
if filename == "-":
|
||||
fp = sys.stdin
|
||||
else:
|
||||
fp = open(filename)
|
||||
ofp = StringIO.StringIO()
|
||||
entries = []
|
||||
match = breakable_re.match
|
||||
write = ofp.write
|
||||
while 1:
|
||||
line = fp.readline()
|
||||
if not line:
|
||||
break
|
||||
m = match(line)
|
||||
if m:
|
||||
entry = m.group(1, 2, 3)
|
||||
if entries and entries[-1][0] != entry[0]:
|
||||
dump_entries(write, entries)
|
||||
entries = []
|
||||
entries.append(entry)
|
||||
elif entries:
|
||||
dump_entries(write, entries)
|
||||
entries = []
|
||||
write(line)
|
||||
else:
|
||||
write(line)
|
||||
del write
|
||||
del match
|
||||
fp.close()
|
||||
if outfile == "-":
|
||||
fp = sys.stdout
|
||||
else:
|
||||
fp = open(outfile, "w")
|
||||
fp.write(ofp.getvalue())
|
||||
fp.close()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
#! /usr/local/bin/python
|
||||
|
||||
# This Python program sorts and reformats the table of keywords in ref2.tex
|
||||
|
||||
import string
|
||||
l = []
|
||||
try:
|
||||
while 1:
|
||||
l = l + string.split(raw_input())
|
||||
except EOFError:
|
||||
pass
|
||||
l.sort()
|
||||
for x in l[:]:
|
||||
while l.count(x) > 1: l.remove(x)
|
||||
ncols = 5
|
||||
nrows = (len(l)+ncols-1)/ncols
|
||||
for i in range(nrows):
|
||||
for j in range(i, len(l), nrows):
|
||||
print string.ljust(l[j], 10),
|
||||
print
|
||||
|
|
@ -1,37 +0,0 @@
|
|||
#! /bin/sh
|
||||
#
|
||||
# script to create the latex source distribution
|
||||
# * should be modified to get the Python version number automatically
|
||||
# from the Makefile or someplace.
|
||||
#
|
||||
# usage:
|
||||
# ./mktarball.sh [tag]
|
||||
#
|
||||
# without [tag]: generate from the current version that's checked in
|
||||
# (*NOT* what's in the current directory!)
|
||||
#
|
||||
# with [tag]: generate from the named tag
|
||||
|
||||
VERSION=1.5
|
||||
|
||||
TEMPDIR=tmp.$$
|
||||
MYDIR=`pwd`
|
||||
|
||||
TAG="$1"
|
||||
|
||||
mkdirhier $TEMPDIR/Python-$VERSION/Doc || exit $?
|
||||
if [ "$TAG" ] ; then
|
||||
cvs export -r $TAG -d $TEMPDIR/Python-$VERSION/Doc python/dist/src/Doc \
|
||||
|| exit $?
|
||||
else
|
||||
cvs checkout -d $TEMPDIR/Python-$VERSION/Doc python/dist/src/Doc || exit $?
|
||||
rm -r `find $TEMPDIR -name CVS -print` || exit $?
|
||||
fi
|
||||
|
||||
cd $TEMPDIR
|
||||
|
||||
(tar cf - Python-$VERSION | gzip -9 >$MYDIR/latex-$VERSION.tar.gz) || exit $?
|
||||
cd $MYDIR
|
||||
rm -r $TEMPDIR || exit $?
|
||||
|
||||
exit 0
|
||||
|
|
@ -1,62 +0,0 @@
|
|||
#! /usr/bin/env python
|
||||
|
||||
"""Script to convert raw module index data to module index."""
|
||||
|
||||
import os
|
||||
import string
|
||||
import sys
|
||||
|
||||
|
||||
def parse_line(input):
|
||||
lineno = string.split(input)[-1]
|
||||
module = string.strip(input[:len(input)-(len(lineno)+1)])
|
||||
return module, lineno
|
||||
|
||||
|
||||
def cmp_items((s1, line1), (s2, line2)):
|
||||
rc = cmp(string.lower(s1), string.lower(s2))
|
||||
if rc == 0:
|
||||
# Make the lower-case version come first since the upper-case
|
||||
# version is usually a helper module for constants and such.
|
||||
rc = cmp(s2, s1)
|
||||
return rc
|
||||
|
||||
|
||||
|
||||
def main():
|
||||
if sys.argv[1:]:
|
||||
infile = sys.argv[1]
|
||||
else:
|
||||
infile = "-"
|
||||
if infile == "-":
|
||||
ifp = sys.stdin
|
||||
ofp = sys.stdout
|
||||
sys.stdout = sys.stderr
|
||||
else:
|
||||
ifp = open(infile)
|
||||
base, ext = os.path.splitext(infile)
|
||||
outfile = base + ".ind"
|
||||
ofp = open(outfile, "w")
|
||||
ofp.write("\\begin{theindex}\n\label{modindex}\n\n")
|
||||
lines = ifp.readlines()
|
||||
for i in range(len(lines)):
|
||||
if lines[i][0] == '\\':
|
||||
lines[i] = '\1' + lines[i]
|
||||
lines = map(parse_line, lines)
|
||||
lines.sort(cmp_items)
|
||||
prev_letter = lines[0][0][0]
|
||||
if prev_letter == '\1':
|
||||
prev_letter = lines[0][0][1]
|
||||
prev_letter = string.lower(prev_letter)
|
||||
for module, lineno in lines:
|
||||
if module[0] == '\1':
|
||||
module = module[1:]
|
||||
if string.lower(module[0]) != prev_letter:
|
||||
ofp.write("\n \\indexspace\n\n")
|
||||
prev_letter = string.lower(module[0])
|
||||
ofp.write(" \\item {\\tt %s}, %s\n" % (module, lineno))
|
||||
ofp.write("\n\\end{theindex}\n")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -1,22 +0,0 @@
|
|||
#! /usr/bin/env python
|
||||
|
||||
"""Really nasty little script to create an empty, labeled index on stdout.
|
||||
|
||||
Do it this way since some shells seem to work badly (and differently) with
|
||||
the leading '\b' for the first output line. Specifically, /bin/sh on
|
||||
Solaris doesn't seem to get it right. Once the quoting works there, it
|
||||
doesn't work on Linux any more. ;-(
|
||||
"""
|
||||
__version__ = '$Revision$'
|
||||
# $Source$
|
||||
|
||||
import sys
|
||||
|
||||
if sys.argv[1:]:
|
||||
label = sys.argv[1]
|
||||
else:
|
||||
label = "genindex"
|
||||
|
||||
print "\\begin{theindex}"
|
||||
print "\\label{%s}" % label
|
||||
print "\\end{theindex}"
|
||||
|
|
@ -1,42 +0,0 @@
|
|||
#!/depot/gnu/plat/bin/perl -i
|
||||
|
||||
# read the labels, then reverse the mappings
|
||||
require "labels.pl";
|
||||
|
||||
%nodes = ();
|
||||
my $key;
|
||||
# sort so that we get a consistent assignment for nodes with multiple labels
|
||||
foreach $label (sort keys %external_labels) {
|
||||
$key = $external_labels{$label};
|
||||
$key =~ s|^/||;
|
||||
$nodes{$key} = $label;
|
||||
}
|
||||
|
||||
# collect labels that have been used
|
||||
%newnames = ();
|
||||
|
||||
while (<>) {
|
||||
# don't want to do one s/// per line per node
|
||||
# so look for lines with hrefs, then do s/// on nodes present
|
||||
if (/HREF=\"([^\#\"]*)html[\#\"]/) {
|
||||
@parts = split(/HREF\=\"/);
|
||||
shift @parts;
|
||||
for $node (@parts) {
|
||||
$node =~ s/[\#\"].*$//g;
|
||||
chop($node);
|
||||
if (defined($nodes{$node})) {
|
||||
$label = $nodes{$node};
|
||||
if (s/HREF=\"$node([\#\"])/HREF=\"$label.html$1/g) {
|
||||
s/HREF=\"$label.html#SECTION\d+/HREF=\"$label.html/g;
|
||||
$newnames{$node} = "$label.html";
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
print;
|
||||
}
|
||||
|
||||
foreach $oldname (keys %newnames) {
|
||||
# or ln -s
|
||||
system("mv $oldname $newnames{$oldname}");
|
||||
}
|
||||
1590
Doc/texi2html.py
1590
Doc/texi2html.py
File diff suppressed because it is too large
Load Diff
|
|
@ -1,55 +0,0 @@
|
|||
import os
|
||||
import sys
|
||||
import regex
|
||||
import regsub
|
||||
import string
|
||||
import getopt
|
||||
|
||||
def main():
|
||||
process(sys.stdin, sys.stdout)
|
||||
|
||||
dashes = regex.compile('^-+[ \t]*$')
|
||||
equals = regex.compile('^=+[ \t]*$')
|
||||
stars = regex.compile('^\*+[ \t]*$')
|
||||
blank = regex.compile('^[ \t]*$')
|
||||
indented = regex.compile('^\( *\t\| \)[ \t]*[^ \t]')
|
||||
|
||||
def process(fi, fo):
|
||||
inverbatim = 0
|
||||
line = '\n'
|
||||
nextline = fi.readline()
|
||||
while nextline:
|
||||
prevline = line
|
||||
line = nextline
|
||||
nextline = fi.readline()
|
||||
fmt = None
|
||||
if dashes.match(nextline) >= 0:
|
||||
fmt = '\\subsection{%s}\n'
|
||||
elif equals.match(nextline) >= 0:
|
||||
fmt = '\\section{%s}\n'
|
||||
elif stars.match(nextline) >= 0:
|
||||
fmt = '\\chapter{%s}\n'
|
||||
if fmt:
|
||||
nextline = '\n'
|
||||
line = fmt % string.strip(line)
|
||||
if '(' in line:
|
||||
line = regsub.gsub('[a-zA-Z0-9_]+()',
|
||||
'{\\\\tt \\0}', line)
|
||||
elif inverbatim:
|
||||
if blank.match(line) >= 0 and \
|
||||
indented.match(nextline) < 0:
|
||||
inverbatim = 0
|
||||
fo.write('\\end{verbatim}\n')
|
||||
else:
|
||||
if indented.match(line) >= 0 and \
|
||||
blank.match(prevline) >= 0:
|
||||
inverbatim = 1
|
||||
fo.write('\\begin{verbatim}\n')
|
||||
if inverbatim:
|
||||
line = string.expandtabs(line, 4)
|
||||
elif not fmt and '(' in line:
|
||||
line = regsub.gsub('[a-zA-Z0-9_]+()',
|
||||
'\\\\code{\\0}', line)
|
||||
fo.write(line)
|
||||
|
||||
main()
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
#!/bin/sh
|
||||
sed -n 's/^\\input{\(lib[a-zA-Z0-9_]*\)}.*/\1.tex/p' lib.tex
|
||||
Loading…
Reference in New Issue