Skip to content

C
cpython
Commit 2023d38a authored by Fred Drake's avatar Fred Drake
Browse files
Options

Relocating file to Doc/tools.

parent 0b0e7b56
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 0 additions and 2005 deletions
Doc/custlib.py deleted 100644 → 0
View file @ 0b0e7b56
# 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}"""
Doc/fix.el deleted 100644 → 0
View file @ 0b0e7b56
; 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)
Doc/fix_hack deleted 100755 → 0
View file @ 0b0e7b56
#!/bin/sh
sed -e 's/{\\ptt[ ]*\\char[ ]*'"'"'137}/_/g' <"$1" > "@$1" && mv "@$1" $1
Doc/fix_libaux.sed deleted 100755 → 0
View file @ 0b0e7b56
#! /usr/bin/sed -f
s/{\\tt \\hackscore {}\\hackscore {}/\\sectcode{__/
s/\\hackscore {}\\hackscore {}/__/
Doc/indfix.py deleted 100755 → 0
View file @ 0b0e7b56
#! /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()
Doc/keywords.py deleted 100644 → 0
View file @ 0b0e7b56
#! /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
Doc/mktarball.sh deleted 100755 → 0
View file @ 0b0e7b56
#! /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
Doc/modindex.py deleted 100755 → 0
View file @ 0b0e7b56
#! /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()
Doc/newind.py deleted 100755 → 0
View file @ 0b0e7b56
#! /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}"
Doc/node2label.pl deleted 100755 → 0
View file @ 0b0e7b56
#!/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}");
}
Doc/texi2html.py deleted 100644 → 0
View file @ 0b0e7b56
This diff is collapsed.
Doc/text2latex.py deleted 100644 → 0
View file @ 0b0e7b56
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()
Doc/whichlibs deleted 100755 → 0
View file @ 0b0e7b56
#!/bin/sh
sed -n 's/^\\input{\(lib[a-zA-Z0-9_]*\)}.*/\1.tex/p' lib.tex
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
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7