637ad47e61
convert(): Make sure no line has trailing whitespace. (docfixer.py
...
checks for \n\n as a paragraph separator, LaTeX allows white
space between the newlines.)
1999-01-07 18:47:07 +00:00
c7dd3e11da
Markup nit.
...
Add module synopsis.
1999-01-07 15:45:55 +00:00
cf3ce92ef4
Explain how come that pickle and cPickle, while using the same data
...
format, can produce different pickle strings for the same object.
1999-01-06 23:34:39 +00:00
e51aa5b2cd
Minor clarifications by Sean Reifschneider:
...
- add example of string literal concatenation
- add clarifying comment to the example of the if statement
1999-01-06 23:14:14 +00:00
87e611e441
Replace the docs for reduce with an adaptation of its docstring, which
...
was actually clearer!
1999-01-06 23:10:51 +00:00
74429eacb5
Add doc for access() and ttyname(). Patch by Sean Reifschneider.
1999-01-06 23:03:43 +00:00
fcc5910090
Preliminary code to mark paragraphs. Seems to work, but very slow.
1999-01-06 22:50:52 +00:00
c553358c63
Remove documentation for whatraw() since it's gone now.
1999-01-06 15:21:19 +00:00
60adb362df
Document the sndhdr module.
...
Document that the whatsound module is obsolete.
1999-01-05 23:09:12 +00:00
a2e4017394
Shorten the synopsis that gets into the table of contents.
1999-01-05 22:54:49 +00:00
ccc627200a
write_idxfile(): New function. Isolate format of the external index
...
data file used by buildindex.py.
next_argument_id(): Removed; no longer used.
next_argument(): Doesn't use next_argument_id(), just does the work.
gen_target(), gen_target_name(): Removed, no longer used. The only
place that used them now does the (trivial) work directly.
Lots of little changes so we never have to pass around $br_id values
all over the place. The only places they're used now new IDs are
generated as needed.
1999-01-05 22:16:29 +00:00
02e18b4b84
Added missing "from" in IOError description.
1999-01-05 21:42:18 +00:00
26f0f65653
Remove obsolete comment.
1999-01-05 20:53:43 +00:00
5d56d3665f
Make the documents that have indexes dependent on the buildindex.py
...
script.
1999-01-05 15:49:39 +00:00
7d45f6dcc4
do_cmd_methodline(): New function, implements indexing version of
...
\methodline.
Fixed up support for \withsubitem, hopefully improving the fidelity of
the index a bit.
1999-01-05 14:39:27 +00:00
3b07480a17
trim_ignored_letters(): Simplify a little.
1999-01-04 22:00:56 +00:00
8d7e11a8c1
Update information on the version of latex2html to use, including
...
complaint about 98.2b8 problems.
1999-01-04 18:25:38 +00:00
b75d021081
Typo: "TWELV" --> "TWELVE"
...
Added note at top, since LaTeX style writers like to force name
changes when someone else makes a change to the style. I'm sending a
note to the author reporting the error and asking for an updated
version.
This cannot be distributed in this form. This will be resolved when I
get a response from Ulf Lindgren.
Typo reported by rwolff@noao.edu (Richard Wolff).
1999-01-04 16:15:02 +00:00
f07c328c07
Document the optional mode argument (Z_FLUSH, Z_SYNC_FLUSH, etc.)
...
to the flush() method of compressor objects.
1998-12-31 21:14:23 +00:00
94c4a7976f
Added index entries to make it easier to locate directory & file operations.
1998-12-28 21:58:57 +00:00
8692998018
Added index entries to make it easier to locate directory operations.
1998-12-28 21:58:15 +00:00
cc09e8dc82
Clarified what Python versions the interactivity chapter applies to,
...
and what it doesn't apply to.
1998-12-28 21:21:36 +00:00
76fa3b73d6
Remove recently documented modules from the undoc list.
1998-12-28 20:53:19 +00:00
03a0235793
Print a line to the console reporting the number of index nodes
...
processed. This can be interesting to see.
1998-12-28 20:46:53 +00:00
566c8327f7
Added entry for libshutil.tex.
1998-12-28 20:17:33 +00:00
449e18f459
Add documentation for shutil module.
1998-12-28 20:16:58 +00:00
cd058539a8
Adjust a few niggles that affected the HTML conversion (a couple of
...
"^"s were being dropped in the context of [^...]).
1998-12-28 19:03:24 +00:00
d82af0b8ec
Remove all use of $* in commands; some makes (Solaris 2.5, IRIX 6.X)
...
only expand this in dependency lists. Thanks for Sjoerd Mullendar for
pointing this out.
1998-12-28 15:17:22 +00:00
d358afeec0
Document 'N' format character for Py_BuildValue -- like 'O' but doesn't INCREF.
1998-12-23 05:02:08 +00:00
32f7ae0066
Fix many of the specific targets in links from the index.
...
In a number of places, I called next_argument() instead of
next_argument_id() when the ID was also needed. (7 places)
1998-12-22 23:41:07 +00:00
7d65d388b8
Add the getpass module to $(LIBFILES).
1998-12-22 23:38:11 +00:00
99e2c39b31
Add the getpass module.
1998-12-22 23:37:46 +00:00
5ac2a07fca
Basic documentation for the getpass module.
1998-12-22 23:37:21 +00:00
85220410e0
Bump $(RELEASE).
1998-12-22 22:17:41 +00:00
5cb48a4c98
Added a \versionchanged since the API changed to support
...
namespaces with 1.5.2.
Added an index entry.
Fixed XML expansion: XML is the "Extensible Markup Language", not the
"eXtended Markup Language".
1998-12-22 18:46:13 +00:00
292b9ebfba
Added information on when this was added, allowing us to release the
...
documentation on the Web while people are still using < 1.5.2b1.
1998-12-22 18:40:50 +00:00
ae48aabb10
Update the date.
1998-12-22 18:27:22 +00:00
1189fa98eb
Adjust markup to match current conventions, and make it formattable.
1998-12-22 18:24:13 +00:00
768ac6b804
Start of text that describes differences between match and search.
...
Strengthen pointers to the search() function and method.
1998-12-22 18:19:45 +00:00
5eecd7b3bd
Improve a couple of comments.
1998-12-22 18:15:04 +00:00
191f2857f5
Use \moduleauthor and \sectionauthor instead of a comment to credit
...
the author (just happened to notice this one).
1998-12-22 18:06:02 +00:00
7be0cde3a0
Add an explanation about what the example does and doesn't do.
...
Fix an appearantly new behavior with latex2html with quoting. (Good
incentive to work on the SGML conversion! ;)
1998-12-22 18:04:48 +00:00
2eff3c5273
do_cmd_rfc(): Make the "RFC ###" a hyperlink to the master RFC
...
repository.
1998-12-22 18:02:25 +00:00
782c973cb9
Added libnetrc.tex and libshlex.tex to LIBFILES.
1998-12-22 17:40:43 +00:00
5e97c9dff9
Adding libshlex and libnetrc by Eric Raymond.
1998-12-22 05:18:24 +00:00
b1f97d6765
Suggestion by Tim Peters clarifying what "before global" means.
...
(Also added an XXX comment requesting clarification of module
initialization -- TBD later.)
1998-12-21 18:57:36 +00:00
e848976fba
Clarify descriptions of some operations; it's not always clear that
...
strings are not actually modified. Problem reported by Dr. Peter
Stoehr <peter.stoehr@weihenstephan.org>.
1998-12-21 18:56:13 +00:00
3b02ddfa41
Add a bunch of index entries related to retrieving information from
...
the process table.
1998-12-21 18:52:53 +00:00
b083a9fb54
Sjoerd Mullender writes:
...
Here is my current version of xmllib.py and the documentation. This
version has some API changes with respect to the version currently in
Python (also the one in 1.5.2a).
This version supports XML namespaces.
1998-12-18 20:17:13 +00:00
aaed9710e9
create_module_info(): New function: Modify a <section> to create a
...
<moduleinfo> element based on various meta information, and
strip some cruftiness. This is more usable for information
extraction, and organizes the information more clearly.
cleanup_synopses(): Rewrite to use create_module_info(), so this
will work with multi-rooted "documents".
1998-12-10 20:25:30 +00:00
fee6abea90
Remove another {\rm ...} construct.
...
Sheesh, where do these things come from?
1998-12-10 19:57:52 +00:00
4abcffb233
Don't pass around a list of known empty elements, since the ESIS
...
contains "e" events for them. This wasn't used anyway.
1998-12-10 18:31:37 +00:00
fba0ba2a6f
Added a transform to start cleaning up the modulesynopsis stuff a
...
little; more thinking is needed about what we really want.
1998-12-10 05:07:09 +00:00
e9e05968e3
Nits.
1998-12-10 05:04:21 +00:00
c166331cd3
Handle SGML variant as well as XML variant. SGML is *much* more
...
likely to be used.
1998-12-10 04:56:00 +00:00
0ad55fb241
Update the descriptions of strftime() and strptime() to avoid
...
confusion, and describe what the "directives" are about.
1998-12-08 19:59:36 +00:00
aac399b80b
Correct the poplib example. Stephan Richter pointed out some problems
...
with it.
1998-12-08 16:30:10 +00:00
64583d3f87
Rename the parameters of atan2(), based on comments from Guido & Peter
...
A. Koren <pkoren@hex.net>.
1998-12-08 16:10:44 +00:00
f484a3366b
Sjoerd writes:
...
When literal mode is entered it should exit automatically when the
matching close tag of the last unclosed open tag is encountered. This
patch fixes this.
1998-12-07 21:59:56 +00:00
d83675f344
"singed" --> "signed" (3 places)
...
Noticed by Andrew MacIntyre <andymac@bullseye.apana.org.au>.
1998-12-07 17:13:18 +00:00
e039439e3b
Clarify evaluation of default arguments at def time with more text and
...
an example.
1998-12-04 19:37:10 +00:00
8c2da61811
Add explicit example on how to import a submodule of a package using
...
__import__ and getattr().
1998-12-04 15:32:17 +00:00
86bc7b01b5
General comments on what's here and how to try it out. Note
...
dependence on the XML package.
1998-12-02 17:21:35 +00:00
6d26f4b188
Moved NotImplementedError into alphabetical order, and reword
...
description.
1998-12-01 19:48:04 +00:00
1e151322fb
Added documentation for NotImplementedError. Fred (I'm sure) will
...
sanitize for your protection :-)
1998-12-01 19:19:21 +00:00
3695b1212c
Support conversions to both SGML and XML; SGML is the "default".
...
Add dependency on esistools.py for the ESIS intermediate files.
1998-12-01 19:05:56 +00:00
aeea9810cd
Use esistools.
...
Lots of changes to the conversion table.
1998-12-01 19:04:12 +00:00
4db5b4636c
Use esistools.
...
Generate ESIS data instead of XML.
Misc. changes to some transforms.
1998-12-01 19:03:01 +00:00
f077b9d61f
Use esistools, getopt.
1998-12-01 19:01:53 +00:00
3843bae969
Utility functions and misc. classes used in handling ESIS data.
1998-12-01 19:00:58 +00:00
2f8592cbea
Ignore the byproducts of SGML/XML conversions for now.
1998-12-01 18:58:28 +00:00
eabfab1048
Nits to support conversions.
1998-12-01 18:37:59 +00:00
1e270f0e03
Nits to support conversions.
1998-11-30 22:58:12 +00:00
f954b6516e
Remove $(CUTCRUFT) garbage; now in fixgenents.sh.
...
Separate ESIS generation from XML generation. This will evolve a bit
more in a couple of days.
1998-11-30 22:31:45 +00:00
3d5e2c032d
Move nasty cruft from make.rules' $(CUTCRUFT) here, mostly to clean up
...
make.rules.
1998-11-30 22:30:29 +00:00
50b804dc88
Fix minor nit with respect to conversion.
...
Update some logical markup.
1998-11-30 22:14:58 +00:00
caa3379c4f
Remove {\rm ...} constructs.
1998-11-30 21:53:47 +00:00
84538cd076
Remove some remaining {\rm ...} constructs.
...
Update logical markup in a few spots.
1998-11-30 21:51:25 +00:00
f790b16d00
Change "for" explanation slightly based on comment passed along by
...
Blake Winton <BlakeW@pcdocs.com>.
1998-11-30 20:37:24 +00:00
ca6d6355d7
l2hoption: Do the "right thing" to quote the right-hand-side of Perl
...
assignments. This allows '"', '$', and '@' to be included in
the values passed to parameters like --address.
1998-11-30 20:30:26 +00:00
a8ba364700
Add a --address parameter to the mkhowto command line to direct
...
documentation comments appropriately. In response to comment from
Martijn Faassen <faassen@vet.uu.nl>.
Add dependency to about.dat.
1998-11-30 20:28:35 +00:00
7777e36c21
Add a -address parameter to the LaTeX2HTML command line to direct
...
documentation comments appropriately. In response to comment from
Martijn Faassen <faassen@vet.uu.nl>.
1998-11-30 20:27:31 +00:00
1ea5848b7b
Oops, remove LaTeX2HTML version number. Could become wrong and isn't
...
needed, since it's always added to the comments in the page header
anyway.
1998-11-30 19:29:34 +00:00
15796f791a
do_cmd_textohtmlinfopage(): Rip out most of the boilerplate and move
...
it to the about.dat file. Only what really needs to be
generated is, and the remainder is easier to maintain than
Perl code.
1998-11-30 19:25:47 +00:00
d83c8bd95f
New file. Contains boilerplate text for the "About this document..."
...
section of LaTeX2HTML-generated documents.
Includes credit to Christopher Petrilli for the navigation icons.
1998-11-30 19:24:13 +00:00
1776556f8f
Markup nit to ease conversions.
1998-11-30 19:00:16 +00:00
3d29955a6e
Markup improvements to help with conversions.
1998-11-30 18:59:44 +00:00
01d5d94020
Remove cruft from the old Texinfo conversion. This simplifies some of
...
the newer processing.
1998-11-30 17:33:38 +00:00
5208823158
Remove bogus \@.
1998-11-30 16:27:37 +00:00
d61975e179
Minor markup nit to ease conversion processing.
1998-11-30 16:26:50 +00:00
f6c59e8fff
Do all the right imports. Problem reported by Martijn Faassen
...
<faassen@vet.uu.nl>.
1998-11-30 15:07:26 +00:00
42f5298ab5
Several small adjustments.
1998-11-30 14:45:24 +00:00
fa1cceb91f
Make \var work correctly in math mode.
1998-11-30 14:42:59 +00:00
87dfd3cfbf
Handle output of \geq and \leq.
1998-11-30 14:36:26 +00:00
4471f20ed4
Logical markup.
...
Fix a few things for the conversion to structured markup.
Removed texinfo special cases, since there's likely a new info
process.
1998-11-25 22:38:24 +00:00
f65e323101
Fix remaining {\rm ...} construct.
1998-11-25 20:55:03 +00:00
af2590a991
Remove some optional parameters that are unnecessary in context.
1998-11-25 20:15:52 +00:00
72554e476f
Remove bogus \@.
1998-11-25 20:07:35 +00:00
b6d45c6ad1
Remove bogus \@.
1998-11-25 19:55:47 +00:00
4c5e533693
Do the right stuff to convert what was originally \e, \ldots, and ---
...
in the LaTeX sources.
1998-11-25 19:28:02 +00:00
d03268feaa
Remove two remaining {\tt ...} constructs.
1998-11-25 19:23:33 +00:00
78eebfdbf4
Remove two remaining {\tt ...} constructs.
1998-11-25 19:09:24 +00:00
5eabf3823b
Clarify that min and max also take multiple arguments.
1998-11-25 18:53:05 +00:00
1e42d8aaab
Massive change to just about every construct that impacts the index.
...
Blame it on Just. ;-)
1998-11-25 17:58:50 +00:00
ea81edf059
Markup nits.
...
Fixed an index entry, added three more.
1998-11-25 17:51:15 +00:00
1475e88a35
Minor fixups to some index entries.
1998-11-25 17:48:10 +00:00
2b3730e284
Minor adjustments to a few index entries.
1998-11-25 17:40:00 +00:00
1cbd196f96
Minor nit that fixes a bunch of indexing: the way the classdesc
...
environment saves the name of the last class described, method and
member descriptions were not picking it up correctly. Thus, many
index entries were described as "( method)" instead of "(FooClass
method)". Multiple entries were collapsed in the index when
methods/members from multiple classes share the same name.
1998-11-25 17:13:28 +00:00
e839199014
Fix indexing of func_code attribute; this is on a function, not a code
...
object.
Add "()" to method names indexed using \ttindex{}.
1998-11-25 17:09:19 +00:00
d8faf85d40
Supplemental rules to convert a .tex file to a .xml file. Both XML and
...
SGML will be supported soon, probably using an ESIS representation saved
in a temp file.
1998-11-24 17:40:33 +00:00
6942e57f87
Script to convert things like <C/> and <Cpp/> to &C; and &Cpp;. This is
...
something that con't be done with the DOM as far as I can tell.
1998-11-24 17:38:49 +00:00
e743fd01ac
Rationalize a word-space markup to not break in the LaTeX->*ML
...
conversion tools currently being constructed.
Add a chapter from Jim Fulton on using Misc/Makefile.pre.in. Still
preliminary. The "Dynamic Loading" chapter needs to be updated (and
possibly removed, since it's no longer an issue for most (any?)
users.
1998-11-24 17:07:29 +00:00
1cb330c383
The & character is also escaped using \.
1998-11-23 23:11:12 +00:00
1ff6db484f
Add some additional cleanup transformations.
1998-11-23 23:10:35 +00:00
5701482ea7
Fix comment regex so we don't screw up structured comments with
...
different internal indentation levels.
1998-11-23 18:21:54 +00:00
04307ce789
Rewrote the section on sys.exit(), documenting other argument types
...
than integers and recommending sys.exit("message").
(I see this as Python's answer to Perls ``die "message";''.)
1998-11-23 17:49:53 +00:00
0320473a29
Script to squirrel around with the DOM tree of document fragments from the
...
LaTeX-based ESIS streams to be a little better structured, and generally
perform clean-up.
Preliminary.
1998-11-23 17:02:03 +00:00
30a68c7a2b
Moved into tools/sgmlconv/.
1998-11-23 16:59:39 +00:00
63de8f6d55
Moving to sgmlconv/ subdir.
1998-11-23 16:58:48 +00:00
bbd7509dbe
Fix up the extraction of optional parameters a little.
...
Be more informative in an exception message.
1998-11-23 16:30:18 +00:00
c16149b17b
Some cleanup.
...
Don't duplicate the information on what's empty; rely on the input
data for that. (This means that the DOM may need more work.)
1998-11-23 15:14:18 +00:00
96b07a9453
Fix some minor problems.
...
Make the table of attribute information contain only one kind of
entry. Simplifies some stuff in subconvert().
1998-11-23 15:12:00 +00:00
99ff8c4361
First cut at a script to generate SGML/XML from an ESIS event stream,
...
probably only usable for the Python docs. But also probably more
useful than latex2esis.py.
1998-11-18 23:28:24 +00:00
95f4f92b47
First cut at a script to generate ESIS events from LaTeX source,
...
probably only usable for the Python docs.
1998-11-18 23:27:24 +00:00
db70d06464
Eliminate remaining \verb/.../ constructs; there's no need for them.
1998-11-17 21:59:04 +00:00
da30f4ca6b
Fix typo in doc for handle(): client_request should be client_address.
...
Noted by Stefan Witzel.
1998-11-16 19:07:04 +00:00
5e8aa549d1
Update the example in "Calling Python Functions from C" to use
...
METH_VARARGS conventions and PyArg_ParseTuple(), and document the flag
and where to look for PyArg_ParseTuple() info.
Response to comment from Don Bashford <bashford@scripps.edu>.
1998-11-16 18:34:07 +00:00
c46973c89b
Document the user and password parameters to the NNTP constructor.
1998-11-16 17:11:30 +00:00
2510d22048
Clarify the default buffering for open(). (Comment from Andrew Dalke
...
<dalke@bioreason.com>).
1998-11-02 18:57:34 +00:00
cab91efd34
Fix Barry's markup.
1998-11-02 17:23:25 +00:00
a096a2e6a2
Warn that AddModule doesn't import the module.
1998-11-02 17:02:42 +00:00
9ed1a0afb9
Moved zmod and poly descriptions to the Obsolete section.
1998-11-02 15:46:21 +00:00
4a1cdd7f22
Document the new features of this module
1998-10-31 23:19:00 +00:00
130072d663
Don't describe something as "below"; that won't make sense for the
...
HTML version. Give a reference to the actual section to allow a
hyperlink to be built.
1998-10-28 20:08:35 +00:00
c024c99faf
Fix typo reported by Gerry Weiner <gerry@ucar.edu>.
1998-10-28 18:19:16 +00:00
c1cea208bc
Added URL to HOWTO page, with reference to Regex HOWTO.
...
Corrected error: {,5} is not equivalent to {0,5}.
1998-10-28 15:44:14 +00:00
566b6d5b59
Support the use of bibtex. This is transparent to the user.
...
Switch from bash to ksh, in the hope that more systems support it (one
report of a site without an available bash).
1998-10-27 21:59:03 +00:00
04101960e6
Indicate that os.environ may not be a real dictionary.
1998-10-24 20:16:56 +00:00
c62cf36e76
The last two example functions in the section about default argument
...
values (4.7.1) should return l, not a. Reported by Axel Boldt.
1998-10-24 13:15:28 +00:00
803b340888
Update the date.
1998-10-21 14:50:52 +00:00
a76b63c4f4
Bump the release to 1.5.2a2.
1998-10-21 14:49:48 +00:00
d29cf379b9
Added --tools option, to package only the framework (no documents).
1998-10-21 14:26:26 +00:00
9beee80fd7
Remove a couple of unnecessary "%" characters that cause problems with
...
the latest latex2html beta.
1998-10-21 00:44:49 +00:00
dad11321eb
Remove a bunch of unnecessary "%" characters that cause problems with
...
the latest latex2html beta.
1998-10-21 00:26:56 +00:00
3041b0715b
Remove an unnecessary "%" character that seems to cause a minor glitch
...
with the latest latex2html.
1998-10-21 00:25:32 +00:00
28e7b4cce1
add_link(): Fix to use $section_info instead of $toc_section_info,
...
based on email from Ross Moore <ross@mpce.mq.edu.au>.
Set $HTML_VERSION to 4.0, since that's what we really generate (well,
4.0 "transitional").
1998-10-20 18:14:20 +00:00
fbddddee49
Reflect new name of index style file.
1998-10-19 21:48:05 +00:00
7f77db9530
Renamed myindex.ist to something more reasonable.
1998-10-19 21:45:52 +00:00
9dcc9f7764
No longer needed since we have nice, contributed navigation buttons.
1998-10-19 21:40:45 +00:00
a5de730d2d
If building HTML and the icons should be served from the same
...
directory as the HTML (--iconserver .), copy the icons into place.
Clarify that lynx is needed for --text in the usage message.
Fix a typo in a comment.
1998-10-19 19:14:42 +00:00
Fred Drake
Guido van Rossum
Andrew M. Kuchling
Barry Warsaw