Commit Graph

1854 Commits

Author SHA1 Message Date
Guido van Rossum 73d8bff44d Document optional kwargs argument to start_new_thread(). Also
document new LockType and reverse the preference for exit()
vs. exit_thread() -- exit() is now preferred and exit_thread() is
obsolete.
1998-06-27 18:25:44 +00:00
Fred Drake e5836d9811 Mark the 'whence' parameter of the file object's seek() method as optional;
it's already decribed that way in the description.
1998-06-25 16:26:56 +00:00
Fred Drake 2d4a54da32 Removed loading of shared font stuff from howto.cls and manual.cls, moving it
to pypaper.sty.

Added the use of the "avant" package to use AvantGarde for the sans-serif
font instead of the helvetica font loaded by the "times" package.
1998-06-22 17:50:34 +00:00
Fred Drake 44c413b05e Make the large letter at the top of each section use the sans-serif font,
like any other header.
1998-06-22 17:27:48 +00:00
Fred Drake 8e7c82648f Added texinputs/pypaper.sty to the list of manual style files, so that the
.dvi files are properly dependent on it.
1998-06-22 17:14:47 +00:00
Andrew M. Kuchling 65b7863efc Fix unclear wording pointed out by Tim Peters, about the interaction between
^ and the pos argument to re.match().
Also, fixed a typo in libregex.tex.
1998-06-22 15:02:42 +00:00
Guido van Rossum a8a1b9bc65 There's no point in mentioning F6 as an alternate EOF on DOS -- it
doesn't work on modern Windows systems, and Control-Z works
everywhere.
1998-06-22 14:28:39 +00:00
Guido van Rossum a7874d1505 Revert the change of revision 1.30. While it's in general a laudable
goal to use isinstance(x, y) instead of comparing type(x) to y, it
doesn't make sense to change this in the example code for the type()
builtin...
1998-06-22 14:07:36 +00:00
Fred Drake 1b0ff2c32f eval() example: Removed final interpreter prompt; other examples don't have
the empty prompt.
1998-06-19 21:19:50 +00:00
Fred Drake 59160706b3 Somewhat updated, but not checked for everything (just the stuff I was using). 1998-06-19 21:18:28 +00:00
Guido van Rossum 7b7f6688d2 Added a stronger warning about changing the dictionary returned by
locals().
1998-06-18 16:45:34 +00:00
Guido van Rossum faac0136f4 # Untabified the example :-( 1998-06-17 22:38:09 +00:00
Guido van Rossum bca1207ac8 Documented that by default the output goes to stderr, and that a file
keyword argument can be used to direct it somewhere else.  Also
documented all the other functions in this module, and even added a
little example.

# Haven't tested the latex for correctness -- all latex installations
# appear broken.
1998-06-17 22:37:26 +00:00
Guido van Rossum 777dcc6b21 Change the description of input() -- it is exactly equivalent to
eval(raw_input(s)).  The statement about breaking a long expression
over multiple lines is no longer true.
1998-06-17 15:16:40 +00:00
Guido van Rossum 872948350f Some extra notes, and describe a new class (AddressList), all by ESR. 1998-06-16 22:27:40 +00:00
Guido van Rossum 60f2f0cf8e Lots of changes to get this in sync with the Frame version.
Added raw strings, imaginary literals, assert and exec (!) keywords, a
table about Resererved classes of identifiers, and more.
1998-06-15 18:00:50 +00:00
Guido van Rossum 0bd3795d6a Two small additions to make it identical to the obsolete Frame version. 1998-06-15 16:27:37 +00:00
Guido van Rossum dc1dab18a5 NewNew abstract, copied from the obsolete Frame version. 1998-06-15 16:27:09 +00:00
Guido van Rossum a3eebe60dc Add warning about use of lowercase/uppercase with maketrans(). 1998-06-11 16:03:30 +00:00
Guido van Rossum 444d0f87c9 Eric Raymond: added doc for isheader(); improved docs for constructor. 1998-06-11 13:50:02 +00:00
Guido van Rossum 1299100324 Document the changes I just checked in. 1998-06-10 21:34:27 +00:00
Guido van Rossum 3e5fe422cc Document several variables that were previously undocumented,
including the new __stdin__, __stdout__ and __stderr__.
Also moved setttrace around to its proper place in the alphabet.
1998-06-10 17:57:44 +00:00
Guido van Rossum 929bd0e02e Added notes about epochs, the year 2038, and a small Y2K disclaimer
(all with index entries!).  Also update the list of functions that
take or yield a time represented as a 9-tuple.
1998-06-09 21:25:41 +00:00
Guido van Rossum 5d23758be7 Added docs for strptime(). 1998-06-09 16:30:56 +00:00
Guido van Rossum 52481484e6 Clarify the type of the signal handler. 1998-06-09 15:42:25 +00:00
Guido van Rossum 13c8ef62e6 Say a bit more about .pyc and .pyo files. 1998-05-29 19:12:23 +00:00
Guido van Rossum a58e9edbef Document missing functions: xor, not, truth, countOf, indexOf, and
(new!) contains.
1998-05-22 18:48:37 +00:00
Fred Drake 6a50ba82ce Minor grammatical correction: "This module perform ..." --> "This module
performs ...".
1998-05-22 18:19:19 +00:00
Fred Drake 885215c3da Added support for AMK's {definitions} environment; thanks for the reminder! 1998-05-20 21:32:09 +00:00
Fred Drake 3bf7865a20 Added {definitions} environment, which has \term to define indivual terms.
Similar to {description}.
1998-05-20 17:42:17 +00:00
Fred Drake e194beb829 Don't use a separate node for footnotes; see if people scream. ;-) 1998-05-19 19:38:49 +00:00
Fred Drake e87ab1fbf2 Fix definition of release_version (global). 1998-05-19 19:37:55 +00:00
Fred Drake 7c68ab2f2b Added entry for mimetypes. 1998-05-19 19:13:01 +00:00
Fred Drake 806a1bf34f webcheck target in this Makefile wasn't used. 1998-05-19 18:04:44 +00:00
Fred Drake 79c0f0efc4 Fix the webcheck target so it checks the right files.... 1998-05-19 18:04:13 +00:00
Fred Drake edde150127 Add mimetypes documentation to library reference dependencies. 1998-05-19 15:04:21 +00:00
Fred Drake b818b46b38 Add section documenting mimetypes module. 1998-05-19 15:03:45 +00:00
Guido van Rossum c85be6a0ff Fix another oldie (item (b) only):
Date:    Fri, 20 Dec 1996 14:47:50 +0100
From:    Lele Gaifax <lele@nautilus.eclipse.it>
To:      Python List <python-list@cwi.nl>
Subject: Typos in ref manual

