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