Commit Graph

7318 Commits

Author SHA1 Message Date
Fred Drake db22958f07 update documentation on what constitutes a line in a source file
(closes SF bug #1167922)
2005-05-25 05:29:17 +00:00
Skip Montanaro 5ff1492720 Add O_SHLOCK & O_EXLOCK. Closes patch #1103951. 2005-05-16 02:42:22 +00:00
Skip Montanaro 174dd2219d Add better datetime support to xmlrpclib module. Closes patch #1120353. 2005-05-14 20:54:16 +00:00
Raymond Hettinger 0f43983aa3 SF bug #1201807: Glossary listing bug 2005-05-14 17:18:31 +00:00
Skip Montanaro 766349e57e Incorporate a lightly edited version of the SocketServer module's docstring
into the docs and segregate the method descriptions for the various classes
into separate sections.  Base on suggestion by Paul Rubin in c.l.py.
2005-05-12 13:42:42 +00:00
Raymond Hettinger b56b494bea SF bug #1190451: 6.9 First sentence is confusing
* Fixed incorrect wording:  expression->exception
* Noted the specific exception reported by "raise" when the is nothing
  to re-raise.
* Eliminated several instances of "e.g." as recommended in the style guide.
2005-04-28 07:18:47 +00:00
Michael W. Hudson e8dead47e6 Fix
[ python-Bugs-1190599 ] dir() docs show incorrect output

though not entirely how it's suggested in the bug report.
2005-04-27 09:41:23 +00:00
Raymond Hettinger f21569e53d Fix typo. 2005-04-26 05:18:53 +00:00
Raymond Hettinger 87bd3fe266 Correct swapped descriptions of empty string splits. 2005-04-19 04:29:44 +00:00
Walter Dörwald 769f8219a4 SF patch #1180062 by George Yoshida:
Doc/lib/libfunctional.tex: "in an new object" should read "in a new object"
Doc/lib/libsubprocess.tex: argument name is wrong; comma is missing.
2005-04-14 20:08:59 +00:00
Fred Drake cc97ebf577 get_method() returns a method name, not take it as an argument
(backporting to release24-maint branch)
2005-04-13 01:08:23 +00:00
Raymond Hettinger fc11383ec3 SF bug #1180392: StringIO's docs should mention overwriting of initial value
* Added a note that the initial file position is zero even if the object
  is freshly initialized.
2005-04-11 01:03:44 +00:00
Raymond Hettinger e490502e04 SF bug #1179957: Missing def'n of equality for set elements 2005-04-10 17:32:35 +00:00
Andrew M. Kuchling d8d732e7d2 Fill out one section 2005-04-09 23:59:41 +00:00
Andrew M. Kuchling 4b000cd819 Add more text 2005-04-09 15:51:44 +00:00
Brett Cannon 629496b77c Add grammar change for allowing ``class B(): pass`` syntax. 2005-04-09 03:03:00 +00:00
Raymond Hettinger ad351f806d SF bug #1178269 Clarify when isMappingType/isSequenceType is True. 2005-04-07 05:36:17 +00:00
Raymond Hettinger fb5f04d77f SF bug #1178255: 256 should read 255 in operator module docs 2005-04-07 04:38:04 +00:00
Vinay Sajip 99358df865 Added threadName to LogRecord 2005-03-31 20:18:06 +00:00
Michael W. Hudson 5c473559e5 Minor wording fix. 2005-03-30 16:25:34 +00:00
Fred Drake 1b17b6bf08 add 2.4.1 to the release history 2005-03-29 16:06:51 +00:00
Martin v. Löwis 0f9679d2b0 Mention that DEBUG_LEAK includes DEBUG_SAVEALL. Fixes #1170460.
Will backport to 2.4.
2005-03-28 15:29:28 +00:00
Greg Ward a17fa89a2b SF #1169212: merge from 2.4 branch: fix silly typo in explaining AFMT
macros: U16 is unsigned and S16 is signed.  Duh.  Clarify surrounding
text a bit and refer to OSS docs.
2005-03-28 02:34:59 +00:00
Raymond Hettinger 1b2e0d9da0 Fix whitespace. 2005-03-27 20:19:05 +00:00
Raymond Hettinger fdf3bd6630 SF patch #1171417: bug fix for islice() in docs 2005-03-27 20:11:44 +00:00
Thomas Heller 33ceda85d0 Function signatures for tp_descr_get and tp_descr_set. 2005-03-24 07:45:53 +00:00
Fred Drake 712f07082d clean up the underscore mess for the typeset formats so that subscripts
work in math displays (thanks to Bo Peng on the Doc-SIG)
2005-03-24 06:21:37 +00:00
Walter Dörwald c8734a7257 Fix typo. 2005-03-23 10:38:59 +00:00
Fred Drake ae22bbed81 - fix markup bugs
- more consistent markup
- elaborate a couple of points
2005-03-22 04:09:37 +00:00
Martin v. Löwis 55f1bb8bfa Add the upload command. Make all dist commands register their
outputs with the distribution object.
2005-03-21 20:56:35 +00:00
Skip Montanaro 3f8f666914 correct ontosys url - closes 1167329 2005-03-21 19:39:16 +00:00
Fred Drake dd6f04630f fix obscure markup error, wrapping a long line 2005-03-21 05:51:01 +00:00
Fred Drake 114b8caf01 fix environment broken in revision 1.6 2005-03-21 05:47:11 +00:00
Fred Drake db7b0027dc PEP 314 implementation (client side):
added support for the provides, requires, and obsoletes metadata fields
2005-03-20 22:19:47 +00:00
Andrew M. Kuchling b1c96fd83e Write part of PEP 309 section 2005-03-20 21:42:04 +00:00
Andrew M. Kuchling 0c35db9dd1 Describe how to get back lib-old; if this isn't the best way, please let me know 2005-03-20 20:06:49 +00:00
Andrew M. Kuchling 511a3a8174 Add item 2005-03-20 19:52:18 +00:00
Andrew M. Kuchling e9b1bf4718 Describe various things 2005-03-20 19:26:30 +00:00
Raymond Hettinger 582ffe21c4 Fill-in missing argspec. 2005-03-19 16:27:33 +00:00
Raymond Hettinger 4aec61e0fc Add a remove() method to collections.deque objects. 2005-03-18 21:20:23 +00:00
Skip Montanaro 5011c3f7fc add UnicodeReader and UnicodeWriter example classes 2005-03-18 16:56:37 +00:00
Raymond Hettinger f77d0334f3 Revised the itertools quantifier recipes to match the performance of the
new builtins.
2005-03-11 22:17:30 +00:00
Raymond Hettinger 96229b1918 Add two new functions, any() and all(). 2005-03-11 06:49:40 +00:00
Brett Cannon 01668a1ab9 Fix test for socket.getfqdn() to also include the name returned by
socket.gethostname() in the check for a valid return.

Also clarified docs (official and docstring) that the value from gethostname()
is returned if gethostbyaddr() doesn't do the job.
2005-03-11 00:04:17 +00:00
Fred Drake 346803e060 - fix generated Texinfo markup for \deprecated
- add support for additional markup: \leq, \textbar, \textit
- add a comment about the non-support for the Euro character
(ported from release24-maint branch release 1.10.4.2)
2005-03-10 05:02:18 +00:00
Fred Drake 1592c4c6b2 fix broken usage comment 2005-03-10 04:01:14 +00:00
Fred Drake cc933af1ac add missing entries from GNU info conversion table
(ported from release24-maint branch revision 1.10.4.1)
2005-03-10 03:59:35 +00:00
Fred Drake 9687b4dc57 correct several markup errors caught by the GNU info conversion
(ported from release24-maint branch revision 1.86.2.3)
2005-03-10 03:48:14 +00:00
Raymond Hettinger 984f9bb714 operator.itemgetter() and operator.attrgetter() now support extraction
of multiple fields.  This provides direct support for sorting by
multiple keys.
2005-03-09 16:38:48 +00:00
Skip Montanaro 1c7ddb625e hmmm... moving def'n of version makes the __init__ unnecessary for the
example
2005-03-09 03:01:31 +00:00
Skip Montanaro 8e97fbf360 Correct description/example of how to override User-agent. 2005-03-09 02:57:26 +00:00
Raymond Hettinger 3e1dd3be49 Make functional.partial() more closely match the spec by emulating some useful features of regular functions:
* Made weak referencable.
* Allow attribute access so a user can set __name__, __doc__, etc.
2005-03-08 07:15:36 +00:00
Greg Ward ff564d3391 SF #1156412: document the __new__() static method
(merge from release24-maint branch).
2005-03-08 01:10:20 +00:00
Greg Ward 50682d0f78 SF #818006: merge from release24-maint branch: add useful read-only
attributes to oss_audio_device object: 'closed', 'name', and 'mode'.
2005-03-07 01:41:11 +00:00
Martin v. Löwis 78be7df9e4 Patch #918101: Add tarfile open mode r|* for auto-detection of the
stream compression; add, for symmetry reasons, r:* as a synonym of r.
2005-03-05 12:47:42 +00:00
Martin v. Löwis 00a73e7715 Patch #1043890: tarfile: add extractall() method. 2005-03-04 19:40:34 +00:00
Michael W. Hudson a2a9888f22 Updates to the exceptions documentation (this is my patch #1156102). 2005-03-04 14:33:32 +00:00
Martin v. Löwis c9f852512c Patch #1107221: Updated "Working on Cygwin" section.
Will backport to 2.4.
2005-03-03 23:07:21 +00:00
Fred Drake b098fd7f89 minor edits:
- function names marked with \function should include parentheses
- "standard error" instead of "stderr" for text
- a boolean parameter takes true or false values, not just True or False
2005-03-03 17:25:04 +00:00
Martin v. Löwis 7fe60c0a0a Patches #749830, #1144555: allow UNIX mmap size to default to current
file size.
2005-03-03 11:22:44 +00:00
Martin v. Löwis 9b62b39070 Document quiet parameter to decode. Fixes #803413. 2005-03-03 10:06:05 +00:00
Raymond Hettinger 6a458e9bc9 Noted that the module is new in version 2.5. 2005-03-02 15:10:38 +00:00
Skip Montanaro c8c45c25ac Improve (?) description of system dependence of access to the pw_passwd
field on systems that support shadow passwords.
2005-03-02 04:29:23 +00:00
Andrew M. Kuchling 3e41b0597b Note various changes that need to be described 2005-03-01 00:53:46 +00:00
Raymond Hettinger 9c323f8de4 SF patch #941881: PEP 309 Implementation (Partial Function Application).
Combined efforts of many including Peter Harris, Hye-Shik Chang,
Martin v. Löwis, Nick Coghlan, Paul Moore, and Raymond Hettinger.
2005-02-28 19:39:44 +00:00
Raymond Hettinger bc2c21ea52 Update an example to match current output. 2005-02-23 20:40:42 +00:00
Raymond Hettinger 2b0d058cd5 Document missing opcodes. 2005-02-21 20:28:07 +00:00
Raymond Hettinger 467024ccfc Fix some wording and grammar nits. 2005-02-21 15:46:52 +00:00
Vinay Sajip 84df97fdd6 Fixed documentation for SMTPHandler 2005-02-18 11:50:11 +00:00
Brett Cannon 5bbe6ad2b5 Fix name for PyDateTime_FromDateAndTime.
Closes bug #1124278.
2005-02-17 05:17:17 +00:00
Brett Cannon 7706c2da14 Update references specifying "Macintosh" to mean OS X semantics and not Mac OS
9.

Applies patch #1095802.  Thanks Jack Jansen.
2005-02-13 22:50:04 +00:00
Raymond Hettinger 4e9907c914 SF bug #1119700: list extend() accepts args besides lists 2005-02-09 23:19:25 +00:00
Fred Drake 9aa890a149 add 2.3.5, 2.4 to the history and licensing info 2005-02-08 06:42:39 +00:00
Guido van Rossum d064142579 Security fix PSF-2005-001 for SimpleXMLRPCServer.py. 2005-02-03 15:01:24 +00:00
Johannes Gijsbers b5646aa3fb Bug #1108490: fix broken link. 2005-01-29 19:49:34 +00:00
Raymond Hettinger bc029af436 SF bug #1108303: fix .split() maxsplit doc
Docs incorrectly stated that maxsplit=0 would cause unlimited splitting.
2005-01-26 22:40:08 +00:00
Raymond Hettinger 770184b365 SF bug #1105286: Undocumented implicit strip() in split(None) string method
Clarify the behavior when a string begins or ends with whitespace.
2005-01-25 10:21:19 +00:00
Fred Drake 93f18f6f77 include each row in the package table, even if there are no packages for
that row; the row is commented out in that case
(this makes it easier to modify the table after generation)
2005-01-23 22:14:16 +00:00
Martin v. Löwis c300175547 Patch #579435: Shadow Password Support Module 2005-01-23 09:27:24 +00:00
Martin v. Löwis 4d394dfebb Truncate st_?time before comparing it with ST_?TIME in the tests. 2005-01-23 09:19:22 +00:00
Fred Drake 447083e4d0 fix typeset of vertical bar for PDF format
(closes SF bug #1008998)
2005-01-19 07:24:34 +00:00
Fred Drake ffcbab073e documentation for the zipimport module using contributed patch
(closes SF bug #853800; markup adjusted)
2005-01-19 05:42:50 +00:00
Fred Drake 5e37d79567 Description of args to IMAP4.store() in imaplib
(closes SF patch #1084092; modified per comments in SF)
2005-01-19 04:44:07 +00:00
Fred Drake 140042446f Clean up discussion of new C thread idiom
(closes SF patch #1031233; modified)
2005-01-19 04:18:39 +00:00
Fred Drake b184ae860e fix a bunch of spelling errors
(closes SF patch #1104868)
2005-01-19 03:39:17 +00:00
Fred Drake 9f79dbfd4a remove spurious line from widget variables example
(closes SF patch #1094815)
2005-01-19 03:23:57 +00:00
Skip Montanaro 058858151d Document the reconvert module. 2005-01-16 20:48:27 +00:00
Martin v. Löwis fe33d0ba87 Default stat_float_times to true. 2005-01-16 08:57:39 +00:00
Martin v. Löwis 22b457e03b Added SEEK_* constants. Fixes #711830. 2005-01-16 08:40:58 +00:00
Tim Peters 9ba3684ecc Gave the new datetime.strptime() a versionadded blurb. 2005-01-13 21:06:25 +00:00
Skip Montanaro 0af3ade6aa Add strptime() constructor to datetime class. Thanks to Josh Spoerri for
the changes.
2005-01-13 04:12:31 +00:00
Fred Drake 2f8c6589f5 fix typo 2005-01-12 19:11:45 +00:00
Andrew McNamara 8231de0513 Many updates to csv module doco. 2005-01-12 11:47:57 +00:00
Raymond Hettinger d4f5b07e5d Add duck-typing to the glossary. 2005-01-11 16:11:13 +00:00
Johannes Gijsbers 97613ad02d Patch #1051321 (fixes bugs 1010196, 1013525), by Mike Brown:
* Document hasFeature(), createDocument(), CreateDocumentType(),
  hasAttribute(), hasAttributeNS().

* In the documentation for createDocument(), it is now stated that the Python
  DOM API allows implementations to forego creation of the document element
  child node, if no namespace and local name arguments are given. (This
  possibility is left open and unaddressed in the W3C spec).

* Addition by me: use 'name' rather than 'attname', for consistency with the
  DOM specification and the Python DOM API implementation.
2005-01-09 00:36:53 +00:00
Johannes Gijsbers 158df10341 Bug #1098497: various small typo's, grammar and markup nits. 2005-01-09 00:12:48 +00:00
Johannes Gijsbers 836f5433f7 Patch #943206:
`glob.glob()` currently calls itself recursively to build a list of matches of
the dirname part of the pattern and then filters by the basename part. This is
effectively BFS. ``glob.glob('*/*/*/*/*/foo')`` will build a huge list of all
directories 5 levels deep even if only a handful of them contain a ``foo``
entry. A generator-based recusion would never have to store these list at once
by implementing DFS. This patch converts the `glob` function to an `iglob`
recursive generator . `glob()` now just returns ``list(iglob(pattern))``.

I also cleaned up the code a bit (reduced duplicate `has_magic()` checks and
created a second `glob0` helper func so that the main loop need not be
duplicated).

Thanks to Cherniavsky Beni for the patch!
2005-01-08 13:13:19 +00:00
Johannes Gijsbers e4172eadf3 Patch #1094015:
* Use os.makedirs() instead os.mkdir(). (bug #975763)
* Use copystat() to copy directory bits (bug #1048878)
2005-01-08 12:31:29 +00:00
Andrew M. Kuchling e4f5600e5c [Bug 1083177] Describe signal() change; add a link 2005-01-07 14:34:41 +00:00
Raymond Hettinger 97db05de3e SF #75103: imghdr -- identify JPEGs in EXIF format 2005-01-07 08:15:41 +00:00
Raymond Hettinger 72b83c86a9 SF patch 1094011: Docs for file() vs open(). 2005-01-07 04:33:44 +00:00
Facundo Batista bccc9a956a Added example to os.stat() 2005-01-07 02:50:22 +00:00
Raymond Hettinger 17a7924667 SF bug #1091740: garbage collector still documented as optional 2005-01-07 00:49:17 +00:00
Skip Montanaro becbdec1d9 add two missing items 2005-01-05 07:19:11 +00:00
Skip Montanaro b80bad4366 add descriptions of exported data attributes 2005-01-05 07:13:32 +00:00
Skip Montanaro 4f49e7d0e7 describe reset() 2005-01-05 07:03:53 +00:00
Skip Montanaro bb0c9dc852 add a couple missing items 2005-01-05 06:58:15 +00:00
Raymond Hettinger 31043cd6d8 Clarify that DictMixin is still useful. Only the UserDict class was supplanted. 2005-01-04 21:25:00 +00:00
Martin v. Löwis d61788b9ae Fix typo. 2005-01-03 23:42:01 +00:00
Peter Astrand 454f76711c New subprocess utility function: check_call. Closes #1071764. 2005-01-01 09:36:35 +00:00
Raymond Hettinger 68804315e0 SF Patch #1093896: miscellaneous doc typos 2005-01-01 00:28:46 +00:00
Raymond Hettinger 79e0531aef SF bug #1090139: presentation typo in lib: 6.21.4.2 How callbacks are called 2004-12-31 01:07:27 +00:00
Martin v. Löwis 658b50f579 Update to VC 7.1. Will backport to 2.4. 2004-12-30 10:44:32 +00:00
Andrew M. Kuchling 0aa8ef1545 Typo fix 2004-12-29 12:34:21 +00:00
Skip Montanaro 9935e7fac0 correct decorator example, tweak description slightly 2004-12-26 15:29:28 +00:00
Brett Cannon ac7836ae55 Fix sentence stating TextEdit only saves in RTF; can save in plaintext as well.
Closes bug #1085300.  Thanks unclewalrus.
2004-12-24 02:40:59 +00:00
Fred Drake 0a6864ecc5 discuss how the __builtin__ module is normally used, and try to clarify the
difference between __builtins__ and __builtin__ (based on an email comment)
2004-12-23 16:50:36 +00:00
Fred Drake fb915fe812 fix weird capitalization of "built-in" 2004-12-23 16:22:45 +00:00
Jeremy Hylton 6414cd8717 SF patch #1055159 via Titus Brown: Document redirect limitation.
Bug fix candidate.
2004-12-22 14:19:09 +00:00
Brett Cannon 1902146ea1 Remove outdated comments about expanduser and expandvars for Macintosh that
referred to OS 9 semantics.
2004-12-22 05:40:45 +00:00
Fred Drake 7c404a4bf7 add __file__ to the globals available for tests loaded via DocFileSuite;
this is useful for locating supporting data files, just as it is in Python
modules
2004-12-21 23:46:34 +00:00
Johannes Gijsbers f654c1c383 Add accidentally removed \end{description} back in. 2004-12-21 21:14:42 +00:00
Armin Rigo 2ccea17856 Any call to marshal.dumps() with the new optional argument 'version' just
immediately segfaults, due to a typo!  This was obviously never tested...
Added a test for it, and also fixed the documentation.
2004-12-20 12:25:57 +00:00
Raymond Hettinger f964154b8c Bug #1088206: zlib decompressobj documentation typo 2004-12-20 06:08:12 +00:00
Raymond Hettinger da264121f4 Bug #1066607: "Limitations" section of profiler docs is incorrect 2004-12-19 20:31:46 +00:00
Walter Dörwald 3fa932f7ed Fix typo (from SF bug #1086127). 2004-12-15 23:44:18 +00:00
Raymond Hettinger 744aaa02e0 SF bug #1084457: ossaudiodev no longer undocumented 2004-12-14 07:19:22 +00:00
Johannes Gijsbers 537d3fcf93 Check in missing png version of pyfav.gif. 2004-12-13 13:07:59 +00:00
Anthony Baxter 57ee770df1 note for amk 2004-12-13 11:39:33 +00:00
Gregory P. Smith 7af53a6de4 the bsddb module now also works with BerkeleyDB 4.3. 2004-12-13 09:57:32 +00:00
Johannes Gijsbers f4a70f35b0 Patch #1080684: typo repair. Thanks George Yoshida!
- Doc/lib/libbase64.tex
s/algorith/algorithm

- Doc/lib/libpickle.tex
s/interchangable/interchangeable

- Doc/lib/libxmlrpclib.tex
s/{_cmp__}/{__cmp__}

leading underscore needs to be double, not single.

- Doc/ref/ref6.tex
0/1 => False/True
2004-12-12 16:52:40 +00:00
Brett Cannon 222d5b466b Setting textwrap.TextWrapper().expand_tabs to True calls expandtabs, not
expand_tabs, on the object being wrapped.
2004-12-11 09:53:52 +00:00
Raymond Hettinger 8ef9b3e527 SF bug #1082944: Incorrect docs for PyUnicode_TailMatch
* Note correct return type is int.
* Note that -1 returned on failure.
2004-12-10 17:12:32 +00:00
Raymond Hettinger a6b45cc31d Eliminate the deprecated option to return None instead of a tuple of arguments in __reduce__(). 2004-12-07 07:05:57 +00:00
Raymond Hettinger a32d22a509 Remove deprecated xmllib from inclusion in the docs. 2004-12-06 12:29:56 +00:00
Walter Dörwald e208412348 Fix for SF bug #947894: calendar.weekheader() undocumented 2004-12-06 07:58:14 +00:00
Brett Cannon c8aa848ece Have test_mkalias_relative check that sys.prefix already exists; otherwise test
is pointless.

Also add a note to the docs for the 'test' package that test cases should check
first that any conditions needed in the operating system are met before having
a test run.

Closes bug #1077302.  THanks, Ian Holsman.
2004-12-06 06:08:59 +00:00
Peter Astrand 5f5e141589 Changed signature of call function to avoid confusion: this 'args' is not the same as the one to the Popen constructor 2004-12-05 20:15:36 +00:00
Raymond Hettinger b2594050ea Added optional None arguments to itertools.islice(). 2004-12-05 09:25:51 +00:00
Fred Drake d2f70cbe8e remove dependencies that are no longer used for the library reference 2004-12-05 07:00:30 +00:00
Raymond Hettinger 1d542f2446 Remove the deprecated statcache module. 2004-12-05 05:29:51 +00:00
Raymond Hettinger 3489cad30a Removed the deprecated bin parameter from the pickle module. 2004-12-05 05:20:42 +00:00
Raymond Hettinger 1bc82f891c Removed deprecated method arguments from the shelve module. 2004-12-05 03:58:17 +00:00
Raymond Hettinger 6c92d76abc Removed deprecated method from pstats. 2004-12-05 03:28:00 +00:00
Raymond Hettinger f3fa9460de Removed deprecated use_statcache argument. 2004-12-05 01:58:09 +00:00
Raymond Hettinger 784ab76c87 Remove the deprecated whrandom module. 2004-12-04 10:50:51 +00:00
Andrew M. Kuchling 2238fc6b67 Add item 2004-12-03 15:16:40 +00:00
Andrew M. Kuchling 07b28b920e Hyphenate 'one-argument' 2004-12-03 14:59:09 +00:00
Andrew M. Kuchling 1cae3f57e7 AAdd item. (And so it beegins again.) 2004-12-03 14:57:21 +00:00
Andrew M. Kuchling 92e2495af6 Fill in various bits of the template 2004-12-03 13:54:09 +00:00