Hi all,
browsing the reference manual I noticed what seem two small errors:
  a) in the list of keywords (section 2.3.1) 'exec' is missing
  b) in the Operator Precedence table (5.12) the comparison operators
     include '=', but probably '==' was intended.
Hope this help,
lele.
1998-05-16 02:11:10 +00:00
Fred Drake e593b6213a Small change to the l2h target allowing the output dir, $(HTMLDIR), to be
a sibling of the html/ directory in the distribution.
1998-05-15 17:50:32 +00:00
Fred Drake a4565b0796 Update to use latex2html 98.1p5. 1998-05-15 17:14:17 +00:00
Fred Drake 8dbf46a79e Update to use latex2html 98.1p5.
Cleanup temporary files produced by latex2html in the output directory.
1998-05-15 17:13:08 +00:00
Fred Drake e0a0fcd552 Update note about latex2html version required. 1998-05-15 17:03:00 +00:00
Fred Drake cdbd391415 Add support for the Macintosh Library Modules document. 1998-05-15 17:02:10 +00:00
Fred Drake 5b73cdfe60 Revise comment about \let support a little to more accurately reflect the
support that's offered.
1998-05-15 16:59:38 +00:00
Fred Drake 13b1f43851 Ignore the mac/ directory.... 1998-05-15 16:56:44 +00:00
Fred Drake d637406df1 Update to use the output names used by latex2html for the Python Reference
Manual; the old FrameMaker names no longer apply.
1998-05-15 16:18:21 +00:00
Fred Drake 7a4ad0fc83 Extend handling for \let a bit, to also allow \let\something=<character>. We
still don't support things like \let^^M=\something, where ^^M could actually be
any active character.  Print a decent warning if we find one we can't handle.
1998-05-15 13:45:54 +00:00
Fred Drake 8d1b3384c3 Remove debugging echo. 1998-05-15 13:38:21 +00:00
Fred Drake e16f6798ae do_cmd_let(): Simple implementation to allow \let to be used to establish
synonyms for macros.  This supports:

	\let\newname = \oldname
	\let\newname\oldname

This is useful sometimes, and can at least avoid real errors at other times.
1998-05-15 04:28:37 +00:00
Fred Drake d07868ae52 Added support for \developer, \developers, \developersaddress. 1998-05-14 21:00:28 +00:00
Fred Drake 6df93ef9dd Added definitions for \developer, \developers, \developersaddress.
Ask Guido if you really want to know why.  ;-)
1998-05-14 20:56:31 +00:00
Fred Drake df825a10fc Fix the fix to allow the .tex document sources not live in ".". 1998-05-14 20:36:49 +00:00
Fred Drake 25d4e2873c Mostly spurious change to ensure that everyone's version of this picks up the
execute bit.... problem discovered by Guido.
1998-05-14 20:07:10 +00:00
Fred Drake f4fc476885 Don't run tools/toc2bkm.py unless we're building PDF.
Change the way TEXINPUTS gets defined to ensure that the directory containing
the main document file comes before any other dir, to allow documents to have
files that "override" like-named files elsewhere on the search path.  Guido
discovered we needed this.
1998-05-14 20:03:14 +00:00
Fred Drake 5c07d9b028 Updated markup style (got rid of \verb@...@, mostly). 1998-05-14 19:37:06 +00:00
Fred Drake 203b4f1a25 Add an index entry.
Bow to font lock.
1998-05-14 15:16:12 +00:00
Fred Drake 1a87e9d708 Add comments about release status. 1998-05-12 16:50:32 +00:00
Fred Drake e34ab30a3f Switch to .tgz instead of .tar.gz to appease Windows users.
Clean up the clean & clobber targets.
1998-05-11 21:10:15 +00:00
Fred Drake 72dd58d90e Use .tgz instead of .tar.gz for the output file name. 1998-05-11 21:08:39 +00:00
Fred Drake d2af396dd5 Change ignored extension .tar.gz to .tgz. 1998-05-11 21:07:52 +00:00
Fred Drake 2f61cd4dcc Ignore intermediate files. 1998-05-11 21:06:18 +00:00
Fred Drake ba1700c7bb Set the right page size in the PDF output. 1998-05-11 20:42:54 +00:00
Fred Drake d5d473fd5c Add --letter option, similar to --a4. This is a no-op, but can be used from
a Makefile:  mkhowto.sh --$(PAPER).
1998-05-11 20:40:24 +00:00
Fred Drake 8981fdf16e Add the clean, clobber targets here for this directory. 1998-05-11 19:54:57 +00:00
Fred Drake a4c640e142 Reverted the last change; the extra cruft is harmless for formatted versions,
and allows the info to work through this section.
1998-05-11 19:51:11 +00:00
Fred Drake 58ff112e7f Don't be so ugly as to use "set -x" to get the executed commands printed. 1998-05-11 19:06:26 +00:00
Fred Drake 4190fae02a Added a section about documentation for the Mac modules. 1998-05-11 19:05:36 +00:00
Fred Drake 1a3541c29c Oops, better add it to the usage message! 1998-05-11 19:04:56 +00:00
Fred Drake 3504952781 Add easy-to-use support for A4 paper. 1998-05-11 19:04:06 +00:00
Fred Drake efad443351 Remove the tarhtml target; not useful from the sub-make. 1998-05-11 18:54:02 +00:00
Fred Drake 29cabd4cd7 Pass the release number to the tools/mktarball.sh script.
Nits.
1998-05-11 18:53:07 +00:00
Fred Drake f2fa1e2afe Accept the release number on the command line instead of hardcoding it. 1998-05-11 18:52:24 +00:00
Fred Drake 323dc70de5 Don't be so ugly as to use "set -x" to get the executed commands printed. 1998-05-11 18:41:16 +00:00
Fred Drake 2e7edb80e3 do_cmd_kwindex(): Re-implement now that \kwindex is used again (ref man). 1998-05-11 18:31:17 +00:00
Fred Drake d69e2c4f33 Update some of the comments.
Update the .tar.gz targets so that they work from the top level.

Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 18:25:46 +00:00
Fred Drake 41814bc51f In package Override, use the getcwd() function from the Cwd module instead of
the one from Override.pm (part of latex2html).

