Commit Graph

5470 Commits

Author SHA1 Message Date
Andrew M. Kuchling 28f2f88c31 Add partial section on the logging package; not finished yet. 2002-11-14 14:14:16 +00:00
Skip Montanaro 4ebe2e3914 add liblogging 2002-11-14 03:58:20 +00:00
Skip Montanaro 649698f72e initial rough cut at documentation of logging module. This is basically
just a conversion of pydoc.help(logging).
2002-11-14 03:57:19 +00:00
Fred Drake 66abcee948 Integrate updates to the GNU info conversion.
This includes SF patch #590352 and additional support for more of the custom
markup.
2002-11-13 19:31:04 +00:00
Fred Drake b02f0dfbe9 - Committing the modified signature lines I've been using for a long
time in http://www.python.org/dev/doc/.  There have been no bug
  reports on these for a long time now.
- Remove local "use" statement that duplicates a top-level "use".
2002-11-13 19:16:37 +00:00
Fred Drake bad460790e Document struct_time and the field names. 2002-11-13 19:05:01 +00:00
Fred Drake 4400509aaa Add \funcline, \funclineni, and \methodlineni to the list of functions
that are processed before their arguments.
Closes SF bug #637807.
2002-11-13 17:55:17 +00:00
Fred Drake a5a173efbf Fix broken markup.
Closes SF bug #637807.
2002-11-13 17:48:15 +00:00
Fred Drake 2c184e7eea Typo: it's --> its
Closes SF bug #637810.
2002-11-13 15:56:13 +00:00
Fred Drake ce5619e8a1 Update: Older versions of Python crashed when calling repr()
(including the implied call using back-ticks) of a recursive object,
but this is no longer the case.
Reported by Manus Hand via email.
2002-11-13 15:32:34 +00:00
Fred Drake 674dae245a Clarify that PyImport_AddModule() and PyImport_ExecCodeModule() don't
add any package support structure even if a dotted-name is passed for
the module.
Closes SF bug #424106.
2002-11-13 15:13:38 +00:00
Fred Drake 5c4cf1587b Normalize whitespace.
Fix a number of markup consistency buglets.
2002-11-13 14:59:06 +00:00
Andrew M. Kuchling 8a61f499dc Fill out the 'Porting' section
Add random.sample()
2002-11-13 13:24:41 +00:00
Fred Drake 3d03968c75 Clarified meaning of \w and \W with respect to the UNICODE and LOCALE flags.
Closes SF bug #635595.
2002-11-12 23:12:54 +00:00
Tim Peters b9099c3df4 SF patch 637176: list.sort crasher
Armin Rigo's Draconian but effective fix for

SF bug 453523: list.sort crasher

slightly fiddled to catch more cases of list mutation.  The dreaded
internal "immutable list type" is gone!  OTOH, if you look at a list
*while* it's being sorted now, it will appear to be empty.  Better
than a core dump.
2002-11-12 22:08:10 +00:00
Fred Drake 4b9ed2f346 Clarified documentation of tempnam().
Closes SF bug #635656.
2002-11-12 22:07:11 +00:00
Andrew M. Kuchling cab94a19f6 Update text to refer to 2.2.2
Remove an XXX item: I'm not going to write a section on the email package
    at this point
2002-11-12 18:59:20 +00:00
Andrew M. Kuchling 71dd790ad2 Remove extra word 2002-11-12 18:45:46 +00:00
Raymond Hettinger f24eb35d18 SF patch 629637: Add sample(population, k) method to the random module.
Used for random sampling without replacement.
2002-11-12 17:41:57 +00:00
Raymond Hettinger 0da7f39a7c Closes SF bug #634069 reporting the docs on the ** operator were out
of date and did not reflect the current CPython implementation.
2002-11-08 05:30:23 +00:00
Walter Dörwald 430b1563dd Add documentation for the PEP 293 functionality:
The errors attribute can be changed after the reader/writer
is created.

For encoding there are two additional errors values:
"xmlcharrefreplace" and "backslashreplace".

