c6d45afb1b
Straighten out dependencies so changes in the texinputs/* get reflected.
1999-10-29 20:49:23 +00:00
6cf186b867
pathes --> paths; typo reported by Gerry Wiener <gerry@ucar.edu>.
1999-10-29 17:51:29 +00:00
5a3194688d
Added dependency on filecmp section, removed dependencies on cmp and
...
cmpcache sections.
1999-10-29 17:27:08 +00:00
47a27b6640
Make references to new filecmp module hyperlinks now that there's
...
documentation.
1999-10-29 17:25:59 +00:00
adf2dbfced
Added section for filecmp.
1999-10-29 17:24:12 +00:00
c7b5b3c998
filecmp documentation from Moshe Zadka <moshez@math.huji.ac.il>.
1999-10-29 17:23:15 +00:00
7eaf6828cb
Added deprecation notes, in case anyone decides to read these anyway.
1999-10-26 16:31:51 +00:00
143db4b041
cmp and cmpcache are now obsolete, so don't include their
...
documentation sections.
1999-10-26 16:28:04 +00:00
a8052a3113
Added cmp and cmpcache to the "Obsolete" section.
1999-10-26 16:27:28 +00:00
714fd26a2f
Documented Beep() function.
1999-10-22 21:08:56 +00:00
d6512808f0
Module/script to parse the reference count data file and make the
...
information accessible to Python.
When run as a script, just dumps the information back out in the data
format, with functions in sorted order and a blank line between
different functions.
Still need to apply the information somehow.
1999-10-20 21:50:31 +00:00
805bf1b330
Added note that Skip created the initial version of this file.
...
Fixed up a few of his ??? comments.
1999-10-20 16:03:38 +00:00
7b7dc6b49d
Initial version as provided by Skip Montanaro <skip@mojam.com>.
1999-10-20 15:06:24 +00:00
39d4a0237a
Fixed typo in explanation of abspath(); noticed by Paul Prescod
...
<paul@prescod.net>.
1999-10-18 14:10:06 +00:00
532998e00d
"make clobber" should remove modindex.html as well.
...
Added realclean and distclean as synonyms for clobber.
1999-09-24 13:51:19 +00:00
88c786dad9
icons/ should not be ignored here now that this is it's real home.
1999-09-24 13:48:38 +00:00
cf1b06ec47
Added --about option to specify the file to load "About this
...
document..." text from, defaulting to ../html/about.dat.
1999-09-23 16:55:09 +00:00
8903be62a8
Tell mkhowto to use stdabout.dat for the documents it processes here.
1999-09-23 16:54:06 +00:00
b35f2b7ef8
Remove some <SPAN> elements that were used only to carry a CLASS
...
attribute; stick the CLASS on an existing element.
Use a variable for the name of the file to get "About this
document..." text from.
1999-09-23 16:53:09 +00:00
f62b352a5e
Remove the "Comments and Questions" section, allowing this to be used
...
for non-standard Python documentation.
1999-09-23 16:48:54 +00:00
b9bd0b7c82
Version of about.dat that should only be used for the standard
...
documentation.
1999-09-23 16:48:05 +00:00
d37cecfda4
Remove some <SPAN> elements that were used only to carry a CLASS
...
attribute; stick the CLASS on an existing element.
1999-09-23 16:45:08 +00:00
f42d7a78fc
Oops, missed this one!
1999-09-23 15:38:14 +00:00
d3d28d39f8
img_tag(): Tighten up the generated SRC attribute a bit; if the image
...
relative URL starts with "./", remove "./".
1999-09-23 15:29:45 +00:00
d52879ccdc
do_cmd_rfc(): Simplify the generated markup.
1999-09-22 19:58:51 +00:00
52ea0ce977
Added --image-type option to allow use of either GIF or PNG images.
...
Job.warning(): New method; use this instead of writing to sys.stderr
directly. Ensures warnings are also sent to the log
file.
Job.log(): New method; write a message to the log file. Use from
.message() and .warning().
1999-09-22 19:55:35 +00:00
191439ab6b
Some updates to allow ../tools/mkhowto to add various bits to the
...
supplemental l2h initialization file it creates and still get all the
right behavior. In particular, it can change the image type and icon
location and not get inconsistent results.
Some code to help suppress various navigational pages; this might be
interesting when generating HTML to create HTML Help documents, since
the navigation support creates confusing hits in the full text
search. HTML Help also provides a lot of the navigational
infrastructure, so duplicating it makes it more tedious to use.
1999-09-22 19:50:51 +00:00
3e1a98a336
PNG version of the icons, converted from the GIFs
...
by Michael Hudson <mwh21@cam.ac.uk>.
1999-09-22 14:38:25 +00:00
0297719180
Added section about where to send comments, questions, & bug reports.
1999-09-21 15:45:06 +00:00
933d5a7c6e
os.name: Note that 'java' is one of the registered names.
1999-09-17 14:38:39 +00:00
e6fb1c4bd3
Added documentation for inet_aton() and inet_ntoa(), from Ben
...
Gertzfield <che@debian.org> (with minor changes).
(Should have been here instead of in the branch in the first place,
since these weren't in for the 1.5.2 release.)
1999-09-16 15:50:00 +00:00
0ba58158c5
Added "import string" to a couple of examples that describe string
...
module functions, to clarify that the import is not automatic.
Suggested by Koray Oner <Koray.Oner@Eng.Sun.COM>.
1999-09-14 18:00:49 +00:00
244ad3ca15
Name the parameter to expr() and suite() "source" instead of "string".
1999-09-09 14:16:36 +00:00
8779f648d2
Added descriptions of the t#, w, and w# PyArg_ParseTuple() format
...
characters; these are the ones for the buffer interface.
1999-08-27 15:28:15 +00:00
0ee4891c82
Update the instructions slightly.
...
Add a new section describing what each of the tools does, in general
terms.
1999-08-26 18:08:13 +00:00
4f0279f439
Removed; no longer needed now that the other tools can handle entity
...
references directly.
1999-08-26 18:05:23 +00:00
abb158f56b
feed(): Added support for ESIS '&' lines.
1999-08-26 18:04:32 +00:00
1f33292542
Remove use of fixgenents.sh; no longer needed.
1999-08-26 17:57:18 +00:00
3cf4eb4e3d
Specify: \geq --> ≥
...
\leq --> ≤
\LaTeX --> LaTeX (just text)
\TeX --> TeX (just text)
1999-08-26 17:56:47 +00:00
f6199edcd3
Conversion.subconvert(): Added support for "entityref" parameters
...
(must be named in the conversion spec.).
TableParser.start_entityref(): New method. Use to support creating
entity references via the conversion specification.
1999-08-26 17:54:16 +00:00
a20581c1e5
write_esis(): Added support for ENTITY_REFERENCE nodes.
1999-08-26 17:51:56 +00:00
53eae8e81b
convert(): Add support for ESIS '&' lines, and make sure we don't
...
silently ignore unrecognized lines.
1999-08-26 17:50:26 +00:00
e7f19200e8
Doco update from Sjoerd Mullender.
1999-08-26 15:57:44 +00:00
2900ff9382
Added paragraph explaining that except clauses can't be empty; that
...
pass can be used if needed. By Dan Wolfe <wolfeman@apple.com>.
1999-08-24 22:14:57 +00:00
4c2533fe3c
Added sentence "All exceptions must have an executable block."; from
...
Dan Wolfe <wolfeman@apple.com>.
1999-08-24 22:14:01 +00:00
b68a125d64
Added additional index entries.
...
Minor markup nits.
1999-08-24 20:16:29 +00:00
76dd228f52
whrandom should come immediately after random, not before.
1999-08-23 20:12:11 +00:00
c924b8d976
Clarified start parameter to Py_CompileString, documented
...
Py_eval_input, Py_file_input, and Py_single_input.
Problems reported by Aaron Brancotti <aaron@icona.it>.
1999-08-23 18:57:25 +00:00
abf8a1daa8
rewrite_descriptor(): Fix bug that dropped the first TEXT node from
...
<description> elements. Add another sanity
check to make sure a special case only becomes
involved for <opcodedesc> and <opcodedescni>
elements.
fixup_paras_helper(): Clean up control flow.
Everywhere that checks node.nodeType==ELEMENT and node.tagName now
just check node.nodeName (nodeName is guaranteed for all node types
and will be special values that don't conflict with GIs for
non-ELEMENT nodes). Simplifies a number of tests and improves
readability in a lot of places.
1999-08-20 14:28:29 +00:00
7eba1d8bbe
Tell what the result objects are (based on comment from the list).
1999-08-19 17:00:38 +00:00
9ed56de752
Added item regarding random/whrandom.
1999-08-19 15:37:35 +00:00
b3fc9d148d
Added disclaimer to the sleep() function.
1999-08-19 14:42:54 +00:00
31e5e37196
Explain the possible range of values for the pid parameter to
...
waitpid().
1999-08-13 13:36:33 +00:00
68921dfa31
In note mentioning [].remove()'s exception, tell what exception is
...
raised. Prompted by Barry's whining. ;-0
1999-08-09 17:05:12 +00:00
d3fbdfd007
Add index entries for open():
...
buffer size, I/O
I/O control, buffering
line-buffered I/O
unbuffered I/O
1999-08-05 13:43:08 +00:00
8c9fc00f8d
Add index entry "I/O control, buffering" for fdopen().
1999-08-05 13:41:31 +00:00
a94f6762bc
Add index entry "I/O control, buffering" for makefile().
1999-08-05 13:41:04 +00:00
58c5a2a53c
Started documentation on buffer objects & types. Very preliminary.
...
Greg Stein: Please help with this; it's your baby!
1999-08-04 13:13:24 +00:00
068bdb181d
Change the directory tree walking example to use clearer variable
...
names, some suggested by Joe Ellsworth.
1999-08-03 21:52:29 +00:00
46ab6dfa89
Re-write in Python for portability. About 30% slower, but who cares?!
1999-08-03 17:54:39 +00:00
82ebc27357
remap_element_names(): Only used for things that the new conversion
...
engine in latex2esis.py can do, so discard it.
paragraph detection & markup: Handle some of the list-like
environments properly, picking up paragraphs inside
list items. (Only changed a few element-sets used for
recognition.)
fixup_refmodindexes_chunk(): Use the right attribute to determine the
module a <ref*modindex/> element is referring to.
convert(): Don't call remap_element_names(); it was removed.
1999-08-03 15:32:48 +00:00
2f6ec9ca81
The new conversion engine supports more of the table re-writing than
...
the old one, so use it.
1999-08-03 15:27:37 +00:00
32bc45f737
Removed PyMapping_Clear() -- it was wishful thinking and serves no
...
great purpose.
1999-08-02 20:49:37 +00:00
83c0983bf6
Use the mksourcepgk script instead of mktarball.sh.
1999-08-02 20:20:14 +00:00
9ff3a6a6e7
Remove obsolete version of script.
1999-08-02 20:19:42 +00:00
9f2b42080a
Re-implementation of mktarball.sh as a more portable Python script;
...
with a more descriptive name.
Allow creation of multiple archive formats with a single pass; useful
in this case since it uses a fresh export/checkout from CVS to ensure
that the tree is "clean" (no build turds, saved files, &c). Use --all
to create all supported formats.
1999-08-02 20:19:17 +00:00
080c1b5af6
bwrite(), ewrite(): Helpers for diagnostic output; essentially the
...
same as sys.stderr.write(), but bwrite() will make it
bold if stderr is a tty (for visibility).
Use these everywhere instead of accessing
sys.stderr.write() directly.
find_all_child_elements(): Find all elements by type name that are
immediate children of another.
cleanup_synopses(): Receive both the document and fragment objects as
parameters; if only the document is passed, synopsis
information is never found since it's in the fragment!
build_para(): Add a chunk of code to ensure that a newline always
follows the </para> end-tag. Not really important, but
makes presentation consistent for authoring/
maintenance.
fixup_bifuncindexes_chunk(): Use find_all_child_elements() instead of
find_all_elements() so we don't work with too many
levels at once; that could cause DOM exceptions with
the <elem>.removeChild() method.
1999-08-02 14:46:15 +00:00
4fbdf9779c
Mostly minor changes.
...
Removed some obsolete commented-out code.
Merged BaseConversion into Conversion since there's only one
conversion process now.
Remove push/pop of output stream; it's no longer needed.
1999-08-02 14:35:25 +00:00
d158b85896
This doesn't need to do nearly as much for the new conversion, so
...
simplify.
1999-08-02 14:32:46 +00:00
031e222499
A few small improvements to the conversion.
1999-08-02 14:32:11 +00:00
c71b802c47
Markup nits.
...
Adjust examples to use the object interface instead of the function
interface.
1999-08-02 14:30:52 +00:00
ce201128b0
Fixed hyperlink references to the __builtin__ and __main__ modules;
...
error reported by Dale Nagata <DNagata@creo.com>.
1999-08-02 14:13:09 +00:00
eac8abee4e
Ripped out the old conversion.
1999-07-29 22:42:27 +00:00
865e9ff98e
Added a few more passes through the document fragment. Not actually
...
very interesting.
1999-07-29 22:23:19 +00:00
96e4a06fa6
Massive changes.
...
Separate the Conversion class into a base and a subclass; the subclass
is pretty minimal but the separation is useful for....
NewConversion: New class that implements a somewhat different
approach to the conversion. This uses a table of
instances (rather than tuples) that have more
information than the tuples used for the older
conversion procedure. This allows a lot more control
over the conversion, and it seems to be pretty
stable.
TableEntry,
Parameter: New classes that are used to build the conversion
specification used by NewConversion.
TableParser: xmllib.XMLParser subclass that builds a conversion
specification from an XML document.
load_table(): Convenience function that loads a table from a file.
main(): Added flags --new and --old; these select which conversion is
used. The default is --new.
Several fixes have been made in the old conversion as well; these were
done before writing & switching to the new conversion, and should be
archived.
The next checkin of this file will discard the old conversion; is is
kept in this checkin to allow it to be retrieved if needed, and to
avoid lossing the bugfixes that have been made to it in the interim.
1999-07-29 22:22:13 +00:00
2394c98c05
Minor updates.
1999-07-29 22:14:09 +00:00
ada2de67b3
Use the (new) buildFragment() method of the EsisBuilder rather than
...
implementing it all here.
1999-07-29 22:13:31 +00:00
f032cdbb24
Some minor cleanup.
1999-07-29 22:03:52 +00:00
bc2285eb60
Conversion specification, used by a new path through latex2esis.py.
...
The specific markup conversion is coded here instead of an even more
cryptic table in the code of latex2esis.py.
1999-07-29 22:03:11 +00:00
478a265057
Minor update.
1999-07-29 22:01:39 +00:00
c35367e439
Change an {\em ...} to \var{...} and a {\bf ...} to \program{...} (the
...
new markup makes sense in context).
These allow the SGML/XML conversion updates to work, & should not have
still been in there anyway.
1999-07-29 13:56:41 +00:00
4ef3ea0cc4
Add support for bzip2 compression.
...
New target: distfiles, create all distribution archives, regardless of
archive format. (Individual targets remain for each archive format.)
1999-07-27 16:30:59 +00:00
5772f33b6c
Add support for bzip2 using --bzip2.
1999-07-27 16:29:30 +00:00
b5213c3010
Ignore additional compressed formats.
1999-07-27 14:23:25 +00:00
8d21243c3e
Added description of optional parameter to UserDict constructor.
...
Omission reported by Barry Warsaw.
1999-07-26 15:45:52 +00:00
7dcc69a979
Add zip archive support for html, pdf, ps, and latex archives.
...
"zips" target produces all possible .zip files.
1999-07-23 16:11:36 +00:00
8ea15f3495
Add --zip parameter; make this able to produce .zip files as well as
...
.tgz files.
1999-07-23 16:09:11 +00:00
de5d5ce7bc
Update getattr() description to document the optional third
...
parameter. Thanks to Barry Warsaw for pointing out the oversight.
1999-07-22 19:21:45 +00:00
06c5a8b52e
Make the default target xml instead of sgml.
1999-07-22 13:57:12 +00:00
7dbde51f97
Make the default target xml instead of sgml.
...
Use a temporary file to pass results from latex2esis.py to
docfixer.py; this makes for better error detection by make (if the
first pipeline stage fails, make wasn't catching it).
1999-07-22 13:56:51 +00:00
5d48e458e4
typo: privide --> provide
...
Reported by Nadim Ghaznavi <nadim@ghaznavi.com>.
1999-07-20 13:21:42 +00:00
860e256147
Added comment clarifying that RELEASE is the documentation release
...
number, not the Python release.
Removed VERSION since it is not used.
1999-07-12 16:52:50 +00:00
6b3fb78ca8
do_cmd_funclineni(): New function; non-indexing form of \funcline.
1999-07-12 16:50:09 +00:00
6db897c52c
Move chdir() and getcwd() descriptions to "Files and Directories" with
...
a pointer from the "Process Parameters" section. Based on comments
from Aahz Maruch, Tim Peters, and GvR.
1999-07-12 16:49:30 +00:00
f930d827bb
Use the same names for CLASS attributes as elsewhere.
1999-07-12 16:28:50 +00:00
bb7eff96d4
Updated Milan's email address.
1999-07-12 15:26:43 +00:00
3a4ceb707d
Several methods return tuples, not lists.
1999-07-07 14:04:38 +00:00
363d67c2e6
Move some misc. comments from the example section to the main section.
...
Use the lowercase versions of the method names in the example, since
that's what's documented (Greg Stein's suggestion). Add a blank line
after the import line for clarity.
1999-07-07 13:42:56 +00:00
1508970a47
dir() method description revised based on comments from Greg Stein.
1999-07-07 13:36:22 +00:00
6166b871a2
Missing space; reported by Robert Kern <kernr@ncifcrf.gov>.
1999-07-06 21:00:18 +00:00
d5dfe984e7
Fix a number of minor problems pointed out by /F.
1999-07-06 15:50:23 +00:00
0d6e6e0b39
Fixed typo reported by /F; thanks!
1999-07-06 15:43:55 +00:00
e72d48d5b2
Bump the release number to 1.5.2p1.
1999-07-06 14:30:04 +00:00
919e74ce88
Darn! Forgot to re-target.
1999-07-02 15:27:14 +00:00
5a8aaa7542
Remove one item.
...
Rearrange & comment on others.
1999-07-02 14:31:41 +00:00
82ac24ffb0
Minor markup nit.
1999-07-02 14:29:14 +00:00
0452007dcc
Added entry for asyncore module.
1999-07-02 14:27:03 +00:00
41796918af
Fix a few markup nits, improve some index entries.
1999-07-02 14:25:37 +00:00
7d80779532
New documentation from Chris Petrilli <petrilli@amber.org>.
1999-07-02 14:25:03 +00:00
227020894a
For spawn*(), point to the magic constants; some readers have a hard
...
time finding the bindings.
1999-07-02 14:01:03 +00:00
e4694eba0f
Removed entries for several modules which have been documented.
...
Updated comments on several remaining modules.
1999-07-01 20:42:57 +00:00
4c8d83f311
Documentation for dl module from Moshe.
1999-07-01 20:40:21 +00:00
44a7a7c5d0
Added entry for dl module.
1999-07-01 20:39:59 +00:00
85b5683307
Remove extraneous "contains" -- pointed out by Daniel Barclay
...
<danielb@digitalfocus.com>.
Added credit to Martin von Loewis for creating the module and
documentation.
1999-07-01 16:31:03 +00:00
859dc53a52
Per Frank Stajano's suggestion, state explicitly that the functions
...
described in the sub-sections are directly available at the module
level. He found this confusing.
1999-07-01 13:54:40 +00:00
b216060627
Make the reference to the os module in the module synopsis (for the
...
table at the front of the chapter) a hyperlink.
1999-07-01 13:53:32 +00:00
f1ad207f2a
Made several grammatical corrections based on comments from Daniel
...
Barcla <danielb@digitalfocus.com>.
Also added example of what happens when a parameter is set both
positionally and by a keyword (one of Daniels suggestions related to
that paragraph).
1999-06-30 15:32:50 +00:00
3d0971e33e
For "Matching vs. Searching", remove comment that the section is
...
incomplete; I don't remember what else I thought I was going to put
in, but it looks o.k. to me know.
1999-06-29 21:21:19 +00:00
9b59a303a8
Added some reminders.
1999-06-29 18:54:03 +00:00
d85b5a418a
Move the setting for secnumdepth to the document classes; make the numbering
...
for the manual class go one deeper than it previously did (\subsection
entries will now be numbered); no change for howto documents.
This makes it easier to refer precisely to smaller sections using \ref.
1999-06-29 18:15:59 +00:00
6bf37debb9
Added some minor prose before the descriptions of the data attributes
...
to make it clear that these are instance attributes, not module data.
1999-06-29 18:13:37 +00:00
abc64b74c8
Added entry for pty module.
1999-06-29 18:12:22 +00:00
a4b5d58790
pty documentation from Moshe; with small edits.
1999-06-29 18:11:22 +00:00
31d10cbe26
Improve description of the example.
1999-06-29 17:08:41 +00:00
f5213c2a3d
Usage nit: a bunch of "nor"s should have been a single "or".
...
Make reference to the copy_reg module a hyperlink.
1999-06-29 16:02:12 +00:00
8ad2703bfb
Minor wording change in section title.
1999-06-29 16:00:22 +00:00
ac00c4c1c6
byteswap() method: Tell *what* exception gets raised when the type
...
cannot be byteswapped.
1999-06-29 15:58:00 +00:00
9118f7cfc4
Remove unnecessary comma.
1999-06-29 15:53:52 +00:00
9e0b6229f6
Comment out XXX comment; this needn't appear in the formatted
...
versions. XXX comments only need to be grep-able.
1999-06-29 15:45:09 +00:00
ef1a029d4c
Add note about not being able to use this module with modules not
...
implemented in Python.
1999-06-29 15:43:02 +00:00
4886c66daf
Moshe: Remove extraneous "and".
1999-06-29 14:57:12 +00:00
e4d78189e8
Added entries for mutex and nis modules.
1999-06-27 15:02:37 +00:00
7fefba5c13
NIS documentation from Moshe.
1999-06-27 15:01:08 +00:00
2231357aa6
Mutex documentation from Moshe.
1999-06-27 15:00:41 +00:00
7a65a26f81
Separate documentation of SUNAUDIODEV from sunaudiodev; this mirrors
...
similar constructs elsewhere (al/AL, gl/GL/DEVICE).
1999-06-27 14:53:11 +00:00
14ae4b48fb
Fix some typos.
...
Add an index entry.
1999-06-25 19:13:36 +00:00
c4e3bf9b5e
Add entries for the sched module.
1999-06-25 18:54:30 +00:00
7e990323b4
Moshe's section on the sched module, with edits.
1999-06-25 18:52:44 +00:00
60b66e1f7b
Update to Sjoerd's documentation of the chunk module, with some
...
additions from Moshe's version. Used my table for describing the
chunk format, and added some markup and index entries.
1999-06-25 17:52:17 +00:00
cf6905f986
Clarify the example by explicitly importing the fcntl module -- this
...
avoid being fooled into thinking that fcntl and FCNTL are the same
thing -- they aren't! (fcntl is the extension, FCNTL.py is h2py
output that defines all the constants).
(XXX The example is still weird -- I think there's a more portable way
to do locking now. That's for someone else to fix...)
1999-06-24 17:58:44 +00:00
7c2426439e
Removed tty module entry.
1999-06-23 17:31:59 +00:00
1b2dc9045e
Add entries for tty module.
1999-06-23 17:29:02 +00:00
0bccd73be0
Updates from Moshe, again edited by me. Describe the parameters to
...
border() using a table instead of text for ease of comprehension.
1999-06-23 17:28:01 +00:00
92f3f41424
Added "See Also" section for termios module.
1999-06-23 15:12:09 +00:00
ae4d5c23f5
Various updates.
1999-06-23 14:56:13 +00:00
66239d5530
tty module documentation from Moshe, with some editing and an added
...
"See also" section.
1999-06-23 14:30:19 +00:00
af81a509c3
Added more sections...
1999-06-23 13:34:22 +00:00
b742a42bc0
Two more from Moshe!
1999-06-23 13:33:40 +00:00
707f8e67b9
Added entry for the chunk module.
1999-06-22 18:50:06 +00:00
97793ab6b9
New section from Moshe Zadka, modified by FLD for markup, some
...
additional content.
1999-06-22 18:49:20 +00:00
0f871dc39e
Added some "See also" references to htmllib docs.
...
Documented htmlentitydefs.
1999-06-21 21:20:56 +00:00
2cd31dc3ea
Added entry for curses module.
1999-06-21 21:14:30 +00:00
4997f4d54a
Added entries for four of Moshe's documentation sections.
1999-06-21 21:13:50 +00:00
a4070cef5e
Preliminary documentation for the curses module by Moshe Zadka, with
...
lots of markup fixes and some English nits fixed.
Still needs real review. Some of the function signatures used in this
module are really bad! (Two leading optional parameters? Ugh!)
1999-06-21 21:13:09 +00:00
d5d55ea02e
Fix a markup error.
1999-06-21 18:36:09 +00:00
4755e7d5c1
Three more modules documented by Moshe!
1999-06-21 18:25:49 +00:00
6f49e0a154
Added a few minor comments, mostly to discourage documentation of
...
really old modules that may become obsolete.
1999-06-18 19:58:59 +00:00
a48a083edb
Added paragraph about potential re-initialization of extension
...
modules; responding to suggestion by Robin Boerdijk
<Robin.Boerdijk@nl.origin-it.com>.
1999-06-18 19:17:28 +00:00
a88ef00a50
Further clarfication of the system-dependence of the system() return
...
value, based on comments from Tim Peters.
1999-06-18 19:11:25 +00:00
46e1a32edf
Re-categorize the dump module as obsolete.
1999-06-18 17:12:15 +00:00
354e98222c
fpformat has been documented for at least a week now!
1999-06-18 15:21:25 +00:00
26921da2c9
Small markup & usage adjustments.
1999-06-17 18:58:02 +00:00
924b42de9c
When looking for things that might be modules, include *module.c from
...
the Modules/ directory. Most of the remaining undocumented modules
seem to be living there.
1999-06-17 18:49:18 +00:00
e019789962
Correction: the parameters of new.instance() are type-checked.
...
Edited several of the descriptions for English usage and more
consistent style.
1999-06-17 18:15:07 +00:00
de69ae1753
Updated version from Moshe, with a re-written warning about the
...
side-effect of cmpcache.cmp() using statcache.stat() internally.
1999-06-17 17:40:52 +00:00
173ba5e3bc
Minor markup nits.
1999-06-17 17:09:23 +00:00
97c2fa03e5
Small English usage nits.
1999-06-17 16:38:18 +00:00
7487c02209
Small markup and English usage nits.
1999-06-17 16:10:39 +00:00
873f0297c3
Add reminder that wave.open() documentation should be updated for the
...
next Python release.
1999-06-17 15:20:44 +00:00
551d2b14e7
Add entries due to additional sections from Moshe.
1999-06-17 15:12:50 +00:00
26da2840ac
Add/remove entries due to additional sections from Moshe.
1999-06-17 15:12:16 +00:00
64bc94e3ec
New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
1999-06-17 15:11:35 +00:00
e55702b024
Added note to __not__() description that this operation is defined
...
only by the interpreter core and is not overridable by objects.
Based on comment from David Ascher on the list.
1999-06-15 20:56:40 +00:00
1e4402998f
Several new index entries to make find this easier.
...
Noted that name=value is allowed in addition to name: value.
1999-06-15 17:30:59 +00:00
42120eaca5
Added entries for new sections from Moshe.
1999-06-14 19:52:10 +00:00
c46864e982
Misc. changes related to the new sections.
1999-06-14 19:49:50 +00:00
21572fdcb6
New sections from Moshe Zadka <moshez@math.huji.ac.il>.
...
These document CGIHTTPServer, SimpleHTTPServer, and linecache.
1999-06-14 19:47:47 +00:00
7df4dd7de2
Add entry for the fpformat module.
1999-06-11 18:36:42 +00:00
1739d2f9ee
Documentation for the fpformat module by Moshe Zadka
...
<mzadka@geocities.com>.
1999-06-11 18:31:00 +00:00
2f9790195b
Added 'ce' to the list of "registered" values for os.name.
...
Make references to the posix module hyperlinks.
1999-06-11 18:28:37 +00:00
5eb992beed
Last night's scribbles:
...
- Revise abstract based on Guido's comments from way back.
- Point out that LaTeX is a structured system & we're using it that
way.
- Add a small section on marking up code examples.
1999-06-11 14:25:45 +00:00
9c5cc14d23
Some clarifications on operations for mapping types, based on comments
...
from Gerry Weiner <gerry@ucar.edu>.
1999-06-10 22:37:34 +00:00
697c779d98
Adjust indexing for __import__(); based on comments by Stefan Franke
...
<sfranke@cdc-group.com>.
1999-06-10 22:09:20 +00:00
28b1770521
Improve index entry for "import"; responding to comments by Stefan
...
Franke <sfranke@cdc-group.com>.
1999-06-10 22:08:16 +00:00
06a73f042a
Work around latex2html problem; reported by Gerrit Holl
...
<gerrit.holl@pobox.com>.
1999-06-10 21:23:31 +00:00
4d5c87ba11
Declare the "util" module obsolete.
1999-06-10 21:17:11 +00:00
f64f8a0877
Fixed typo reported by Bennett Benson
...
<BennettBenson@mn.mediaone.net>.
1999-06-10 15:30:21 +00:00
7a62128722
At David Ascher's request, clarify that os.system() always returns 0
...
on Win95 & Win98.
1999-06-10 15:07:05 +00:00
ae0f292576
Fix typo reported by Robert Kern <kernr@ncifcrf.gov>.
1999-06-10 15:03:07 +00:00
66ab4e8af2
Patch by Jim Fulton to document the new parse_qls().
1999-06-10 03:11:41 +00:00
4727456d46
Add doc for timegm().
1999-06-09 15:11:58 +00:00
5fac2ab220
Fix availability clause; mention availability of similar functionality
...
for Windows using win32pipe.
1999-06-01 17:55:52 +00:00
f1882422d2
Oops, forgot to remove the individual module indexes for lib & mac now
...
that there's a Global Module Index; there can be only one!
1999-05-27 21:56:11 +00:00
3c27ec2c05
Add <hr> after top navigation bar; now looks more like the rest of the
...
navigation bars in the HTML output.
1999-05-27 21:52:51 +00:00
d2a727feee
Hack: make sure LaTeX2HTML doesn't change -- to - in mkhowto
...
description.
1999-05-27 21:45:54 +00:00
3aa70d63b9
Document the "pid" attribute of the Popen3 class.
...
Use memberdesc instead of datadesc to document object attributes.
This gets the index right.
1999-05-27 17:50:59 +00:00
a7ce52b03a
Typo reported by Gerry Wiener <wiener@rap.ucar.edu>:
...
items -> item
The returned list will then have one more items than the number of
non-overlapping occurrences of the separator in the string.
1999-05-27 17:18:08 +00:00
abc8cc63ce
Move some \index entries around so we can avoid using empty comments;
...
empty comments trigger a bug in LaTeX2HTML.
Problem reported by Gerry Wiener <gerry@ucar.edu>.
1999-05-26 16:15:17 +00:00
82f355a36a
Change the example of configuring for large file support under Solaris
...
to use `getconf LFS_CFLAGS`. Steve Clift (the author of the section
and large file support) agrees that this is the right thing to do.
1999-05-26 13:03:34 +00:00
6b330ba857
"proces" --> "process"; reported by Gerry Wiener <gerry@ucar.edu>.
...
Added some index entries.
1999-05-25 13:42:26 +00:00
0eb7b2a659
Enhanced docstring and some comments.
...
_begin_macro_rx: Fixed RE that didn't properly allow a space after
the name of the macro. This affects the conversion
of the tutorial.
1999-05-19 17:37:37 +00:00
c4811d8208
Modify to perform "---" to "—" conversion outside of
...
verbatim-like environments. The list of verbatim-like environments is
a defined by a variable in main().
1999-05-18 17:34:51 +00:00
c41e1e5f5e
Remove the "---" to "—" conversion; this is wrong in verbatim
...
environments. Move the conversion to esis2sgml.py.
1999-05-18 17:33:01 +00:00
338da93734
SET_LINE_NO ==> SET_LINENO
...
Reported by Corran Webster <cwebster@math.tamu.edu>.
1999-05-17 20:57:07 +00:00
33378da964
Added paragraph explaininng the text/binary flavors of some methods,
...
to make it easier for people to find what they're looking for.
1999-05-17 16:35:15 +00:00
d1fb77970d
Document \e, \url.
...
Add a few more comments about mkhowto.
Based on comments from Albert <hat@se-46.wpa.wtb.tue.nl>.
1999-05-17 16:33:54 +00:00
4f52867d95
Don't \input boilerplate.tex, fill in the real stuff. 3rd party
...
documents probably aren't written by Guido. ;-)
1999-05-17 16:02:38 +00:00
87f768e20b
Attempted to clarify usage of the \declaremodule macro somewhat;
...
Michael Hudson's documentation for bytecodehacks exhibits incorrect
usage.
Added some comments about how to set up the mkhowto script for use
with documents not contained in the documentation source tree.
1999-05-17 15:22:45 +00:00
3e4c614c16
define_module(): Check the module type for validity before using.
...
This reflects the changes made in
../texinputs/python.sty.
1999-05-17 15:00:32 +00:00
66823029a4
\declaremodule: Typo.
1999-05-17 14:57:26 +00:00
5bc8d99bce
\declaremodule: Make this more robust. Only attempt to add an index
...
entry based on the module type if the type is known.
Otherwise, spit out a warning the the module type
parameter was bad and generate a "plain" index entry.
Without this, the bad module type was emitted as
text.
Problem noticed by processing Michael Hudson's docs for
bytecodehacks.
1999-05-17 14:47:10 +00:00
8ee593cb46
The conversion temporary files should not be ignored here anymore,
...
since they shouldn't be here. Only ignore the output tarballs in this
directory.
1999-05-13 18:57:28 +00:00
dbc2d08ff5
POP3.uidl(): Update description based on comments from Piers Lauder
...
<piers@cs.su.oz.au>.
1999-05-13 18:48:14 +00:00
dab44682c2
PyCObject_FromVoidPtr(): Clarify that the destr function will only be
...
called on destruction is non-NULL.
1999-05-13 18:41:14 +00:00
431f0ce547
Small nits around some of the index entries.
...
When refering to chapters, use \ref, don't hardcode the chapter
number.
1999-05-13 18:38:11 +00:00
ab03215204
make_index_entry(): Remove. Not only did this override the
...
l2hinit.perl version of the function (which
overrode a version in latex2html), but
do_cmd_index() was overridden. Since
do_cmd_index() was the only caller, we can trash
this.
define_indexing_macro(): New function used during setup to support
more dynamic dispatch for indexing.
process_index_macros(): New function; implement dynamic dispatching
of indexing support functions, allowing many
targets used in indexing to be shared by
multiple index entries. I.e., something like
\index{foo}\bifuncindex{bar} can now share a
single target anchor.
These indexing changes reduce the amount of clutter in the generated
HTML files. In the reference manual, this cuts the number of targets
by 44%. Targets are less affected when generated by environments
rather than macros.
1999-05-13 18:36:54 +00:00
76febdf3fd
make_index_entry(): Remove. This is overridden in python.perl and
...
was never called in this incarnation. The
other version is simpler as well.
1999-05-13 16:41:19 +00:00
7088df4c56
Removed old comments.
1999-05-13 16:20:30 +00:00
84bd6f3b18
Change the look of \seemodule output to fit in better.
1999-05-11 15:42:51 +00:00
03c05a5192
Move the "See also:" section so it appears are part of the top HTML
...
page of the section.
1999-05-11 15:15:54 +00:00
184e8360e8
Added module references; minor grammatical fixes.
...
All suggested by Eric Raymond.
1999-05-11 15:14:15 +00:00
9ade7e0110
Added missing comma, reported by Eric Raymond.
1999-05-11 13:45:37 +00:00
e779d4f03b
Lots of adjustments to deal with the document content now being stored
...
in a fragment rather than the main document object.
1999-05-10 19:36:52 +00:00
54fb7fb9d0
Some more fixes.
...
Add controls for some of the esoteric indexing macros.
1999-05-10 19:36:03 +00:00
b894370f6a
Fixed some index entries.
...
In the __coerce__ description, None should be returned if the
conversion is *impossible*, not *possible*. Reported by Robert Kern
<kernr@ncifcrf.gov>.
1999-05-10 13:43:22 +00:00
2697694e4a
ExtendedEsisBuilder.push(): Override inherited definition. We don't
...
want to push nodes into the document, but into a document
fragment, since we're not necesarily working with something
that's well-formed.
1999-05-07 21:14:28 +00:00
f79acbdaa1
Fix some bugs introduced in the previous checkin.
1999-05-07 21:12:21 +00:00
96c00b0b5e
Define & use a Conversion object. It's still really ugly, but at
...
least there's a token object in here now! ;-)
1999-05-07 19:59:02 +00:00
b0bc7f2d6c
Updated connect_ex() documentation based on comments in the newgroup
...
(M.-A. Lemburg and GvR).
1999-05-06 22:03:50 +00:00
a871c2e747
Make it work for "manual" documents as well as "howto" documents.
...
This still doesn't understand anything about multiple source files or
checking time dependencies.
1999-05-06 19:37:38 +00:00
1ea7c75687
Reflect recent patch for float % and divmod() by Tim Peters. Content
...
updates by Tim Peters, markup by FLD.
1999-05-06 14:46:35 +00:00
4437fdf265
Make sure latex2html doesn't produce a hard link between foo/foo.html
...
and foo/index.html. Make a copy instead. (Appearantly some tar
openers on non-Unixlike systems can't handle hard links.)
1999-05-03 14:29:07 +00:00
d2d1eef025
Make sure latex2html doesn't produce a hard link from $part/$part.html
...
and $part/index.html. Make a copy instead. (Appearantly some tar
openers on non-Unixlike systems can't handle hard links.)
1999-05-03 14:27:45 +00:00
ab005d5f6c
Revert constraint on the GIF wildcard; we missed a few!
1999-04-30 15:58:45 +00:00
8961bd1529
Added top navigation bar for consistency and color. There's not a lot
...
there, but the "modules" icon is active.
1999-04-29 19:54:08 +00:00
a00754468f
make_nav_panel(): Remove the spurious NAME="tex2html\d+" attributes
...
added to the anchors in the navigation bars. These
are added somewhere deep with l2h, and are stupid.
1999-04-29 19:06:56 +00:00
50c507e4b4
Added wcnew target to run the "wcnew" version of webchecker.
1999-04-29 19:04:55 +00:00
673c65e500
Use the new module-key for the FL module when hyperlinking (the old
...
one caused problems on case-insensitive file systems).
1999-04-29 18:42:18 +00:00
dbf7d99ae7
For the tutorial, use numeric node names and split by chapter.
1999-04-29 18:29:38 +00:00
c1db512b2b
Nasty hack to add a --numeric parameter to skip the use of "logical"
...
names.
1999-04-29 18:28:48 +00:00
664c72f8a1
Move index.html rules to the end since it wedges font-lock.
...
Remember to delete index.html for clobber since it is now generated..
1999-04-29 17:04:21 +00:00
d09120b5b9
Added index entries for operator precedence; suggestion from Randall
...
Hopper <rhh@vislab.epa.gov>.
1999-04-29 16:43:42 +00:00
62e80138f4
Make sure the global module index is added to the HTML tarball.
1999-04-29 15:44:49 +00:00
5cc0a9b252
Generate index.html from index.html.in. This avoids having to modify the
...
index to update the version number; boilerplate.tex remains the only document
source for this information.
1999-04-29 15:42:19 +00:00
fe1e207841
Constrain a wildcard a little more.
1999-04-29 15:32:27 +00:00
d03e9e34de
Don't point readers to rand, point to random! And make it a hyperlink
...
while you're at it.
Also, when discussing order of reading, make it clear that chapter 2
is assumed background material for the remainder of the manual.
That's needed for terminology if nothing else!
1999-04-29 13:41:17 +00:00
bdadf0f7f3
Explain comments at the start of chapter 3. This is needed since they
...
appear in the examples without any further explanation, and the
tutorial doesn't have this information explicit anywhere else.
Omission reported by Jon Black <jblack@Ridgeway-Sys.com>.
1999-04-29 13:20:25 +00:00
0e1de8bd6b
Minor nits, partly in response to comments from Jonathan Black
...
<jblack@Ridgeway-Sys.com>.
1999-04-29 12:57:32 +00:00
9ef8635c8c
Annotate a couple of entries further.
1999-04-29 04:23:37 +00:00
0041a94e74
Fill in a few holes in the "Very High Level" chapter.
1999-04-29 04:20:46 +00:00
5f342ac2a7
Always use "section" when referring to sections of a document, not "Section".
1999-04-29 02:47:40 +00:00
a4a90ddeac
Clarify that the Modules/ directory is in an unpacked source
...
distribution; this is not clear for Windows users.
1999-04-29 02:44:50 +00:00
c0fcbc1ac6
Update starship URLs.
1999-04-29 02:30:04 +00:00
c7c9a64833
Remove the \date macro; just pick it up from boilerplate.tex.
1999-04-28 18:24:02 +00:00
ea0020571f
Use \rfc to mark some remaining RFC references.
...
Remove comment about full name bug in getaddrlist(); this has been
fixed for a while now.
Work around LaTeX2HTML space-dropping bug.
Mention that the fp attribute can be used to read the message body.
1999-04-28 18:11:09 +00:00
ea07f2751a
setup_column_alignments(): Adding valign=baseline to the <td> tag
...
makes the alignment work on Navigator as
well as IE. Uglier HTML, but it looks
right.
1999-04-28 17:11:21 +00:00
250ba78565
Let's try again: new assertion.
1999-04-28 16:57:01 +00:00
610172b0de
Removed (empty) description of \optional from the "Inline Markup"
...
section; that's not really the right place for it.
1999-04-28 16:54:00 +00:00
2f4bebd28c
Fill in a few holes.
1999-04-28 16:43:11 +00:00
ac3dc83eb6
Fix up the HTML generated for envdesc and macrodesc environments.
...
Make it possible for the user to tell the difference. ;-)
1999-04-28 16:42:29 +00:00
d02573d13b
Handle \p and \op in parameter lists for the environment and macro
...
description environments.
1999-04-28 16:33:04 +00:00
4050e00e41
Adjust the message that gets added to the bottom of each page about
...
where to send comments.
1999-04-28 15:06:08 +00:00
0a0fd595b3
\filenq: Like \file, but don't use single-quotes; this looks better
...
in tables.
1999-04-28 14:59:44 +00:00
f74e5b7936
Control the layout of output tables a little better so they're easier
...
to debug. Small code cleanup around tables.
1999-04-28 14:58:49 +00:00
cf282cdafb
Point to the library reference manual for os.path documentation (in
...
macpath section).
1999-04-28 14:04:36 +00:00
79189b5fd5
do_cmd_seetext(): Clean up so we get proper nesting of <div>s. This
...
fixes a rendering problem on IE5.
General adjustments to the table* environments, including using
<thead> and <tbody>. Attempt to adjust the vertical alignment of the
table cells so that the baseline of the first cell matches the
baseline of the remaining cells: When the first cell is small and the
second cell of the same row is multi-line, the first cell was
vertically centered by default. Specifying valign=baseline fixes the
problem on IE, but Netscape seems to ignore both valign=top and
valign=baseline (even though valign is NS's fault!). Make the
horizontal alignment of 'p' columns left instead of center (for the
headings).
1999-04-28 13:54:30 +00:00
505c49199a
Added "See also" reference to PyOpenGL.
1999-04-27 18:05:06 +00:00
dcf17f3860
mhlib is now documented.
1999-04-23 22:24:12 +00:00
a4966647ec
Markup consistency.
1999-04-23 22:22:27 +00:00
1c7cd63a2b
Nits.
1999-04-23 22:03:00 +00:00
957ac3fadb
Add section for the sha module.
1999-04-23 21:52:18 +00:00
154fc6dcf7
Patch from Greg Ward adding descriptions of S_IMODE() and S_IFMT(),
...
and an explanation of why any of stat.S_*() would be used instead of
os.path.is*(). (With some really small enhancements by me.)
1999-04-23 20:54:57 +00:00
24aca83dbd
Fixed typo and font-control problem reported by Detlef Lannert
...
<lannert@lannert.rz.uni-duesseldorf.de>.
1999-04-23 20:33:59 +00:00
29cf682b71
Clarifications on the first(), next(), and previous() functions, based
...
on comments from Detlef Lannert <lannert@lannert.rz.uni-duesseldorf.de>.
1999-04-23 20:32:59 +00:00
861192120b
Fix a grammatical error reported by Detlef Lannert
...
<lannert@lannert.rz.uni-duesseldorf.de>.
1999-04-23 20:07:02 +00:00
ec8b905bd4
Fix a couple of typos reported by Detlef Lannert
...
<lannert@lannert.rz.uni-duesseldorf.de>.
1999-04-23 20:01:17 +00:00
16214fb017
Fix a couple of grammatical errors reported by Detlef Lannert
...
<lannert@lannert.rz.uni-duesseldorf.de>.
1999-04-23 20:00:53 +00:00
4aa4f30759
Work-around LaTeX2HTML space-dropping bug.
1999-04-23 17:30:40 +00:00
87b8f318b0
Fixed some logical markup nits.
...
Added a pointer to Grail in the see-also section, since it's used as
an example.
1999-04-23 17:26:24 +00:00
deb7e096d3
Logical markup.
1999-04-23 17:11:53 +00:00
806764bee4
No, __repr__() does not accept a parameter other than self.
1999-04-23 17:03:21 +00:00
0fbec55e23
Shorten the section title.
...
Adjust markup to be a little more consistent with the rest of the
document.
1999-04-23 16:44:53 +00:00
eea97ea063
Shorten the section title.
1999-04-23 16:07:38 +00:00
86bd5e48c3
Shorten the section title.
...
Fix a couple of grammatical errors.
1999-04-23 16:02:30 +00:00
7475e04fad
Work around a space-dropping problem in LaTeX2HTML.
...
Clarify the usage of a parameter.
1999-04-23 15:57:23 +00:00
ae35aa8b63
Added "See also" sections linking to binascii.
1999-04-23 15:52:18 +00:00
ee4d54ea33
Refer to the binhex module, not the non-existent hexbin module.
...
Added a "See also" section.
1999-04-23 15:42:36 +00:00
26f7cfe9c7
Fix some glaring markup consistency problems (presentation was
...
broken).
Added a "See also" section.
1999-04-23 15:41:53 +00:00
10682c28b4
Added a couple more requests from users.
1999-04-23 15:15:58 +00:00
812860e81d
Hack places where '--' should appear as literal output but the -- was
...
(properly) converted to - by LaTeX2HTML.
1999-04-23 14:46:18 +00:00
d960dc81b5
Fix square brackets around optional parameters to macros.
1999-04-23 14:44:53 +00:00
7a737dffc4
General small improvements and fixes.
1999-04-23 14:41:44 +00:00
ffbe68723a
Make internal module references hyperlinks wherever it makes sense.
1999-04-22 21:23:22 +00:00
7b8b125fa6
Remove bogus characters in code sample.
1999-04-22 21:19:53 +00:00
fcf94d4edd
Work around LaTeX2HTML comment-handling bug.
1999-04-22 20:55:59 +00:00
4a406c619b
Shorten the section title.
1999-04-22 20:52:44 +00:00
c4a623ebdc
Add command line flags to just list the files that contain the
...
offending lines or to include line numbers in the output.
1999-04-22 20:32:21 +00:00
c8c40ff699
Added a "See also" section with some external references.
1999-04-22 20:16:02 +00:00
4e28c593ad
Markup nits.
...
Make module references hyperlinks.
1999-04-22 18:25:47 +00:00
b7168c3a07
Clean up lots of mark up.
1999-04-22 17:53:37 +00:00
Fred Drake
Guido van Rossum