Absolutize the TEXINPUTS environment variable, since we can't count on
latex2html doing it for us (even though I sent in a patch, and it really
should).
1998-05-11 18:23:35 +00:00
Fred Drake 099b76c3bd Changed some comments.... no longer mention FrameMaker. 1998-05-11 16:31:32 +00:00
Fred Drake b9838d97ad Fix a comment.
Avoid extra level of recursion in the paper-*/ directories.

Added the "info" target to use the subdir.  Partparse, however, is broken
again.
1998-05-08 15:43:08 +00:00
Fred Drake 9447e592d9 No longer needed. 1998-05-08 15:41:23 +00:00
Fred Drake a5d80564af Remove unneeded line. 1998-05-08 15:40:46 +00:00
Fred Drake 02379fab61 Use \ldots, not \dots. The info process doesn't know about \dots. 1998-05-08 15:39:40 +00:00
Fred Drake 8ffa21c7aa Adjust to new file layout. 1998-05-08 15:37:13 +00:00
Fred Drake 47fd8fed7c Move the rules to build the info files here. 1998-05-08 15:36:36 +00:00
Fred Drake 230b530a6a Relocating file to Doc/info. 1998-05-08 15:35:36 +00:00
Guido van Rossum 7b0c9d8a07 exec is a statement, not a function! 1998-05-08 13:27:38 +00:00
Fred Drake 445cfd339c l2h target: Do the "right thing" regarding the paper-*/ subdirs as the other
"big" targets.  Fix is to set the TEXINPUTS on the command line of the
	sub-make.
1998-05-08 04:02:42 +00:00
Fred Drake f4166a478a Some versions of latex2html don't automatically append the .tex extension to
the name of the main .tex source file if it's not in the current directory.
1998-05-08 04:00:56 +00:00
Fred Drake df68e3dd6d $(KPSEWHICH): Use the older style of calling kpsewhich with the arg
specifying *which* type of path to search.  This works for both
	teTeX 0.4 and 0.9.  This is what we call portability these days!  ;-)
1998-05-08 03:46:38 +00:00
Fred Drake 4a9129c7e8 /bin/sed works on both Solaris and RedHat Linux; /usr/bin/sed does not. 1998-05-08 03:42:23 +00:00
Fred Drake 566d20951d Oops! Must have deleted a word by accident before the last check-in of this
file; "make" (the 'all' target) became a no-op!

Now works as previously described.
1998-05-08 02:00:48 +00:00
Fred Drake 19c7c84db8 Be a little more robust handling filenames. 1998-05-07 21:20:39 +00:00
Fred Drake 8923c72c8f Ignore the webchecker turd. 1998-05-07 20:13:21 +00:00
Fred Drake 0a96cca7ec Added the webcheck target here. 1998-05-07 20:00:59 +00:00
Fred Drake f295113f1f Cleaned out some more cruft.
Added some new cruft.

For some of the "big" targets, force things to happen in the "right"
subdirectory, i.e., "make" will build the DVI and PostScript files in the
paper-letter/ directory, and "make PAPER=a4" will build DVI and PostScript
files in the paper-a4/ directory.