These values can be extended via register_error().
2002-11-07 22:33:17 +00:00
Fred Drake b5f41dedeb Minor markup adjustments. 2002-11-07 17:13:03 +00:00
Thomas Heller 5b470e0a3a Document the changed fdopen behaviour.
(Hope the markup is ok).
2002-11-07 16:33:44 +00:00
Andrew M. Kuchling 572aae32f1 Old change (probably suggested by Jason Tishler) The GNU/Windows compiler is now called MinGW 2002-11-06 14:34:50 +00:00
Andrew M. Kuchling e3fb22bd4a [Patch #633635 from David M. Cooke]
Make docs accurate; getch() in nodelay mode returns -1
2002-11-06 14:17:21 +00:00
Neal Norwitz 110aa50cc2 Fix minor wording and 2 typos 2002-11-05 23:55:27 +00:00
Neal Norwitz fad265e651 Whoops, fix the typo correctly this time 2002-11-05 22:46:39 +00:00
Barry Warsaw 75f36b7040 Document the new `pp' command. 2002-11-05 22:41:16 +00:00
Neal Norwitz c2f7757ef5 Fix minor typos 2002-11-05 22:37:58 +00:00
Fred Drake 71f5acdd1e Minor cleanups, markup. 2002-11-05 22:19:45 +00:00
Martin v. Löwis a288a234ec Document that images go away when they go away. Fixes #632323. 2002-11-05 22:11:50 +00:00
Fred Drake 18c7d98bd1 Fix a few minor nits. Still need to actually proofread this. 2002-11-05 17:54:02 +00:00
Fred Drake cc6cc5ddff Fix minor markup nits. 2002-11-05 16:52:50 +00:00
Gustavo Niemeyer f8ca8364c9 Patch implementing bz2 module.
* setup.py
  (PyBuildExt.detect_modules): Included bz2 module detection.

* Modules/bz2module.c
* Lib/test/test_bz2.py
* Doc/lib/libbz2.tex
  Included files implementing, testing, and documenting bz2 module.

* Doc/Makefile.deps
* Doc/lib/lib.tex
  Include references to libbz2.tex.

* Misc/NEWS
  (Library): Mention distutils' c++ linkage patch, and new bz2 module.
2002-11-05 16:50:05 +00:00
Andrew M. Kuchling bc5e3cc34f Use personal e-mail address; update date; various small edits; add a name to acks 2002-11-05 00:26:33 +00:00
Andrew M. Kuchling 7a82b8c736 Bring back the patch/bug count paragraph.
Correct source of *strip() changes
Small rewrites.
2002-11-04 20:17:24 +00:00
Andrew M. Kuchling dc3f7e12ee Mention distutil changes 2002-11-04 20:05:10 +00:00
Martin v. Löwis 22610da481 Document symbolic constants for commands. 2002-11-04 17:41:18 +00:00
Fred Drake 2eba52fefb Thinking on comp.text.tex seems to be that it's better to override
\@makefntext than \@footnotetext, so we'll do that instead.
2002-11-04 16:29:31 +00:00
Martin v. Löwis 1da9c57c74 Patch #630829: Don't block on IAC, process suboptions. 2002-11-04 09:56:00 +00:00
Martin v. Löwis f0a4668e6f Add getpreferredencoding. Support @euro modifiers. Fixes #554676.
The @euro part is backported to 2.2.3.
2002-11-03 17:20:12 +00:00
Neal Norwitz cf57e50989 Fix SF #632864, Typo string instead of sting in LibDoc. Will backport. 2002-11-03 13:13:20 +00:00
Neal Norwitz 1aca2d0cb3 Fix SF # 518775, buffer object API description truncated 2002-11-03 02:56:27 +00:00
Neal Norwitz 034c749ff4 Fix SF #618146, overflow error in calendar module
Will backport.
2002-11-03 00:13:42 +00:00
Walter Dörwald 1a7a894d90 Move introductory sentence to where it belongs. 2002-11-02 13:32:07 +00:00
Fred Drake 9482d2591a Update example for the type() function to use the currently accepted
preference of using "is" instead of "==" to compare types, use
built-in names where available, and point to the isinstance()
function.
Closes SF bug #632196.
2002-11-01 21:33:44 +00:00
Fred Drake ff031cfdf4 Define abstract way to get the normal and smaller font sizes that work
even in the footnote context.
2002-10-31 21:04:34 +00:00
Fred Drake 8612a431b9 Add a missing % to a Windows-style environment variable expression.
Minor style guide compliance fix.
Several markup fixes.
2002-10-31 20:46:20 +00:00
Fred Drake 699799e6f3 Add a couple of comments about the use of \normalsize and
\footnotesize.
2002-10-30 22:20:27 +00:00
Fred Drake 2394900a55 Still more magical <link> elements. 2002-10-30 21:51:18 +00:00
Fred Drake dbb2b9d77e Hackish way to generate an up-<link> for the title page if we have
one.

Added misc. comments.
2002-10-30 21:38:32 +00:00
Fred Drake 4a4734927d More <link> support for generated pages. 2002-10-30 21:32:40 +00:00
Fred Drake 8687609a39 Two more <link> elements. 2002-10-30 21:29:50 +00:00
Fred Drake 942bd502e7 Add some relevant <link> elements. 2002-10-30 21:17:10 +00:00
Andrew M. Kuchling 3adefccdcb Use personal e-mail address 2002-10-30 21:08:34 +00:00
Fred Drake 0e2e687ba0 Minor rearranging. 2002-10-30 19:55:23 +00:00
Fred Drake 4e303aad05 Add notes to the asctime() and ctime() descriptions to make it
explicit that locale information is not used.  There wasn't anything
that implied it was, but this has confused users.
2002-10-30 18:17:03 +00:00
Fred Drake b1510d5060 Sprinkle with --favicon options. 2002-10-30 17:07:02 +00:00
Fred Drake b07216b43a Added support for --favicon.
Fix support for the Aesop Meta Type.
2002-10-30 17:05:03 +00:00
Fred Drake 56c8c27b27 Added support for --favicon. 2002-10-30 17:02:21 +00:00
Fred Drake dd3d6a03c0 Add support for using a "favicon".
make_head_and_body():  Re-arranged to do (slightly) less work for each page.
2002-10-30 17:00:58 +00:00
Fred Drake 11eb3d090f Make use of the new "favicon" image. 2002-10-30 16:54:54 +00:00
Fred Drake 45be2fe230 Added "favicon" image. 2002-10-30 16:54:12 +00:00
Fred Drake d0c7137c8b Chapter titles that get split over multiple lines in the typeset
formats can't have whitespace after the last non-blank character (bug
in LaTeX?); fix up a couple of instances of this.

Update an email address.
2002-10-28 19:28:22 +00:00
Martin v. Löwis 74b51ac1e5 Patch #613256: Add nescape method to xml.sax.saxutils. 2002-10-26 14:50:45 +00:00
Raymond Hettinger 7fbd01262c Clarify packages in tutorial. Closes SF bug #616211. 2002-10-26 03:13:57 +00:00
Fred Drake 0eebd5cef9 Implement a safer and more predictable interpolation approach.
Closes SF bug #511737.
2002-10-25 21:52:00 +00:00
Fred Drake 97d5f05221 Update to reflect the refactoring into the RawConfigParser and
ConfigParser classes.
2002-10-25 20:20:58 +00:00
Fred Drake f596826673 - The "-" format flag overrides the "0" flag, not the "-" flag.
- Documented the alternate forms, which were claimed to be documented
  but were not.
2002-10-25 16:55:51 +00:00
Fred Drake 5e96f1ff1d Correct the description of PyErr_Restore().
Closes SF bug #577000.
2002-10-24 20:54:18 +00:00
Fred Drake 79713fd9c6 Relocate an index entry so named anchors are not generated in a section head.
Closes SF bug #546579.
2002-10-24 19:57:37 +00:00
Fred Drake 50276abd9b Update an example to use the DOM implementation object. Explain that
the parse() and parseString() functions use a separate parser, not
actually implement a parser.  (This is a common question.)
2002-10-24 19:36:04 +00:00
Fred Drake 73c5b6602d Clean up some really minor Perl warnings. 2002-10-24 16:36:05 +00:00
Fred Drake ff287cfb4c Point to the PyXML package as an extended version of the "xml" package
that can provide this fuctionality.

Note that the docs for the xml.dom and xml.sax packages are the
definitiona of the Python bindings for the DOM and SAX interfaces.
2002-10-23 20:58:32 +00:00
Fred Drake 88f015dc88 Moved description of _urlopener adjacent to the related functions.
Added missing import to example code.

Added documentation for pathname2url(), url2pathname().
Closes SF bug #623196.
2002-10-22 21:58:06 +00:00
Fred Drake 55803bca98 Describe __path__ along with the rest of the package description.
Closes SF bug #626554.
2002-10-22 21:00:44 +00:00
Fred Drake d6cf8bea0a Modify example to use string methods instead of the string module. 2002-10-22 20:31:22 +00:00
Fred Drake 4b2472647a Clarified the error cases and Unicode handling of PyString_AsString(),
PyString_AsStringAndSize(), and PyString_AS_STRING().
Closes SF bug #606463.
2002-10-22 20:20:20 +00:00
Fredrik Lundh 019bd4a6c1 terminology 2002-10-22 18:26:28 +00:00
Fredrik Lundh 1303c7cb16 add support for basic authentication, based on patch #624180
by Phillip J. Eby
2002-10-22 18:23:00 +00:00
Fred Drake 7d428ecc57 Clarify what versions of Windows are supported, and add Linux
specifically.
2002-10-22 15:06:49 +00:00
Jack Jansen d22eb59535 Added a paragraph to explain that SchedParams(0, 0) is usually what
you want.
2002-10-19 21:36:56 +00:00
Fredrik Lundh e7c38d48ff fixed the mail address in the documentation, too... 2002-10-19 20:22:56 +00:00
Fred Drake 5e31c3f768 Fix markup for tilde in URL. 2002-10-18 18:16:19 +00:00
Fred Drake d8eeeae4a6 Fix reference to the Fetchmail FAQ:
- URL was missing an "m"
- markup for tilde was wrong
- URL was marked as the title
- actual title was omitted

"make webcheck" didn't catch this; not sure why.

Removed some spurious end-of-line whitespace.
2002-10-18 16:50:17 +00:00
Fred Drake ddc369a7d2 Fix markup for tilde in URL. 2002-10-18 16:33:30 +00:00
Fred Drake 78eb200758 Added cross-references to related material on exceptions.
Closes SF bug #217195.

Make sure section numbers wrap together with the preceeding word
("section").
2002-10-18 15:20:32 +00:00
Fred Drake e7097e0b1c Added cross-references to related material on exceptions.
Closes SF bug #217195.
2002-10-18 15:18:18 +00:00
Fred Drake 30be5768d2 Make sure section numbers wrap together with the preceeding word
("section").
2002-10-18 15:03:42 +00:00
Neal Norwitz d7bc0fec38 Try to fix the broken links caused by multiple \ref on the same line.
SF bug #217195.
Not sure if chomp() is correct, but chop() definitely has problems.
This change seems to have no ill effects.

Backport candidate if Fred agrees.
2002-10-18 02:05:47 +00:00
Fred Drake 5f2c1d27b9 Typo(!): "normal" -> "number" 2002-10-17 19:23:43 +00:00
Fred Drake 98ef20d5e4 Document urldefrag(). 2002-10-16 20:07:54 +00:00
Martin v. Löwis f607bdaa77 Add PyStructSequence_UnnamedField. Add stat_float_times.
Use integers in stat tuple, optionally floats in named fields.
2002-10-16 18:27:39 +00:00
Fred Drake 2314a0470f Use string methods. Re-organize imports to Python Normal Form. 2002-10-16 16:06:07 +00:00
Fred Drake 27c4e09a62 Only reset _is_empty if needed. 2002-10-16 16:02:08 +00:00
Fred Drake df85f0b09f Modernization: Use string methods, use str instead of
types.StringType, inherit from list instead of
                UserList.
2002-10-16 16:00:42 +00:00
Fred Drake 071972e426 Use string methods. 2002-10-16 15:30:17 +00:00
Fred Drake 06912b7702 Use string methods. Organize the imports in Python Normal Form. 2002-10-16 15:29:07 +00:00
Fred Drake 4fe904d3d6 Use string methods; minor code cleanup. 2002-10-16 14:59:02 +00:00
Martin v. Löwis 77ac429eff Patch #572628: Optional timeouts for put and get. 2002-10-15 15:11:13 +00:00
Fred Drake 816aebdf94 Use the same shade of blue as the site navigation areas. 2002-10-14 15:45:11 +00:00
Fred Drake f834ecbba5 Minor refactoring to avoid code duplication. 2002-10-14 15:04:33 +00:00
Fred Drake 16ecb2160f Fix tildes in URLs. Closes SF bug #614821. 2002-10-12 15:02:46 +00:00
Raymond Hettinger 463bfafd24 Clarify deprecation of the floor div operator, modulo operator,
and divmod() function for complex numbers.

Closes SF Bug 621708: Unclear deprecation.
2002-10-11 21:08:02 +00:00
Martin v. Löwis 36a4d8c20e Remove mentionings of DOS. 2002-10-10 18:24:54 +00:00
Fred Drake 5430f4e9c8 Document when unittest was added to Python. 2002-10-10 16:16:25 +00:00
Andrew M. Kuchling c309ccab64 Add new posix functions 2002-10-10 16:04:08 +00:00
Barry Warsaw 6f0f961741 Update email micro release number. 2002-10-10 15:58:19 +00:00
Barry Warsaw df88b9fadf Document that the Charset constructor coerces its argument to lower
case.
2002-10-10 15:23:38 +00:00
Barry Warsaw 57ce1430b2 Document that get_content_charset() coerces its return value to lower
case.
2002-10-10 15:22:16 +00:00
Martin v. Löwis dbe3f76270 Patch #569139: Implementation of major, minor and makedev. 2002-10-10 14:27:30 +00:00
Andrew M. Kuchling 3e3e1296f0 [Bug #621039] Fix broken link 2002-10-10 11:32:30 +00:00
Andrew M. Kuchling 83992480ed [Bug #621038] Remove duplicated item 2002-10-10 11:31:48 +00:00
Fred Drake aa02c8441b Accept Armin's documentation patch for SF bug #558179.
Adjusted some markup to make the descriptions more consistent.
2002-10-09 22:33:23 +00:00
Andrew M. Kuchling 0a6fa9619e Minor edits and markup fixes 2002-10-09 12:11:10 +00:00
Mark Hammond 8696ebcd28 Add os.path.supports_unicode_filenames for all platforms,
sys.getwindowsversion() on Windows (new enahanced Tim-proof <wink>
version), and fix test_pep277.py in a few minor ways.
Including doc and NEWS entries.
2002-10-08 02:44:31 +00:00
Martin v. Löwis 20eae69a9f Document PEP 293. 2002-10-07 19:01:07 +00:00
Martin v. Löwis bd5e38d4cc Document PEP 277 changes. 2002-10-07 18:52:29 +00:00
Fred Drake 74653820e3 Modified presentation of the grammar for calls to be easier to read
for both HTML and typeset renderings.  Corresponds to revision
1.53.4.8 on the r22-maint branch.
2002-10-07 16:28:38 +00:00
Martin v. Löwis e9ce0b0fea Patch #448038: Add move(). Report errors from copytree as in shutil.Error. 2002-10-07 13:23:24 +00:00
Martin v. Löwis a844f2d165 Document patch #594001. 2002-10-05 09:46:48 +00:00
Andrew M. Kuchling 0f345567fe Add a section to be written; remove reference to deleted code 2002-10-04 22:34:11 +00:00
Fred Drake 57b38ed424 Remove some unnecessary dependencies (minor). 2002-10-04 19:23:06 +00:00
Fred Drake b915a38b6f Added refcount information for PyObject_GetIter(). 2002-10-04 18:58:58 +00:00
Fred Drake 0ba5541a0e Add a comment to the top of the file explaining why the file is here. 2002-10-01 18:20:16 +00:00
Barry Warsaw cfb30e23d1 build(): Use self.builddir, not self.doc when copying the icons, so
they'll end up in the right directory when --dir is used.
2002-10-01 15:38:01 +00:00
Fred Drake c0e066a7b8 When the HTML output dir is specified using --dir=~/foo, the tilde
needs to be expanded by mkhowto, since the shell won't touch it except
at the start of the complete argument.
2002-10-01 15:30:56 +00:00
Barry Warsaw dd868d32e0 nits 2002-10-01 15:29:09 +00:00
Fred Drake 73ec98357e Include the --dir argument in the help text. 2002-10-01 15:24:03 +00:00
Fred Drake 15a159c231 Change the default path to icons so that "mkhowto" does the "right thing" by
default when used for 3rd-party docs.  This requires the standard Python docs
to specify a location, but they are a bit of a special case in sharing one set
of icons among several documents.
2002-10-01 15:20:20 +00:00
Barry Warsaw de6977f441 Added an introduction. 2002-10-01 15:13:29 +00:00
Fred Drake c61617320f Stub document for the stand-alone email package distribution.
Barry, please add a reasonable abstract!
2002-10-01 14:38:47 +00:00
Fred Drake 6516e14968 Minor style nit for referring to other attributes of the same class
from an attributes description.
2002-10-01 14:29:58 +00:00
Fred Drake fcc31b44d2 Split the long email package examples into separate files and use
\verbatiminput instead of the verbatim environment -- this does the "right
thing" regarding page breaks in long examples for the typeset formats, and
has nice benefits for the HTML version as well.
2002-10-01 14:17:10 +00:00
Barry Warsaw ea66abc6e2 Cleaned up the examples. 2002-10-01 04:48:06 +00:00
Barry Warsaw 5db478fa29 Proofread and spell checked, all except the Examples section (which
I'll do next).
2002-10-01 04:33:16 +00:00
Barry Warsaw 5b9da893d3 Vast update to email version 2. This could surely use proofreading. 2002-10-01 01:05:52 +00:00
Fred Drake 2ca041fde0 items(): New method, provided by Gustavo Niemeyer in SF bug #545096. 2002-09-27 15:49:56 +00:00
Fred Drake 4613876ee3 Add deprecation notices to the documentation to reflect recent additions to
PEP 4.
2002-09-25 22:13:27 +00:00
Fred Drake d80032b009 Update some comments about what version of the documentation tools
code to use.
2002-09-25 21:41:22 +00:00
Fred Drake e134158f23 Finish & commit some docs for markup that's been in use for a while. 2002-09-25 18:44:21 +00:00
Fred Drake 111ee3208f Ok, read the source this time: PyErr_SetObject() does not steal a reference. 2002-09-25 02:34:27 +00:00
Fred Drake 5ec22f2d7b Another try at clarifying what goes into and comes out of Unicode objects.
Document the indices() method of slice objects.
2002-09-24 21:09:13 +00:00
Fred Drake 3e930ba55f Another try at clarifying what goes into and comes out of Unicode objects. 2002-09-24 21:08:37 +00:00
Fred Drake 2f93644c1d Clarify documentation for PyErr_SetObject() to describe the reference
count behavior.
2002-09-24 16:45:16 +00:00
Fred Drake 36c2bd8e34 Remove spurious period. 2002-09-24 15:32:04 +00:00
Fred Drake 7b788e0582 Clarify that len() of a Unicode string returns the number of storage units,
not abstract characters.
2002-09-24 13:57:21 +00:00
Greg Ward 02669a35bc Tweak description of PortableUnixMailbox: "From " lines are actually
quoted (or mangled) *at* delivery-time, not "well before" it.  (At least
that's how Exim and qmail work.)
2002-09-23 19:32:42 +00:00
Thomas Heller c687401337 Fix typos: despatcher -> dispatcher. 2002-09-17 15:19:12 +00:00
Fred Drake 583db0d92b Fix a couple of minor markup glitches. 2002-09-14 02:03:25 +00:00
Andrew M. Kuchling dcfd825c11 Add two items 2002-09-13 22:21:42 +00:00
Fred Drake c1ddc505d9 Minor revision to the "\\" patch, including updating the docs a little to
accomodate the fact that they are more general now that they are for the
os.path module and not just posixpath.

This and the previous patch should be combined and applied to the 2.2-maint
branch.
2002-09-12 18:01:26 +00:00
Skip Montanaro c12909bcc6 add note about os.path.join and drive letters on Windows. 2002-09-12 17:39:56 +00:00
Fred Drake b7c1895ec5 Fix typo reported by Paul Clifford.
Note that there is no str.joinfields(), use str.join() instead.
2002-09-12 14:16:07 +00:00
Fred Drake 73e8ebfc5a Revise text about the level of DOM support, and provide pointers to
the work of the XML-SIG in the main body of the text.

Modify the markup in a few places to avoid wrapping lines in bad
places, and just general cleanliness.
2002-09-11 22:03:47 +00:00
Martin v. Löwis 504bc4f3b7 Remove mentioning of Python 2.0 limitations. Fixes #607783. 2002-09-11 16:26:03 +00:00
Fred Drake 691fb55dd2 Clarify who maintains Tkinter and who maintains Tk. 2002-09-10 21:59:17 +00:00
Raymond Hettinger d3e0265373 Document type and semantics of the tp_print return value. Closes SF 606464. 2002-09-10 13:48:01 +00:00
Martin v. Löwis a32c994129 Always generate floats for stat_result; fix configure test. 2002-09-09 16:17:47 +00:00
Martin v. Löwis 94717ed1d4 Patch #606592: Subsecond timestamps in stat_result. 2002-09-09 14:24:16 +00:00
Raymond Hettinger 8a64d40949 Fix typo. Close SF Bug 606354. 2002-09-08 22:26:13 +00:00
Raymond Hettinger a0e4d6ceaf Clarified that the footnote applies to versions 1.5 and after instead of
just version 1.5.  Closes SF bug 577793.
2002-09-08 21:10:54 +00:00
Raymond Hettinger 513069028f Fix API typo. The write buffer is not const. Closes SF 606216. 2002-09-08 04:39:28 +00:00
Skip Montanaro 2c0d3224fc tightened up the definition of \b and \B some more based upon discussion
after the last checkin.
2002-09-07 18:48:14 +00:00
Raymond Hettinger 44c42b9cf3 Added a tutorial note and example regarding the scope of loop variables
in a list comprehension.  Includes a justification and a comparision
to regular for-loops.

Closes SF bug 605047.
2002-09-06 18:06:04 +00:00
Walter Dörwald 5ccaf8f129 Apply diff3.txt (plus additional documentation)
from SF patch http://www.python.org/sf/554192

This adds two new functions to mimetypes:
guess_all_extensions() which returns a list of all known
extensions for a mime type, and add_type() which adds one
mapping between a mime type and an extension.
2002-09-06 16:15:58 +00:00
Skip Montanaro 2c519981fb update docs to reflect that \b considers underscore to be part of a word. 2002-09-06 14:38:23 +00:00
Raymond Hettinger d918884bb8 Fix typo 2002-09-04 23:52:42 +00:00
Raymond Hettinger a04c3d86ae Fix typo 2002-09-04 15:12:07 +00:00
Skip Montanaro 8e790e7007 expose PYTHON_API_VERSION macro as sys.api_version. Closes patch # 601456. 2002-09-03 13:25:17 +00:00
Martin v. Löwis f62a89b1e0 Ignore encoding declarations inside strings. Fixes #603509. 2002-09-03 11:52:44 +00:00
Andrew M. Kuchling 65b7282ef7 Add reminder about PEP293 2002-09-03 00:53:21 +00:00
Walter Dörwald 3aeb632c31 PEP 293 implemention (from SF patch http://www.python.org/sf/432401) 2002-09-02 13:14:32 +00:00
Michael W. Hudson 53d58bb369 Further SET_LINENO reomval fixes. See comments in patch #587933.
Use a slightly different strategy to determine when not to call the line
trace function.  This removes the need for the RETURN_NONE opcode, so
that's gone again.  Update docs and comments to match.

Thanks to Neal and Armin!

Also add a test suite.  This should have come with the original patch...
2002-08-30 13:09:51 +00:00
Skip Montanaro ee113f08f8 add warning about exception messages 2002-08-28 01:14:57 +00:00
Raymond Hettinger 9240be2a35 Note change in behavior from 1.5.2. The new argument to NameError is
an error message and not just the missing name.

Closes SF Bug 599869.
2002-08-27 23:53:23 +00:00
Fred Drake 80a04a4894 Add strong security warning about the rexec module.
Closes SF patch #600861.

Minor markup changes.
2002-08-27 16:46:06 +00:00
Fred Drake 246beb2526 Don't use tempfile.mktemp(), since it produces annoying warnings, and
usually isn't what we want anyway.
2002-08-27 16:34:54 +00:00
Tim Peters ea76c98014 Implemented <, <=, >, >= for sets, giving subset and proper-subset
meanings.  I did not add new, e.g., ispropersubset() methods; we're
going nuts on those, and, e.g., there was no "friendly name" for
== either.
2002-08-25 18:43:10 +00:00
Raymond Hettinger 7ad09552d0 Correct documentation of allow_reuse_address to match the actual script.
Closes SF bug 599681.
2002-08-25 16:27:33 +00:00
Raymond Hettinger e87ab3fefe Removed < <= > >= from the API. Implemented as comparisons of the
underlying dictionaries, there were no reasonable use cases (lexicographic
sorting of a list of sets is somewhat esoteric).  Frees the operators
for other uses (such as strict subset and superset comparisons).

Updated documentation and test suite accordingly.
2002-08-24 07:33:06 +00:00
Fred Drake 055be47b43 Fix typo reported to python-docs. 2002-08-23 21:19:53 +00:00
Raymond Hettinger fa8dd5f407 Fix markup and punctuation 2002-08-23 18:10:54 +00:00
Tim Peters b81b252fab s/_as_Temporarily_Immutable/_as_temporarily_immutable/g, because the
latter is what the code actually does.
2002-08-23 17:48:23 +00:00
Tim Peters 54fd3e6ffc pop(): An arbitrary element is removed, not a random element. 2002-08-23 17:45:43 +00:00
Fred Drake d10c6c949a Adjust the markup in a few places so this will actually format.
Remove the third column in the tables since it isn't used.
2002-08-23 17:22:36 +00:00
Fred Drake d526011091 Add an entry for the sets module documentation.
Move another entry so the boilerplate doesn't get mixed up with
document-specific content.
2002-08-23 15:38:02 +00:00
Raymond Hettinger 584cb198f7 Load docs for sets.py 2002-08-23 15:18:38 +00:00
Greg Ward 373198e751 Fix peculiar (and ungrammatical) wording in an example program. 2002-08-22 19:15:35 +00:00
Fred Drake 13090e1025 Give the section on PEP 263 a more meaningful title, so readers will
be able to locate this information without knowing the PEP number.
2002-08-22 16:51:08 +00:00
Fred Drake 5ec486b87a Add a note that apply() is needed since the extended call syntax is
completely equivalent.
2002-08-22 14:27:35 +00:00
Fred Drake 61cf4407be Added a main() function and support to run this module as a script.
Closes SF feature request #588768.
2002-08-21 20:56:21 +00:00
Fred Drake 5b09eeea89 Clarify that even though some of the relevant specifications define the
order in which form variables should be encoded in a request, a CGI script
should not rely on that since a client may not conform to those specs, or
they may not be relevant to the request.
Closes SF bug #596866.
2002-08-21 19:24:21 +00:00
Raymond Hettinger a6e16a86c4 Replace all cases of "while 1" with "while True".
Though slightly slower, has better clarity and teaching value.
2002-08-21 04:54:00 +00:00
Fred Drake ffefb1df56 Clarify the endpos argument to the rx.match() method.
Closes SF bug #597177.
2002-08-20 13:57:47 +00:00
Andrew M. Kuchling bc4651083e Cover the sets module.
(There's a link to PEP218; has PEP218 been updated to match the actual
module implementation?)
2002-08-20 01:34:06 +00:00
Andrew M. Kuchling 6974aa93c1 Create two subsections of the "Core Language Changes" section, because
the list is getting awfully long
Mention Karatsuba multiplication and some other items
2002-08-20 00:54:36 +00:00
Neal Norwitz 11b795cd0f Add versionadded for operator.pow 2002-08-19 22:38:01 +00:00
Fred Drake 017778332f Extend some comments on the order of values in the returns from
dict.items/keys/values/iteritems/iterkeys/itervalues().
2002-08-19 21:58:58 +00:00
Guido van Rossum 45ec02aed1 SF patch 576101, by Oren Tirosh: alternative implementation of
interning.  I modified Oren's patch significantly, but the basic idea
and most of the implementation is unchanged.  Interned strings created
with PyString_InternInPlace() are now mortal, and you must keep a
reference to the resulting string around; use the new function
PyString_InternImmortal() to create immortal interned strings.
2002-08-19 21:43:18 +00:00
Raymond Hettinger 5959c559df Added __pow__(a,b) to the operator module. Completes the pattern of
all operators having a counterpart in the operator module.

Closes SF bug #577513.
2002-08-19 03:19:09 +00:00
Michael W. Hudson dd32a91cc0 This is my patch
[ 587993 ] SET_LINENO killer

Remove SET_LINENO.  Tracing is now supported by inspecting co_lnotab.

Many sundry changes to document and adapt to this change.
2002-08-15 14:59:02 +00:00
Andrew M. Kuchling 90e9a79afd Add 'in' change
Revise sentence
Add two reminders
2002-08-15 00:40:21 +00:00
Fred Drake 794643c314 Py_InitModule() and friends now accept NULL for the 'methods'
argument.  This makes sense now that extension types can support
__init__ directly rather than requiring function constructors.
2002-08-14 20:59:38 +00:00
Barry Warsaw b8c20a723f More updates describing FutureWarnings. 2002-08-14 16:40:54 +00:00
Tim Peters 2f238c1b22 mkstemp's last argument changed from binary=True to text=False. 2002-08-14 16:37:10 +00:00
Barry Warsaw 29ce2d7d1e Document PyExc_FutureWarning 2002-08-14 16:06:28 +00:00
Fred Drake 5c08a99b77 Remove a broken example of extreme backward compatibility; it is
simply not relevant any more.
Closes SF bug #595032.
2002-08-14 15:26:18 +00:00
Fred Drake 918af2aef7 The auto-reply text for the python-docs address. This is not automatically
updated when checkins are made, but I can get that updated when needed.
2002-08-12 22:01:42 +00:00
Fred Drake a132f6c38b Accomodate the packaging changes when we unpack into the dev/doc/ area
on python.org.
2002-08-09 22:56:46 +00:00
Fred Drake 1a0199a74f Lots of changes to the packaging of the documentation, all to keep
directories clean where the packages are unpacked.  Each package now
contains a single directory, Python-Docs-<version>/, which contains the
files for that version of the documentation.

Closes SF feature request #567576.
2002-08-09 20:20:50 +00:00
Guido van Rossum 830a5151c1 Doc portion of SF 589982 (tempfile.py rewrite, by Zack Weinberg).
Fred, please review!
2002-08-09 16:16:30 +00:00
Raymond Hettinger ae7ef57cba GvR pointed out that only enclosing function bodies are part of nested scopes. 2002-08-07 20:20:52 +00:00
Guido van Rossum b2865919cc Document that heappop() and heapreplace() raise IndexError if the heap
is empty.
2002-08-07 18:56:08 +00:00
Raymond Hettinger 83dcf5a290 Apply character{} markup. 2002-08-07 16:53:17 +00:00
Raymond Hettinger 22c001bd29 Described responsibilty of weakly referenced extension types to initialize
the weakreflist to NULL in the constructor and to fill the tp_flags
slot with Py_TPFLAGS_HAVE_WEAKREFS.  Closes SF bug 586583.
2002-08-07 16:18:54 +00:00
Raymond Hettinger 861bb02448 Describe nested scopes in the tutorial. Closes SF bug 500704. 2002-08-07 16:09:48 +00:00
Raymond Hettinger 3cfdc3402e Documented os.fsync and os.fdatasync. Closes SF bug 584695. 2002-08-07 15:48:17 +00:00
Fred Drake 442c7c7743 Clarify that the bool instances are acceptable return values from
__nonzero__(), in response to SF bug #579991.
2002-08-07 15:40:15 +00:00
Fred Drake f7aa164d7a Fix up some more markup problems. 2002-08-07 13:24:09 +00:00
Fred Drake 95fa4ddf7b Change the markup a bit more; the parameter was not marked as \var in the
sample code, and the note was marked as a logical thing.
2002-08-07 12:39:33 +00:00
Steve Holden 63d5bead18 Fix markup errors. 2002-08-07 12:01:41 +00:00
Raymond Hettinger d9fdb51df6 Document handling of raw-unicode-escapes. Closes SF bug 587087. 2002-08-06 22:36:26 +00:00
Jack Jansen d37f75b88a Added a note about the inability to specify a pathname to a non-existing
file in unix-Python.
2002-08-06 22:15:23 +00:00
Jack Jansen 4104b50b52 Changed a sentence that confused some people. 2002-08-06 22:14:23 +00:00
Fred Drake 31f3db39f3 Fix the markup so it doesn't break formatting. 2002-08-06 21:36:06 +00:00
Fred Drake 2d3c03df9a Added references to the email package.
Closes SF bug #586937.
2002-08-06 21:26:01 +00:00
Guido van Rossum 43af5b5852 Add some fine points: METH_KEYWORDS implies METH_VARARGS, and ob_size
is no longer unused in type objects.
2002-08-06 17:18:56 +00:00
Guido van Rossum 97c5fccd77 Remove mention of deprecated xreadlines method. 2002-08-06 17:03:25 +00:00
Guido van Rossum 0fc01865f3 Document file.next(). Mark xreadlines obsolete (both method and
module).  (One thing remains to be done: the gzip class has an
xreadline method; this ought to be replaced by an iterator as well.)
2002-08-06 17:01:28 +00:00
Barry Warsaw 817918cc3c Committing patch #591250 which provides "str1 in str2" when str1 is a
string of longer than 1 character.
2002-08-06 16:58:21 +00:00
Steve Holden 545092b063 Add comment about os.path.walk()'s behavior with symbolic links. 2002-08-06 16:07:07 +00:00
Andrew M. Kuchling 950725f755 Mention list.sort()
Document heapq module
Add PEP263 section (not sure I really understand the PEP's effect on 8-bit
   strings, though -- will have to experiment with it)
2002-08-06 01:40:48 +00:00
Neal Norwitz e72a9a13a1 SF patch #591305 Documentation err in bytecode defs 2002-08-05 23:33:54 +00:00
Raymond Hettinger acb45d72b4 Note that True and False are pickable objects 2002-08-05 03:55:36 +00:00
Martin v. Löwis 00f1e3f5a5 Patch #534304: Implement phase 1 of PEP 263. 2002-08-04 17:29:52 +00:00
Steve Holden c8389c91c2 Remove a syntax error in the example, spotted by Walter Hofman. 2002-08-04 15:27:25 +00:00
Andrew M. Kuchling c61ec523ed Add two reminders 2002-08-04 01:20:05 +00:00
Tim Peters 0ad679ff0f Document new heapreplace() function. 2002-08-03 18:53:28 +00:00
Tim Peters 6e0da82a97 Document new heapify() function. 2002-08-03 18:02:09 +00:00
Fred Drake 1acab695a7 Minor markup changes. 2002-08-02 19:46:42 +00:00
Fred Drake b481286504 Add a comment showing how one of the macros should be used. 2002-08-02 18:30:22 +00:00
Fred Drake ad09bbfce3 Add heapq module docs to the dependency information. 2002-08-02 18:20:34 +00:00
Guido van Rossum 975121664e Add docs for heapq.py. 2002-08-02 18:03:24 +00:00
Skip Montanaro de994d9130 indicate that 'b' is added to the mode flag if not given 2002-08-02 17:20:46 +00:00
Tim Peters 74824584ef Added new footnote about list.sort() stability. Repaired footnote about
using sort() with comparison functions (it made reference to the non-
existent "builtin-in function sort()").

BTW, I changed list.sort's docstring to contain the word "stable" -- the
easiest way to tell whether a particular Python version's sort *is* stable
is to look for "stable" in the docstring.  I'm not sure whether to
advertise this <wink>.
2002-08-01 03:10:45 +00:00
Mark Hammond 543fb35cca Replace DL_EXPORT with PyMODINIT_FUNC 2002-07-31 06:17:46 +00:00
Fred Drake 5b11bdd0ed SF patch #581414: info reader bug
The "Matching vs. Searching" Info node is unreachable from the Info
program (but is fine in Emacs's Info mode). This patch seems to fix
it.  This is the only occurrence where the info reader fails, so
probably it could be addressed in the python docs as a workaround.
Forwarded the report to the info maintainer.
2002-07-30 17:51:20 +00:00
Thomas Heller 085358a3e2 New functions for extension writers on Windows:
PyErr_SetExcFromWindowsErr(), PyErr_SetExcFromWindowsErrWithFilename().

Similar to PyErr_SetFromWindowsErrWithFilename() and
PyErr_SetFromWindowsErr(), but they allow to specify
the exception type to raise. Available on Windows.

See SF patch #576458.
2002-07-29 14:27:41 +00:00
Andrew M. Kuchling 52f1b76f6c Add posix.lchown() 2002-07-28 20:29:03 +00:00