mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
11,081 Commits 6 Branches 604 Tags 2.9 GiB
Commit Graph

2533 Commits

Author SHA1 Message Date
Fred Drake 64bc94e3ec New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>! 1999-06-17 15:11:35 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 42120eaca5 Added entries for new sections from Moshe. 1999-06-14 19:52:10 +00:00
Fred Drake c46864e982 Misc. changes related to the new sections. 1999-06-14 19:49:50 +00:00
Fred Drake 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
Fred Drake 7df4dd7de2 Add entry for the fpformat module. 1999-06-11 18:36:42 +00:00
Fred Drake 1739d2f9ee Documentation for the fpformat module by Moshe Zadka 
<mzadka@geocities.com>.
 1999-06-11 18:31:00 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 697c779d98 Adjust indexing for __import__(); based on comments by Stefan Franke 
<sfranke@cdc-group.com>.
 1999-06-10 22:09:20 +00:00
Fred Drake 28b1770521 Improve index entry for "import"; responding to comments by Stefan 
Franke <sfranke@cdc-group.com>.
 1999-06-10 22:08:16 +00:00
Fred Drake 06a73f042a Work around latex2html problem; reported by Gerrit Holl 
<gerrit.holl@pobox.com>.
 1999-06-10 21:23:31 +00:00
Fred Drake 4d5c87ba11 Declare the "util" module obsolete. 1999-06-10 21:17:11 +00:00
Fred Drake f64f8a0877 Fixed typo reported by Bennett Benson 
<BennettBenson@mn.mediaone.net>.
 1999-06-10 15:30:21 +00:00
Fred Drake 7a62128722 At David Ascher's request, clarify that os.system() always returns 0 
on Win95 & Win98.
 1999-06-10 15:07:05 +00:00
Fred Drake ae0f292576 Fix typo reported by Robert Kern <kernr@ncifcrf.gov>. 1999-06-10 15:03:07 +00:00
Guido van Rossum 66ab4e8af2 Patch by Jim Fulton to document the new parse_qls(). 1999-06-10 03:11:41 +00:00
Guido van Rossum 4727456d46 Add doc for timegm(). 1999-06-09 15:11:58 +00:00
Fred Drake 5fac2ab220 Fix availability clause; mention availability of similar functionality 
for Windows using win32pipe.
 1999-06-01 17:55:52 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake d2a727feee Hack: make sure LaTeX2HTML doesn't change -- to - in mkhowto 
description.
 1999-05-27 21:45:54 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 6b330ba857 "proces" --> "process"; reported by Gerry Wiener <gerry@ucar.edu>. 
Added some index entries.
 1999-05-25 13:42:26 +00:00
Fred Drake 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
Fred Drake c4811d8208 Modify to perform "---" to "&mdash;" 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
Fred Drake c41e1e5f5e Remove the "---" to "&mdash;" conversion; this is wrong in verbatim 
environments.  Move the conversion to esis2sgml.py.
 1999-05-18 17:33:01 +00:00
Fred Drake 338da93734 SET_LINE_NO ==> SET_LINENO 
Reported by Corran Webster <cwebster@math.tamu.edu>.
 1999-05-17 20:57:07 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 66823029a4 \declaremodule: Typo. 1999-05-17 14:57:26 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake dbc2d08ff5 POP3.uidl(): Update description based on comments from Piers Lauder 
<piers@cs.su.oz.au>.
 1999-05-13 18:48:14 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 7088df4c56 Removed old comments. 1999-05-13 16:20:30 +00:00
Fred Drake 84bd6f3b18 Change the look of \seemodule output to fit in better. 1999-05-11 15:42:51 +00:00
Fred Drake 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
Fred Drake 184e8360e8 Added module references; minor grammatical fixes. 
All suggested by Eric Raymond.
 1999-05-11 15:14:15 +00:00
Fred Drake 9ade7e0110 Added missing comma, reported by Eric Raymond. 1999-05-11 13:45:37 +00:00
Fred Drake 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
Fred Drake 54fb7fb9d0 Some more fixes. 
Add controls for some of the esoteric indexing macros.
 1999-05-10 19:36:03 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake f79acbdaa1 Fix some bugs introduced in the previous checkin. 1999-05-07 21:12:21 +00:00
Fred Drake 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
Fred Drake b0bc7f2d6c Updated connect_ex() documentation based on comments in the newgroup 
(M.-A. Lemburg and GvR).
 1999-05-06 22:03:50 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake ab005d5f6c Revert constraint on the GIF wildcard; we missed a few! 1999-04-30 15:58:45 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 50c507e4b4 Added wcnew target to run the "wcnew" version of webchecker. 1999-04-29 19:04:55 +00:00
Fred Drake 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
Fred Drake dbf7d99ae7 For the tutorial, use numeric node names and split by chapter. 1999-04-29 18:29:38 +00:00
Fred Drake c1db512b2b Nasty hack to add a --numeric parameter to skip the use of "logical" 
names.
 1999-04-29 18:28:48 +00:00
Fred Drake 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
Fred Drake d09120b5b9 Added index entries for operator precedence; suggestion from Randall 
Hopper <rhh@vislab.epa.gov>.
 1999-04-29 16:43:42 +00:00
Fred Drake 62e80138f4 Make sure the global module index is added to the HTML tarball. 1999-04-29 15:44:49 +00:00
Fred Drake 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
Fred Drake fe1e207841 Constrain a wildcard a little more. 1999-04-29 15:32:27 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 0e1de8bd6b Minor nits, partly in response to comments from Jonathan Black 
<jblack@Ridgeway-Sys.com>.
 1999-04-29 12:57:32 +00:00
Fred Drake 9ef8635c8c Annotate a couple of entries further. 1999-04-29 04:23:37 +00:00
Fred Drake 0041a94e74 Fill in a few holes in the "Very High Level" chapter. 1999-04-29 04:20:46 +00:00
Fred Drake 5f342ac2a7 Always use "section" when referring to sections of a document, not "Section". 1999-04-29 02:47:40 +00:00
Fred Drake 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
Fred Drake c0fcbc1ac6 Update starship URLs. 1999-04-29 02:30:04 +00:00
Fred Drake c7c9a64833 Remove the \date macro; just pick it up from boilerplate.tex. 1999-04-28 18:24:02 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 250ba78565 Let's try again: new assertion. 1999-04-28 16:57:01 +00:00
Fred Drake 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
Fred Drake 2f4bebd28c Fill in a few holes. 1999-04-28 16:43:11 +00:00
Fred Drake 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
Fred Drake d02573d13b Handle \p and \op in parameter lists for the environment and macro 
description environments.
 1999-04-28 16:33:04 +00:00
Fred Drake 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
Fred Drake 0a0fd595b3 \filenq: Like \file, but don't use single-quotes; this looks better 
in tables.
 1999-04-28 14:59:44 +00:00
Fred Drake 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
Fred Drake cf282cdafb Point to the library reference manual for os.path documentation (in 
macpath section).
 1999-04-28 14:04:36 +00:00
Fred Drake 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
Fred Drake 505c49199a Added "See also" reference to PyOpenGL. 1999-04-27 18:05:06 +00:00
Fred Drake dcf17f3860 mhlib is now documented. 1999-04-23 22:24:12 +00:00
Fred Drake a4966647ec Markup consistency. 1999-04-23 22:22:27 +00:00
Fred Drake 1c7cd63a2b Nits. 1999-04-23 22:03:00 +00:00
Fred Drake 957ac3fadb Add section for the sha module. 1999-04-23 21:52:18 +00:00