Probably still needs some restructuring.
1998-05-07 19:30:16 +00:00
Fred Drake a34f7e6a5d Some cleanup, added clean & clobber targets. 1998-05-07 19:27:40 +00:00
Fred Drake bf332696a1 Add support for a --pdf option to cause a PDF file to be created instead;
most of the processing is the same and has to be done anyway.
1998-05-07 17:28:42 +00:00
Fred Drake f8e4415578 Markup consistency.
Using \input instead of \include to avoid extra .aux files from being
generated.
1998-05-07 17:27:32 +00:00
Fred Drake 47b0ecd580 Small updates. 1998-05-07 16:32:56 +00:00
Fred Drake 0ef1b079a2 Preliminary convenience Makefile. 1998-05-07 15:12:51 +00:00
Fred Drake 106fe12ebf Better go ahead and remove some cruftiness.... 1998-05-07 15:05:56 +00:00
Fred Drake 9cdf08797e Support the new directory structure.
Some targets may be a little raw, but the basic formatting targets are all
tested, primarily for use from the subdirs.  There are probably a few
gotchas, and the paper-*/ directories could use "helper" Makefiles.
1998-05-07 15:03:25 +00:00
Fred Drake 46ed208b46 Relocating file to Doc/html. 1998-05-07 15:00:46 +00:00
Fred Drake fa615bfee1 Ignore .tar.gz files in this directory. 1998-05-07 14:56:41 +00:00
Fred Drake 4383e6e24f Don't ignore the html/ directory. 1998-05-07 14:54:21 +00:00
Fred Drake 8920156d04 New script to drive HTML generation. 1998-05-07 14:53:55 +00:00
Fred Drake 4c9542b271 Ignore subdirectories if your name is "cvs". 1998-05-07 14:51:53 +00:00
Fred Drake 60515f49b8 Sub-makefile that can be used to drive the HTML conversion from this subdir.
Most of the logic is still in the primary Makefile and a new script in
Doc/tools/.
1998-05-07 14:50:22 +00:00
Fred Drake 4775d0a353 Relocating file to mac. 1998-05-07 12:58:57 +00:00
Fred Drake 0a52bdfd4f Relocating file to Doc/ext. 1998-05-07 01:50:47 +00:00
Fred Drake cda63cc875 Relocating file to Doc/lib/ 1998-05-07 01:49:07 +00:00
Fred Drake bbe33c5594 More changes to support the new directory structure. 1998-05-07 01:39:06 +00:00
Fred Drake 5360879740 New helper script to build the .dvi for a Python manual; usable for the
api, ext, ref, and tut manuals.  The Library Reference requires too much
special index processing to make it beneficial to extend this to support
it.
1998-05-07 01:38:16 +00:00
Fred Drake 8e6c6b2645 Relocating file to Doc/ref. 1998-05-07 01:36:12 +00:00
Fred Drake 64958d593c Relocating file to Doc/mac. 1998-05-06 21:54:44 +00:00
Fred Drake 2880beb3d9 Relocating file to Doc/api. 1998-05-06 21:51:05 +00:00
Fred Drake 56727e2b70 Relocating file to Doc/tut. 1998-05-06 21:49:56 +00:00
Fred Drake 99a5c087c6 Change the set of subdirectories to ignore. 1998-05-06 21:46:08 +00:00
Fred Drake ffe9b459ab Ignore intermediate files. 1998-05-06 21:43:40 +00:00
Fred Drake f24b3a3c7c Ignore temporary files. 1998-05-06 21:43:11 +00:00
Fred Drake 0d162d0eb6 Modified version of ../texinputs/pypaper.sty that specifies A4 paper. 1998-05-06 21:40:50 +00:00
Fred Drake dde91f000a Fix a bogus \code@...@ to be \code{...}.
Normalize some other markup.
1998-05-06 20:59:46 +00:00
Fred Drake 744a662f36 Relocating file to Doc/texinputs. 1998-05-06 20:20:14 +00:00
Fred Drake f666917ab7 The Python Reference Manual. 1998-05-06 19:52:49 +00:00
Fred Drake a6bb39622c First cut at welcoming the Python Reference Manual back to the fold. 1998-05-06 19:51:39 +00:00
Fred Drake 0cabff904f \itembreak,
\itemjoin,
\kwindex:  Revived definitions to support the Python Reference Manual.
1998-05-06 19:36:01 +00:00
Fred Drake f7ffa92ce3 Fix typo in example found by Anthony Starks <anthony_starks@merck.com>,
reported to me by Piers Lauder <piers@cs.su.oz.au>.
1998-05-06 12:42:37 +00:00
Fred Drake c9b8a57040 cleanup(): Remove *all* the temp files related to index generation! 1998-04-29 21:28:25 +00:00
Fred Drake 91eeefdee4 Work around lack of support for \if... in latex2html. 1998-04-29 17:56:44 +00:00
Fred Drake 89a1d4ad3a Set $TEXINPUTS='' to make l2h pick up the right thing from the environment. 1998-04-29 16:58:13 +00:00
Fred Drake 06245ac2fa Fix documentation based on comments from Sean Reifschneider
<jafo-9804@tummy.com>.

Logical markup.
1998-04-29 14:38:34 +00:00
Fred Drake 9fab3aa52e Move a bit closer to HTML generation without depending on the temp files
being in the current directory.

Be more careful cleaning up.

Correct an error in a comment.

Add recent additions to the dependencies for lib.dvi.
1998-04-28 19:20:43 +00:00
Fred Drake 310094ccce do_cmd_sectcode(): Obsolete; removed. 1998-04-28 18:38:40 +00:00
Fred Drake b5aa3de118 Remove extra cruft for texi processing. 1998-04-28 18:37:12 +00:00
Fred Drake 2a3ab4fac1 Do better hiding of internal names. 1998-04-28 18:31:50 +00:00
Fred Drake 08c5dfc5a4 do_cmd_key(): Obsolete; removed. 1998-04-28 18:31:17 +00:00
Fred Drake 24340ea583 Fixed \code so word wrapping is allowed.
Removed some old stuff.

Do better hiding of internal names.
1998-04-28 18:30:34 +00:00
Fred Drake ca6b4fe36b Section for bisect module. 1998-04-28 18:28:21 +00:00
Fred Drake 188a8471b8 Moved popen2 entry to make more sense.
Added bisect entry.
1998-04-28 18:27:53 +00:00
Fred Drake 125024a87d Updated. 1998-04-28 18:27:22 +00:00
Guido van Rossum 2aefe8d7c0 Document changed semantics -- open() now guesses the db type and error
is now a tuple of various and sundry exceptions.
1998-04-28 15:29:26 +00:00
Fred Drake f8d50bfdb0 Hook in the calendar and popen2 sections. 1998-04-28 14:29:27 +00:00
Fred Drake 1c127e74af calendar module section for the library reference, by Drew Csillag. 1998-04-28 14:28:57 +00:00
Fred Drake 6afad3792d popen2 section for the library reference, contributed by Drew Csillag, with
some reorganization.
1998-04-28 14:28:15 +00:00
Fred Drake 2a1cc3e171 Use of \key and \kbd were isolated to one instance each in this file;
normalize to \kbd to allow removal of \key from the document class.
1998-04-28 13:38:54 +00:00
Fred Drake 4f31694d37 Document transfercmd(), ntransfercmd(), delete(), rmd(), size().
Thanks to Timothy Wild <twild@clear.net.nz> for catching the omission of
delete().
1998-04-27 14:54:06 +00:00
Fred Drake 23916e78d0 clean target: Remove intermediate files from creation of outline in PDF. 1998-04-25 04:15:56 +00:00
Fred Drake 724473fbe5 Load the options from the pypaper.sty file before setting up the "base class"
for the manual documents.
1998-04-25 04:12:17 +00:00
Fred Drake b4929a794e Paper size / font size configuration file.
This is separated so I can build A4 and US Letter sizes without having to
edit files.

