Fred Drake
7a64b355c1
For now, comment out the \ignorePlatformAnnotation; the global index
...
doesn't really work with this.
1999-04-13 22:19:21 +00:00
Fred Drake
9444df0844
Don't include the verbatim style; the default handling is better.
1999-04-13 22:17:55 +00:00
Fred Drake
1cc5899742
Fix problem of LaTeX leakage in the module synopsis tables at the
...
beginning of chapters. Known problem reported by Barry Scott
<barry@scottb.demon.co.uk>.
1999-04-13 22:08:59 +00:00
Fred Drake
e331356ff7
Fix availability declaration for popen2 module; report by Barry Scott
...
<barry@scottb.demon.co.uk>.
1999-04-13 22:03:26 +00:00
Fred Drake
b9971b9964
Minor cleanup.
1999-04-13 21:39:31 +00:00
Fred Drake
592dd78408
Fix availability declaration for stat module; report by Barry Scott
...
<barry@scottb.demon.co.uk>.
1999-04-13 21:38:02 +00:00
Fred Drake
31ec33ed60
Work around problems with HTML conversion by making the break and
...
tbreak synopses be all on one line (each). Known problem, most
recently reported by Barry Scott <barry@scottb.demon.co.uk>.
1999-04-13 21:36:44 +00:00
Fred Drake
cc10e0469a
Just in case a copy of the documentation gets released somehow...
1999-04-13 21:22:46 +00:00
Fred Drake
07bd1d1b7b
Ignore the doc/ directory ("Documenting Python").
1999-04-12 15:41:44 +00:00
Fred Drake
bfb092eb86
Misspellling: "occurance" --> "occurrence"
1999-04-09 19:57:09 +00:00
Fred Drake
2e1094e4ef
Use #!/usr/bin/env python instead of #!/usr/local/bin/python.
1999-04-09 14:53:35 +00:00
Guido van Rossum
7969f31c4d
Updated documentation by Per Cederqvist. I've added back the
...
documentation sendmail() to reflect the changes by The Dragon
(see smtplib.py checkin).
1999-04-07 15:56:51 +00:00
Fred Drake
4f21d54764
Added more "See also" entries, + 1 inline hyperlink.
1999-04-05 22:18:12 +00:00
Fred Drake
ea003fcc2a
Fixed latex2html weirdness with footnotes.
1999-04-05 21:59:15 +00:00
Jeremy Hylton
45b0aeda3c
correct version info for zlib.
...
add note about module failing with old versions of the library.
update comment that explains that this doc is *still* out of date
1999-04-05 21:55:21 +00:00
Fred Drake
93aa0f23a7
Fixed latex2html weirdness with footnotes.
1999-04-05 21:39:17 +00:00
Fred Drake
b55ce1e8b6
Fixed latex2html weirdness with footnotes.
1999-04-05 21:32:52 +00:00
Fred Drake
52e2d51ef3
Fixed latex2html weirdness for a footnote.
1999-04-05 21:26:37 +00:00
Fred Drake
9aa8543c84
open() description: Made it more clear that 'b' should always be
...
added to the mode value for binary files to improve
portability.
Fixed latex2html weirdness with a couple of footnotes.
1999-04-05 21:22:41 +00:00
Fred Drake
01553706bf
Added a few items to the "See also" sections at Guido's prompting. Made
...
more references to other modules in the text hyperlinks for the HTML and
PDF versions.
1999-04-05 19:46:21 +00:00
Fred Drake
766e0cbde1
Added "doc" target to match the other document-prefix targets.
1999-04-05 19:28:29 +00:00
Fred Drake
50ae47b0de
Removed bosities around example code; not sure where that stuff crept
...
in!
1999-04-05 19:26:16 +00:00
Fred Drake
1dc3a501a6
Made improvements based on changes just made and comments from
...
Bernhard Reiter <bernhard@csd.uwm.edu>.
1999-04-05 19:00:54 +00:00
Fred Drake
275e83489e
Added "Documenting Python" to the index.
1999-03-30 13:43:54 +00:00
Fred Drake
2c4e009b66
Fixed a lot of the smaller nits identified in Guido's comments.
...
Filled in some of the "blank" areas, and added another large blank
area for a LaTeX primer. (Still a lot to be done.)
1999-03-29 14:55:55 +00:00
Fred Drake
806a467fbf
Where rfc822.Message is mentioned, add a link to the rfc822 module.
1999-03-27 05:45:46 +00:00
Fred Drake
7c6a90de8a
Added some rules that affect those little "See also:" sections.
1999-03-25 22:22:45 +00:00
Fred Drake
bb584d3f6e
Be more stylesheet friendly.
1999-03-25 22:18:30 +00:00
Fred Drake
a608a1df87
Require the verbatim package (similar to the LaTeX version).
1999-03-25 22:17:29 +00:00
Guido van Rossum
cb1f2420ea
Document complex() with string arg.
1999-03-25 21:23:26 +00:00
Guido van Rossum
5fc9c869dd
SIGTERM is no longer caught to call sys.exitfunc.
...
This change was made long ago but the documentation was never updated.
1999-03-25 20:30:00 +00:00
Fred Drake
2cafcbb440
Remove \platformof support, since it's been removed from the LaTeX
...
style sheet.
Small nits.
1999-03-25 16:57:04 +00:00
Fred Drake
e82f5b3d6e
Added note about ftpmirror.py, since that seems to be one of the most
...
requested Python tools/examples.
1999-03-25 05:04:17 +00:00
Fred Drake
9b8afdee44
Use more recent option to \pdfdest to not change the zoom factor.
...
This is in response to a comment from Wes Rishel <wes@rishel.com>.
1999-03-24 14:16:17 +00:00
Guido van Rossum
8be229650d
Document new builtin buffer(). Greg Stein.
1999-03-19 19:10:14 +00:00
Fred Drake
7d5f5dd6aa
Added htmldoc, to generate the HTML for "Documenting Python".
1999-03-18 19:08:47 +00:00
Fred Drake
1468d77ff8
Add "Documenting Python" to the list of processed documents.
1999-03-18 19:07:04 +00:00
Fred Drake
03dffcce0e
LaTeX2HTML support for the ltxmarkup package.
1999-03-18 16:42:28 +00:00
Fred Drake
9466b9a10d
Add some (commented out) macros to change the page size to the size of
...
typical published manuals, so people can more easily see what they're
really asking for. ;-)
Revise the verbatim environment: simple implementation, but more
compatible if a document also add \usepackage{verbatim} at the
beginning.
Declare \modindex, \bimodindex, \exmodindex, and \stmodindex
obsolete. These still work just fine, but \declaremodule should be
used instead. The obsolete macros will print a warning on standard
out.
1999-03-18 16:18:27 +00:00
Fred Drake
596766772e
Documented FTP.set_pasv().
1999-03-18 16:08:54 +00:00
Fred Drake
e3fd1064de
Make this simpler; don't care about the paper size. Require that the
...
files exist in the current directory.
Add "Documenting Python" to the list of documents listed.
1999-03-18 14:57:53 +00:00
Fred Drake
154d909993
Note that abspath() was added in 1.5.2.
1999-03-17 22:25:11 +00:00
Fred Drake
90fc0a71a5
Be sure "make" understands the "doc" target is phony.
1999-03-17 16:06:51 +00:00
Fred Drake
8d2c0c2ab4
Fixed minor nits, added index entries to make these easier to find for people
...
not familiar with Unix terminology.
1999-03-16 16:40:01 +00:00
Fred Drake
c43e6a2f31
Ignore some more files kept by mkhowto --keep.
1999-03-16 16:14:51 +00:00
Fred Drake
15087437d5
Add support for "Documenting Python".
1999-03-16 16:11:27 +00:00
Fred Drake
8df362cf97
Removed the embedded sections showing module documentation; just
...
\input the module template.
1999-03-16 16:10:31 +00:00
Fred Drake
acffaee46e
New document: "Documenting Python".
1999-03-16 16:09:13 +00:00
Fred Drake
1d8f07acbd
Markup for documenting LaTeX macros and environments.
1999-03-16 16:08:26 +00:00
Fred Drake
f03fdbc063
Added the new sections from Skip Montanaro.
1999-03-15 15:47:30 +00:00
Fred Drake
658cef0141
Preliminary mhlib and telnetlib documents from Skip Montanaro -- thanks, Skip!
1999-03-15 15:44:18 +00:00
Fred Drake
bf5a6d2eb4
Fixed tons of small markup problems.
1999-03-12 19:57:38 +00:00
Fred Drake
b3a20bc44c
Added availabililty annotations to respond to concerns of /F.
1999-03-12 18:34:21 +00:00
Fred Drake
4b1a07ae18
Fixed grammatical error reported by Donald Wallace Rouse II
...
<dwr2@ix.netcom.com>.
1999-03-12 18:21:32 +00:00
Fred Drake
93503ca57b
Fixup the module keys. There were some problems with hosting / processing
...
file HTML files on Windows machines do to case insensitivity.
1999-03-12 16:24:22 +00:00
Fred Drake
be110c1706
Updates based on comments from /F.
1999-03-12 15:27:35 +00:00
Fred Drake
87a42cd61b
Add support for <platform>, some cleanup of module section after
...
creating the <moduleinfo>.
1999-03-11 17:35:12 +00:00
Fred Drake
ee84d5972f
Lots of nits to respond to various comments from users.
1999-03-10 17:25:30 +00:00
Fred Drake
dc12ec8ca0
Fix a number of typos and small grammatical nits pointed out by Detlef
...
Lannert <lannert@lannert.rz.uni-duesseldorf.de>.
Added a comment explaining the cast in the method table for the
keyword arguments sample code, in response to another comment by
Detlef.
1999-03-09 18:36:55 +00:00
Fred Drake
39fc1bc329
Added note about __builtin__._ to section dicussing classes of
...
reserved names, just to avoid confusion on the part of users.
1999-03-05 18:30:21 +00:00
Fred Drake
1acb8740eb
Oops, missed a couple of substitutions in the templates.
1999-03-04 21:33:55 +00:00
Fred Drake
b41f97d6a0
Pass in the 'Send comments to ...' on the mkmodindex command line,
...
just like we do for mkhowto.
1999-03-04 21:25:05 +00:00
Fred Drake
5f7832d125
Allow many more aspects of the generated page to be parameterized, and
...
add a useful usage message. Use 'mkmodindex --help' to display it.
1999-03-04 21:19:57 +00:00
Fred Drake
6de28bd2a8
Added "Internet Config" to index.
1999-03-04 19:00:26 +00:00
Fred Drake
62cc360e38
add_module_idx(): If \ignorePlatformAnnotation is used, only ignore
...
the specified annotation, not any annotation.
1999-03-04 18:41:17 +00:00
Fred Drake
35c3ffdc3f
Fixed description of WSTOPSIG(), added WTERMSIG(). Problem reported
...
by Jonathan Giddy <jon@dgs.monash.edu.au>.
1999-03-04 14:08:10 +00:00
Fred Drake
aaa0d9a3a4
Record the value of $TEXINPUTS in the transcript.
...
Job.message(): New method. Takes care of writing a message to the
user and adding it to the transcript.
1999-03-03 21:57:58 +00:00
Fred Drake
d8ee0e6ca5
Oops, missed version number for pdfTeX. Updated.
1999-03-03 21:44:10 +00:00
Fred Drake
41dee84a40
Lots of small updates.
1999-03-03 21:39:19 +00:00
Fred Drake
b1d839866c
Obsolete; use the Python version instead.
1999-03-03 20:28:17 +00:00
Fred Drake
6b12b1ec1d
Switch to the Python version of mkhowto.
1999-03-03 20:27:10 +00:00
Fred Drake
8b88093b95
Re-written mkhowto in Python; this should be at least a little more
...
portable.
Several things that had been done by running a python script are now a
matter of importing the right module and running a function with a few
parameters.
1999-03-03 20:24:30 +00:00
Fred Drake
749f943a6b
process(): New function that contains the "orchestration" of the
...
actual work.
main(): Just handle the command line and filename determination,
calling process() to do the work.
These changes make this more import-friendly.
1999-03-03 19:36:23 +00:00
Fred Drake
7c8754fafb
process(): New function that contains the "orchestration" of the
...
actual work.
main(): Just handle the command line and filename determination,
calling process() to do the work.
These changes make this more import-friendly.
1999-03-03 19:25:56 +00:00
Fred Drake
aa99a5071e
Be a little more friendly for the generation of the text version: for
...
"blank" navigation icons, use ALT="" instead of ALT="blank"; also add
ALIGN=CENTER for the table, to get a slightly better affect in the
text (the table is full-width, so this doesn't change the appearance
when browsing the HTML).
1999-03-03 16:21:34 +00:00
Fred Drake
a54a887f66
"\platform{UNIX}" should really be spelled "\platform{Unix}".
1999-03-02 17:03:42 +00:00
Fred Drake
f6863c1909
Added \platform annotations.
1999-03-02 16:37:17 +00:00
Fred Drake
46a9438c43
Add information about adding the portability statement.
1999-03-02 16:24:22 +00:00
Fred Drake
7f492ad7b8
Be more flexible to support platform annotations.
1999-03-02 16:22:56 +00:00
Fred Drake
75ab7a6fa4
Clean up *.pla files -- platform annotation information.
1999-03-02 16:22:26 +00:00
Fred Drake
521835c541
Ignore *.pla -- the platform annotation information. Also, remove it for
...
'make clean'.
1999-03-02 16:20:42 +00:00
Fred Drake
d70091eade
Ignore *.pla -- the platform annotation information.
1999-03-02 16:19:37 +00:00
Fred Drake
0c275fa856
Added support for \platform, \platformof, and \ignorePlatformAnnotation.
1999-03-02 16:17:44 +00:00
Fred Drake
557460cb7a
swallow_newline(): Removed function; not really needed. Modified all call
...
sites.
do_cmd_ignorePlatformAnnotation(),
do_cmd_platform(),
do_cmd_platformof(): New functions to support platform dependency
information.
process_all_platformofs(): New function to post-process \platformof macros
using information collected during the initial pass.
process_python_state(): New function. Call all post-processing functions
defined in this file to avoid having to have too much knowledge of
the internals for this stuff in l2hinit.perl.
1999-03-02 16:05:35 +00:00
Fred Drake
2383f6dbbc
Improve handling of module index, to deal with platform annotations a little
...
better.
1999-03-02 16:00:37 +00:00
Fred Drake
01bc01c82e
Changes to accomodate the global module index and platform annotations.
1999-03-02 15:58:20 +00:00
Fred Drake
368b16ad2b
Only use 4 columns in the module index, to accomodate platform annotations.
1999-03-02 15:56:19 +00:00
Fred Drake
43b34da656
extract_tb(): Only describe this function once. Problem reported by
...
Jonathan Giddy <jon@dgs.monash.edu.au>.
1999-02-26 18:51:21 +00:00
Fred Drake
390636382a
Typo: "Availabilty" --> "Availability"
...
Thanks to /F!
1999-02-26 14:05:02 +00:00
Fred Drake
51027c4173
Added note about comments, from Christopher Petrilli.
1999-02-24 22:36:44 +00:00
Fred Drake
16e81f4484
Update some of the top comments and shorten title of the first
...
section.
1999-02-24 19:57:14 +00:00
Fred Drake
093c97a36f
ignore_from_idx(): Fixed bug in regular expression.
1999-02-24 18:39:47 +00:00
Fred Drake
684f78fafe
Add target for modindex.html; a combined lib+mac module index. Also
...
built with target "all".
1999-02-24 17:34:12 +00:00
Fred Drake
2ef38a7a42
Script to combine module index files. Given a list of files that look
...
like modindex.html, create a combined modindex.html file that lists
all the modules. Takes the same parameters as buildindex.py.
1999-02-24 17:33:07 +00:00
Fred Drake
1b102456a6
Ignore a file called modindex.html.
1999-02-24 17:13:54 +00:00
Fred Drake
711fe02ac3
process_nodes(): New function.
...
main(): Moved the node processing between input and ouptut to
process_nodes().
1999-02-24 16:36:48 +00:00
Barry Warsaw
f2b4554403
Document the correct class hierarchy for SystemExit. It is not an
...
error and so it derives from Exception and not SystemError.
1999-02-24 00:27:14 +00:00
Fred Drake
b6cf9a4fc4
Script to help identify undocumented modules. Use -h or --help for
...
usage information.
1999-02-23 23:07:48 +00:00
Fred Drake
8cdee961bf
Dictionaries are created using the "{...}" notation, not the "..."
...
notation. Problem reported by Magnus L. Hetland <mlh@idt.ntnu.no>.
1999-02-23 18:50:38 +00:00
Guido van Rossum
264bd59221
1. Clarify that immutability isn't entirely the same as unchangeable
...
value (because of immutable containers containing mutable objects).
2. Document that func_code, func_defaults and func_doc / __doc__ are
now writable.
1999-02-23 16:40:55 +00:00
Fred Drake
1ec71cb556
Incorporated updates to describe geturl() by Sjoerd Mullender
...
<Sjoerd.Mullender@cwi.nl>.
1999-02-22 22:42:14 +00:00
Fred Drake
ba21d10d9b
Added note about *static* after description of *shared*.
1999-02-22 18:21:17 +00:00
Fred Drake
00a3a65cc0
Refer to the right RFC in the intro.
1999-02-22 17:12:42 +00:00
Fred Drake
0fb7a37667
Reflect the released version.
1999-02-22 15:58:09 +00:00
Fred Drake
9226d8e8a8
Removed "This will be discussed later." where it's not. Reported by
...
Clay Spence <cspence@sarnoff.com>; see entry in ../TODO.
1999-02-22 14:55:46 +00:00
Fred Drake
7d9b13325d
Other chapter titles refer to collections of modules as "Services"; do
...
the same here.
1999-02-22 14:48:00 +00:00
Fred Drake
8ece8041c5
Noted report of missing material in the extending & embedding manual,
...
as reported by Clay Spence <cspence@sarnoff.com>.
1999-02-22 14:37:18 +00:00
Fred Drake
c411fa6861
Revised description of blank line handling for the interpreter, based
...
on a comment from /F.
1999-02-22 14:32:18 +00:00
Fred Drake
fab41f1788
BabylMailbox description: Properly escape the backslashes in the
...
string representations.
1999-02-22 14:26:16 +00:00
Fred Drake
b63e77ccb0
Oops, used a \label twice - fix one of them.
1999-02-22 14:14:48 +00:00
Fred Drake
180b68b3cf
More reasonable section titles.
1999-02-22 13:45:09 +00:00
Fred Drake
76991ec75a
Shorten section title.
1999-02-20 05:20:49 +00:00
Fred Drake
199b79c37b
Added descriptions for BabylMailbox and Maildir (Qmail) mailbox
...
objects.
1999-02-20 05:04:59 +00:00
Fred Drake
67d229ea76
Shorten section title.
1999-02-20 04:51:16 +00:00
Fred Drake
bbac43223c
Shorten a few section titles.
1999-02-20 00:14:17 +00:00
Fred Drake
da57365337
Give subsections reasonable file names in the HTML.
1999-02-19 23:48:05 +00:00
Fred Drake
342501142d
Added an index entry.
1999-02-19 23:45:06 +00:00
Fred Drake
50cdd97ec4
do_cmd_arabic(): Override the l2h-provided version to remove that
...
obnoxious <SPAN CLASS="arabic">...</SPAN> markup.
1999-02-19 23:04:59 +00:00
Fred Drake
df5d50d889
Specify the sizes of H? relative to the normal font size as
...
percentages; using "large", "x-large" makes them too big for
some troublemakers. ;-)
(Not specifying them at all causes some browsers to make them the same
size as normal text. ;-( )
1999-02-19 23:03:04 +00:00
Fred Drake
56f8185a53
Shortened the short synopsis -- too long.
1999-02-19 22:59:56 +00:00
Fred Drake
9f03380d1c
Use more current approach to recording authors.
1999-02-19 22:56:08 +00:00
Fred Drake
c60047575d
Shortened the short synopsis -- way too long.
1999-02-19 22:33:51 +00:00
Fred Drake
d8a41e6391
Fix an amazing number of typos & malformed sentences reported by Detlef
...
Lannert <lannert@uni-duesseldorf.de>.
1999-02-19 17:54:10 +00:00
Fred Drake
f6346345b0
Noted that the module was added in 1.5.2.
1999-02-19 15:46:38 +00:00
Fred Drake
4e7c205470
Update description of what modules "look like" when printed.
1999-02-19 15:30:25 +00:00
Fred Drake
cd71aa2a38
Use current approach to record documentation author.
1999-02-18 21:13:03 +00:00
Fred Drake
2a2f1fe4d5
Record module & documentation author.
1999-02-18 21:10:32 +00:00
Fred Drake
6b103f1e12
Documentation for pyclbr and tokenize modules.
1999-02-18 21:06:50 +00:00
Fred Drake
4d358b5d23
Added sections for pyclbr and tokenize.
1999-02-18 20:40:26 +00:00
Fred Drake
7c829b3179
Remove the "Parsing Python" section. Hurray!
1999-02-18 20:39:44 +00:00
Fred Drake
3d7707a87d
More files.
1999-02-18 20:39:04 +00:00
Fred Drake
93d762fc7a
Mark <verbatim> elements that represent interactive sessions; these
...
become <interpreter-session> elements.
1999-02-18 16:32:21 +00:00
Fred Drake
997eec7cca
Minor adjustments to reflect esis2sgml.py changes.
...
Added "esis" target to only generate the ESIS data.
1999-02-18 16:31:05 +00:00
Fred Drake
607aed7a2c
Some adjustments, mostly to make it more general.
1999-02-18 16:30:16 +00:00
Fred Drake
4cc902f464
Make the _rmtt regular expression deal with the new CSS-friendly
...
changes to the HTML documentation.
1999-02-18 16:11:12 +00:00
Fred Drake
70a66c9d6d
Add notes to __builtin__.float() and string.atof() that the NaN and Inf
...
results are possible but non-portable.
1999-02-18 16:08:36 +00:00
Fred Drake
29fb54f0ca
Update note about the (...) format specifier for PyArg_ParseTuple().
1999-02-18 03:50:01 +00:00
Fred Drake
951eea4733
atof() description: Add information about accepting 'NaN' to produce
...
the NaN value.
1999-02-18 03:49:20 +00:00
Fred Drake
127ed0a71e
Updated list of standard exceptions in section 4.1.
1999-02-17 23:09:05 +00:00
Fred Drake
8e0151725d
Small updates and grammatical adjustments.
...
Remove comment about this manual being out of date from the abstract.
1999-02-17 18:12:14 +00:00
Fred Drake
33698f818b
Removed old dynamic linking chapter.
...
Integrated information on Windows DLLs from Chris Phoenix (Thanks!).
Added "Acknowledgements" area to thank contributing authors.
1999-02-16 23:06:32 +00:00
Fred Drake
2f7bfafe26
Remove all email addresses.
1999-02-16 22:51:09 +00:00
Fred Drake
3de61bc13f
Integrated notes on building extension modules on Windows, by Neil
...
Schemenauer <neil_schemenauer@transcanada.com>.
Thanks, Neil!
1999-02-16 21:14:16 +00:00
Fred Drake
f6838c0f5e
Copy in the stylesheet after latex2html is done.
1999-02-16 20:43:53 +00:00
Fred Drake
fcf57ad959
Copy in the stylesheet after latex2html is done.
1999-02-16 20:28:25 +00:00
Fred Drake
90fdda5404
Become more stylesheet-friendly.
1999-02-16 20:27:42 +00:00
Fred Drake
00d98ee5cc
CSS style sheet for the documentation.
1999-02-16 20:27:08 +00:00
Fred Drake
63f217741e
Bump release to 1.5.2b2.
1999-02-16 20:23:55 +00:00
Fred Drake
f43ce00531
Make sure errors get propogated.
1999-02-16 20:05:43 +00:00
Fred Drake
85a59dd68b
The _O_* constants are defined as O_* in the os module.
1999-02-16 19:41:01 +00:00