Anyone who downloads the source package can also simply edit this file,
which is a lot shorter than the manual.cls file, and easier to find the
appropriate line.
1998-04-25 04:11:27 +00:00
Fred Drake 8805354bbc Simplify how some options get propogated. 1998-04-24 21:57:12 +00:00
Fred Drake 3af9f2514f Added libpoplib.tex to dependencies for the library reference.
Some mods to allow PS to be generated when the current dir is *not* Doc;
to help out with generating A4 versions.
1998-04-24 21:07:22 +00:00
Fred Drake a468404dda Added a section for the poplib module, contributed by Drew Csillag. 1998-04-24 20:49:02 +00:00
Fred Drake e28fb67c2c Add entry for poplib. 1998-04-24 20:08:28 +00:00
Guido van Rossum a937d14898 Fred's right -- we need PyList_SET_ITEM(). 1998-04-24 18:22:02 +00:00
Barry Warsaw dc1c970b0f This script appears to no longer be in the toolchain for Python
documentation, so it has been moved to ../../Tools/scripts

Fred, please verify.
1998-04-23 22:57:16 +00:00
Fred Drake 0d27d08790 Don't override the default $ADDRESS. 1998-04-23 20:07:55 +00:00
Fred Drake d757165df9 Change the default $ADDRESS. 1998-04-23 20:06:24 +00:00
Fred Drake f8830d1de5 Convert recent additions to use new, "logical" markup.
I suppose we really do need a markup guide.  -sigh-
1998-04-23 14:06:01 +00:00
Guido van Rossum 4447513e94 Filled in some more blanks, with the help of Drew Csillag. 1998-04-21 15:30:01 +00:00
Fred Drake 255284b42a Fix problem for the Library Reference where high-numbered sections of
high-numbered chapters took too much space for the section number in the
table of contents.  This makes the section number and title not overlap.
1998-04-20 16:55:14 +00:00
Fred Drake 42de185a77 Added \label to subsections which didn't have one, since this module has
subsections listed in the documentation index sidebar.  (Why?)
1998-04-20 16:28:44 +00:00
Guido van Rossum a933f6a53d Fix vonmisesvariate() -- it now returns an angle between 0 and *two*
times pi.  Got rid of $math$ here and in one other place.
1998-04-20 14:43:44 +00:00
Fred Drake 476412a918 cleanup(): Get rid of module index turds. 1998-04-17 20:25:55 +00:00
Fred Drake daf71fca54 Ignore the mac/ directory where latex2html spits out HTML. 1998-04-17 20:08:36 +00:00
Fred Drake a2890b0986 Make the intro section explicit, so that latex2html puts it on a separate
page from the table of contents.
1998-04-17 20:07:21 +00:00
Fred Drake 7984256f4d build_ps(): Fix flags to dvips.
build_html():  Deal with node2label.pl a little better.
1998-04-17 20:06:16 +00:00
Fred Drake 5ccf330e4c next_optional_argument(): Don't include the square brackets in the return
value.

ArabictoRoman():  Acquired function from Robert Donohue
	<donahue@cfassp48.harvard.edu>; might be useful someday, and I don't
	want to figure it out again!
1998-04-17 20:04:09 +00:00
Fred Drake 4f6d6e487c Fix things. Blame Andy Eskilsson <andy.eskilsson@telelogic.se>.
But I'm not giving this or the info files out until Andy (or anyone else)
agrees to take over the maintenance of this script!  Hah!
1998-04-17 15:28:09 +00:00
Fred Drake 4f5155817b Mark TMPDIR correctly. 1998-04-17 14:51:04 +00:00
Fred Drake bdbdb80b0b Separate the Mac-related files from the library reference files. The new
variable isn't used yet.
1998-04-17 14:01:44 +00:00
Fred Drake 1d9fb63293 Remove commented-out Mac chapter. 1998-04-17 13:24:55 +00:00
Fred Drake 12f842e33e Adjust to allow both general and module indexes.
PDF output properly supports the outline.
1998-04-17 02:52:12 +00:00
Fred Drake 60961c561d Python HOWTO document that replaces the old Mac section from the reference
manual.
1998-04-17 02:47:13 +00:00
Fred Drake b51429a145 Adjust so that it works as part of a HOWTO-based manual. 1998-04-17 02:46:34 +00:00
Fred Drake d579ed8239 Shift (re-)definition of \theindex to the document classes so that it doesn't
break HOWTO documents.
1998-04-17 02:45:41 +00:00
Fred Drake 300775d222 Hide \varvars from "public" interface. 1998-04-17 02:17:00 +00:00
Fred Drake 08932054e9 New helper functions to help deal with parameter parsing.
Use the helpers in do_cmd_*() and do_env_*(); *much* cleaner!
1998-04-17 02:15:42 +00:00
Fred Drake 64bdc24301 Code cleanup, some syntax modernization. 1998-04-17 02:14:12 +00:00
Fred Drake 6b303b4bdd Signature for dir() omitted the optional argument. 1998-04-16 22:10:27 +00:00
Fred Drake bf88c3830e Fix the broken PDF links, really this time!
Appending a junk char to the end doesn't quite do it, or doesn't seem to at
any rate.  Instead, pad the page numbers to always be 3 charaters wide, with
leading zeros.
1998-04-15 17:50:22 +00:00
Fred Drake a2c2a836d7 Fix the broken PDF links, really this time!
"." cannot be part of the target names either.

Appending a junk char to the end doesn't quite do it, or doesn't seem to at
any rate.  Instead, pad the page numbers to always be 3 charaters wide, with
leading zeros.
1998-04-15 17:50:01 +00:00
Fred Drake a88d681255 Change the form of the name given to each page of the PDF from "page.%d" to
"page.%dx"; this works around an acroread bug that causes targets not to be
recognized if their name is a prefix of another target in the file.
1998-04-15 14:53:28 +00:00
Fred Drake d671e8fb87 Added dependency on the tools/toc2bkm.py script for the PDF files. 1998-04-15 14:50:56 +00:00
Guido van Rossum 3c4378bd9b Some patches by Drew Csillag; plus a few of my own uncommitted changes. 1998-04-14 20:21:10 +00:00
Fred Drake 12d9fc94f4 Use shorter labels; using long labels creates problems on the Macintosh.
(Thanks, Just!)
1998-04-14 17:19:54 +00:00
Fred Drake 95638f5b0f Added entry for Tkdnd.py. 1998-04-14 04:55:43 +00:00
Fred Drake e3ae5198a3 Update to use the new release number. Will generalize in the next round. 1998-04-13 21:55:56 +00:00
Fred Drake f5013f1f0c Add RELEASE make variable; this gets the entire release # ("1.5.1"). 1998-04-13 21:02:49 +00:00
Fred Drake 68fede768a Added item in Misc. for getpass module. 1998-04-13 20:31:31 +00:00
Fred Drake 4d2996d473 Fix version number. 1998-04-13 20:29:45 +00:00
Fred Drake 916d8f8733 No more threats, just list the new methods under "AST Objects". 1998-04-13 18:46:16 +00:00
Fred Drake c4f1ca1967 Add a note that pickling is supported. 1998-04-13 16:27:27 +00:00
Fred Drake 3e7a48e0d9 Revert markup around list of display fields from the disassembler; it doesn't
look at good in print, but doesn't break the HTML.
1998-04-13 16:15:02 +00:00
Fred Drake 3ad125e611 Fix bug in little-used markup: don't forget to pass the source text along! 1998-04-13 14:18:57 +00:00
Fred Drake 7238988657 Fixed example to load the startup file from a script (didn't test for the
file's existance).

Removed some XXX comments about extension modules which support pickling.

Added text from AMK about the readline and rlcompleter modules.

Thanks, AMK!
1998-04-13 01:31:10 +00:00
Fred Drake 003d8da779 Typo: (and often severly limited) -- severely
Typo: (but not to the tuple or list into which the item it put!) -- is put

Thanks, AMK!
1998-04-13 00:53:42 +00:00
Fred Drake b85fbec83b "ZeroDevisionError" --> "ZeroDivisionError"
Thanks, AMK!
1998-04-13 00:50:04 +00:00
Fred Drake a608febd5f Fix typo. (What I get for trying to fix bugs at home and running conversions
at work....)
1998-04-12 03:58:13 +00:00
Fred Drake ae9bc67e0e Don't append () to the name of an object attribute in the index. 1998-04-12 03:49:46 +00:00
Fred Drake 6250205166 Use {methoddesc} instead of {funcdesc} for object methods. 1998-04-12 03:31:31 +00:00
Fred Drake 898601bf8f Add cPickle to the list of modules in the chapter. 1998-04-12 03:08:41 +00:00
Fred Drake d6d88ffaf9 Add cStringIO to the list of modules in the chapter. 1998-04-12 03:07:35 +00:00
Fred Drake c303e67f3c The built-in exceptions are not still strings, so make no claims about them. 1998-04-12 02:48:47 +00:00
Fred Drake c94d9348ca In descriptions of Py_GetPrefix() and Py_GetExecPrefix(), make sure the
"--" at the start of the configure options isn't collapsed to "-" when the
HTML is generated.
1998-04-12 02:39:13 +00:00
Fred Drake 1072e46263 Added a simpler, working {verbatim} support that generates legitimate HTML.
(2 lines, explained by 6 lines of comments....)
1998-04-12 02:16:34 +00:00
Fred Drake b73bc31e39 Removed partially broken {verbatim} support. 1998-04-12 02:13:14 +00:00
Fred Drake ee60191d1d Lighten up tables. 1998-04-11 20:53:03 +00:00
Fred Drake 17e564042d Change order of \seemodule macros at end of pickle module section. 1998-04-11 20:43:51 +00:00
Fred Drake 9463de2092 Document cPickle and cStringIO. 1998-04-11 20:05:43 +00:00
Fred Drake fab2f34538 When the text of a table cell should be wrapped, used a "p" column. 1998-04-11 18:46:56 +00:00
Fred Drake 7e9383ab59 Add a comment to indicate the methods of the StringIO are being discussed... 1998-04-11 18:05:24 +00:00
Fred Drake 70c460c84d Remove imaplib from the undocumented list. 1998-04-11 16:58:26 +00:00
Fred Drake a38a2867d0 Include () after function name.
One more logical mark.
1998-04-11 16:57:05 +00:00
Fred Drake 0d213d3497 When the text of a table cell should be wrapped, used a "p" column. 1998-04-11 16:40:46 +00:00
Fred Drake 2b8c95e4ed Minor housing cleaning in HTML that gets generated. 1998-04-11 16:26:02 +00:00
Fred Drake 34672dbb38 Remove over-active replace-string turds. 1998-04-11 16:24:21 +00:00
Fred Drake 8f6b958fdb Use {memberdesc} to mark the instance attributes. 1998-04-11 15:11:55 +00:00
Fred Drake 7dba8e2ab4 Hmmm... better add some \label macros for logical addressing while I'm at it. 1998-04-11 13:51:05 +00:00
Fred Drake 2a37455967 It's "Lauder", not "Lauders"! 1998-04-11 13:48:26 +00:00
Fred Drake 9d4b6c52c3 Update the module index support to use the changed field separator for the
input file to buildindex.py.
1998-04-11 05:21:14 +00:00
Fred Drake e5cf53ad89 Formatting nits.
An index entry.
1998-04-11 05:02:45 +00:00
Fred Drake eb4ed15be8 Shift index entries around a little so the HTML doesn't have weird spacing. 1998-04-11 04:52:15 +00:00
Fred Drake 1e0f8bfea9 Add imaplib to appropriate lists. 1998-04-11 04:27:07 +00:00
Fred Drake 36751b0ed2 Remove obsolete module soundex from list of modules. 1998-04-11 04:23:07 +00:00
Fred Drake c48b772a77 Remove obsolete module rand from list of modules.
Add fileinput to list.
1998-04-11 04:22:02 +00:00
Fred Drake 89de314cfc First cut at documentation for imaplib. Based on original documentation by
Piers Lauders.
1998-04-11 04:19:04 +00:00
Fred Drake 756a9e87b1 do_env_memberdesc(): Fix argument parsing for {memberdesc} environments.
(The bug was detected by the Q/A team -- me!  Please, help review the docs!)
1998-04-11 03:12:06 +00:00
Fred Drake 007bac3b0b Added smtplib.py (thanks, Guido!). 1998-04-09 18:54:01 +00:00
Fred Drake 2cb824cbf9 Don't use \samp when \code is better.
Consistently use ' instead of ":  this conforms to my unofficial stance that
constants should be presented using the repr() whenever it makes sense.  This
isn't because I think repr() is the greatest thing since spam, just that it's
an easy to adopt consistency standard.  (It also holds no new surprises!)
1998-04-09 18:10:35 +00:00
Fred Drake 5cca42e0b7 do_cmd_lineii(),
do_cmd_lineiii():  Fix markup style conversion to HTML tags for first column.
	(The endtag wasn't formed properly.)
1998-04-09 17:59:11 +00:00
Fred Drake 6b529ae0c0 Remove @webchecker.pickle in the "clean" target. 1998-04-09 15:46:36 +00:00
Fred Drake 45c634ecae Work around a small (& annoying) limitation of the latex2html support for
\seemodule.  This is far easier than figuring out the real problem, but it
works.
1998-04-09 15:44:58 +00:00
Fred Drake 8a254b5967 Removed misleading comment about GNU software. This module and the zlib
library have no relationship with GNU software other than implementing some of
the same algorithms and file format.  (The zlib module is more general.)
1998-04-09 15:41:44 +00:00
Fred Drake 45084ed52a Added note about current status of info generation. 1998-04-09 15:19:41 +00:00
Andrew M. Kuchling 253328104f Many markup changes (to \regexp, mostly)
Clarified text on 8-bit cleanness, complemented sets like [^5], and {m,n}
  qualifier.
1998-04-09 14:56:04 +00:00
Fred Drake 02a8e6b600 Update release number and date. 1998-04-09 14:50:47 +00:00
Fred Drake 20ca9171c1 Don't assume that \version expands to the 3-character major.minor number; it
is the full release version name ("1.5.1beta1", for instance).

Add section for previously documented obsolete modules.  Includes ni, rand,
and soundex.
1998-04-09 14:32:28 +00:00
Fred Drake 363ab1a613 Comment out the soundex section. 1998-04-09 14:23:48 +00:00
Fred Drake 2de75ec245 Don't assume that \version expands to the 3-character major.minor number; it
is the full release version name ("1.5.1beta1", for instance).
1998-04-09 14:12:11 +00:00
Fred Drake 9da38814a3 Use the correct URL to AMK's regex-to-re HOWTO! 1998-04-09 14:06:33 +00:00
Fred Drake 54c3947fbc Updated URL to AMK's regex-to-re HOWTO. 1998-04-09 14:03:00 +00:00
Fred Drake 5406e7071f Added reference to AMK's HOWTO on the topic. 1998-04-09 14:02:02 +00:00
Fred Drake 223395c0a0 Added imaplib. 1998-04-09 13:55:06 +00:00
Fred Drake b8efda01e6 Update URL to the related HOWTO document. 1998-04-09 13:49:18 +00:00
Fred Drake bd400881dd Add section for ni back in, but comment it out. 1998-04-09 11:04:19 +00:00
Fred Drake eac469ca3d Commented out sections on obsolete & Macintosh modules. 1998-04-09 04:51:07 +00:00
Fred Drake f1b72ddf82 Reduced description of the obsolete method Stats.ignore(). 1998-04-09 04:49:56 +00:00
Fred Drake 058068d992 Nearly a complete re-write.
Basically, it now works and produces a nice-looking HTML index.

Shows some promise for extensibility, but still young.  Needs useful comments.
1998-04-08 23:12:51 +00:00
Fred Drake 166abbabf9 Remove option to strip out <tt>...</tt> from index entry text; this is now
left to the buildindex.py script.

Change the field separator used in the index.dat file so utilities like grep
are useful on these files; they can't typically handle NUL bytes.

Protect index entries for environment variables from being handled as
case-insensitive by buildindex.py.
1998-04-08 23:10:54 +00:00
Guido van Rossum ae2be7144d Correct definition of CTIME. 1998-04-08 22:44:25 +00:00
Fred Drake 3f3c25fc03 Set flag to remove <tt>...</tt> markup from the index entries; it just ends up
looking really bad in popular browsers, mostly due to vertical size differences
between the roman and monospaced fonts.
1998-04-08 13:46:24 +00:00
Fred Drake 2764dd33cf Separate sections on anydbm and dumbdbm.
This is the last separation; each module now gets its own section.  This will
be useful in performing conversions.
1998-04-07 22:08:02 +00:00
Fred Drake 8e729ec31a Caught a few more spurious \setindexsubitem macros.... 1998-04-07 22:06:41 +00:00
Fred Drake 5ab5503b8a Use {classdesc} and {memberdesc} where appropriate. 1998-04-07 22:01:33 +00:00
Fred Drake a3f5c32f18 Removed unnecessary \setindexsubitem. 1998-04-07 21:45:52 +00:00
Fred Drake 1ce3604cfd Separate UserDict and UserList documentation into separate sections. 1998-04-07 20:05:33 +00:00
Fred Drake df0e3fcb63 Markup nit. 1998-04-07 20:04:27 +00:00
Fred Drake c708605f4f Added a reference to the discussion in Knuth's "Sorting and Searching", and
noted that the original algorithm produces 4-character results rather than
the 6-character results provided by this module.
1998-04-07 19:58:19 +00:00
Fred Drake 41565f66b6 Data attributes of objects should not be indexed with trailing parentheses! 1998-04-07 19:32:40 +00:00
Fred Drake 396b827a93 Minor markup nit. 1998-04-07 19:17:27 +00:00
Fred Drake 82d493fb96 Fixed some index entries. 1998-04-07 19:14:17 +00:00
Fred Drake 6b9ff7257b Added entry for wdb. 1998-04-07 19:09:32 +00:00
Fred Drake 810349b685 Fix the formatting of the list of fields in the disassemble() function. 1998-04-07 14:16:41 +00:00
Fred Drake 272fb3aaa4 Added poplib.
Made the module lists look like the other module lists in the documentation.
1998-04-07 14:15:28 +00:00
Fred Drake af370ea254 Move a short paragraph outside the description of ASTType. 1998-04-05 20:23:02 +00:00
Fred Drake 3a0351cf85 Remove all uses of \sectcode; we can now use logical markup everywhere. 1998-04-04 07:23:21 +00:00
Fred Drake e7957184d2 Change \sectcode to logical markup. 1998-04-04 07:17:47 +00:00
Fred Drake fc57619811 Remove obsolete \setindexsubitem macros.
Massive migration to methoddesc and memberdesc.

Logical markup as needed.

A sprinkling of index entries for flavor.
1998-04-04 07:15:02 +00:00
Fred Drake 71c1e502f0 Moved some things around.
Adjusted a couple of the comments to be more informative.

Tell a little bit about what obsolete means now, and how to use obsolete
modules.
1998-04-04 07:03:19 +00:00
Fred Drake 13beac1289 Removed obsolete \setindexsubitem macros. 1998-04-04 06:46:51 +00:00
Fred Drake 85ea68b2a2 Added index entries. 1998-04-04 06:46:05 +00:00
Fred Drake 81acc2e988 Remove obsolete \setindexsubitem macro.
Logical markup, methoddesc, etc.
1998-04-04 06:35:41 +00:00
Fred Drake 61f45c7cb5 Remove obsolete \setindexsubitem macro,
Added index entries.

Markup nits.
1998-04-04 06:31:51 +00:00
Fred Drake b208f128b4 Added index entry. 1998-04-04 06:28:54 +00:00
Fred Drake 82143348aa Remove obsolete \setindexsubitem macro. 1998-04-04 06:28:14 +00:00
Fred Drake 858f787a02 Fix index entry for HTMLParser class. 1998-04-04 06:25:27 +00:00
Fred Drake 41788db3e2 Logical markup.
Index entries.
1998-04-04 06:23:02 +00:00
Fred Drake 9b28fe285d Logical markup. 1998-04-04 06:20:28 +00:00
Fred Drake e14dde2117 Fixed description of similarity between m[name] and m.getheader(name),
reported by Samuel L. Bayer.

Use methoddesc instead of funcdesc, etc.
1998-04-04 06:19:30 +00:00
Fred Drake d275de985a Remove obsolete lines like this:
\setindexsubitem{(in module frobnitz)}

These are no longer needed when present before any other \setindexsubitem{}
in the module section.  The indexsubitem is now set by \bimodindex and
\stmodindex.
1998-04-04 05:56:51 +00:00
Fred Drake 4bde97f190 Add fileinput section under Misc. Services. 1998-04-04 05:50:12 +00:00
Fred Drake ea2f2b9409 Use new index style for makeindex.
Add dependency on libfileinput.tex for lib.dvi.
1998-04-04 04:21:45 +00:00
Fred Drake 35ca0d69e1 Document fileinput. 1998-04-04 04:20:51 +00:00
Fred Drake a8e262b0b2 Use the new index style when running makeindex. 1998-04-04 04:20:21 +00:00
Fred Drake 10ad52e8af Minor cleanliness. 1998-04-04 04:19:20 +00:00
Fred Drake 0a2eb138e7 Style specification for building *.ind from *.idx. This is needed to avoid
wrapping of long lines, which tools/indfix.py doesn't understand, and needs
to to handle collapsing of entries which can share a common emtry and just
be short entries themselves.  We get the added benefit of nicer formatting.
1998-04-04 04:18:06 +00:00
Fred Drake 07bcd99873 Start at updating the template a little bit. There's a lot of stuff that's
just not here yet.
1998-04-03 21:25:16 +00:00
Fred Drake 47cfd03dff Increase space between the end of a regexp and the little right floor symbol
used as a closing quote.  At AMK's request.
1998-04-03 21:22:31 +00:00
Fred Drake fe03e81aa5 Removed line of obsolete markup. 1998-04-03 20:35:03 +00:00
Guido van Rossum 791468f731 Some clarifications of out-of-range group indexes/names 1998-04-03 20:07:37 +00:00
Fred Drake 61885924b1 Lots of markup consistency nits.
Logical markup.
1998-04-03 07:16:46 +00:00
Fred Drake 6251c169c6 Small nits.
One more index entry.

Be more specific about an exception raised by range().
1998-04-03 07:15:54 +00:00
Fred Drake 8efde2197b Several minor markup nits. 1998-04-03 07:13:56 +00:00
Fred Drake 9f6aec870e "alternative" is a noun, use "alternate" for the adjective.
Minor nits.
1998-04-03 07:12:52 +00:00
Fred Drake 14c198b146 Talk about some minor nits... 1998-04-03 07:11:32 +00:00
Fred Drake 395e8e4860 Capitalize "Python" for consistency.
Describe UserDict and UserList individually so they aren't too hideous in
the presentation.
1998-04-03 07:10:41 +00:00
Fred Drake 7932a6bf8c Small markup nits. 1998-04-03 07:09:38 +00:00
Fred Drake d59db4f974 Small consistency nits. 1998-04-03 07:06:56 +00:00
Fred Drake 2123774287 Capitalize "Python" for consistency. 1998-04-03 07:06:01 +00:00
Fred Drake e6cedb362c New index entries. 1998-04-03 07:05:16 +00:00
Fred Drake 3f1c4720b5 Use {methoddesc} as appropriate. 1998-04-03 07:04:45 +00:00