Benjamin Peterson
7b670624ac
remove docs about delegating to special methods; it does no such thing
2010-07-01 15:07:15 +00:00
Mark Dickinson
4aa5f6f1f2
Issue #1789 : clarify that the 'size' column in struct docs refers to standard size.
2010-06-29 20:09:12 +00:00
Benjamin Peterson
b32248757d
group cStringIO docs under its factory function
2010-06-29 15:18:02 +00:00
Vinay Sajip
86aa90539b
Added information about pickle security and SocketHandler.
2010-06-29 15:13:14 +00:00
Senthil Kumaran
1c919a64ed
Documentation Fix: urllib.urlopen.info uses mimetools.Message, not httplib.HTTPMessage.
2010-06-29 13:28:20 +00:00
Senthil Kumaran
8c996ef458
Documentation correction. urllib2.urlopen.info returns a mimetools.Message instance not HTTPMessage object.
2010-06-28 17:07:40 +00:00
Senthil Kumaran
2af7e6d2d9
Fix issue3428 - Document HTTPMessage class.
2010-06-28 10:54:17 +00:00
Georg Brandl
817d91829f
Use designated syntax for optional grammar element.
2010-06-27 10:49:23 +00:00
Senthil Kumaran
a3e3e36de7
Addressing RDM's review comments on the doc change.
2010-06-16 17:37:32 +00:00
Senthil Kumaran
e55a20525e
Fix Issue8937 - SimpleHTTPServer should contain usage example
2010-06-16 14:55:31 +00:00
Mark Dickinson
526e5eed71
Issue #8469 : Further clarifications and improvements to struct module
...
documentation. Thanks Mads Kiilerich.
2010-06-15 08:33:03 +00:00
Mark Dickinson
8e6c45cfd4
Issue #8469 : Add standard sizes to table in struct documentation; additional
...
clarifications and documentation tweaks.
Backport of revisions 81955-81956 from py3k.
2010-06-12 18:50:34 +00:00
Nick Coghlan
10f08f9599
Backport a fix from Py3k for a potentially misleading example
2010-06-12 13:45:37 +00:00
Georg Brandl
961e6fd37a
Fix gratuitous indentation.
2010-06-12 09:45:58 +00:00
Georg Brandl
ab776cef9d
Document that an existing directory raises in mkdir().
2010-06-12 06:28:58 +00:00
Alexander Belopolsky
094c53cf6e
Fixed markup of tm_isdst attribute.
2010-06-09 17:08:11 +00:00
Benjamin Peterson
11591c3dda
fix sphinx warning with an extra space
2010-06-06 00:54:29 +00:00
Benjamin Peterson
53e812a0ce
remove extra space
2010-06-06 00:50:58 +00:00
Michael Foord
8dde20168a
Documentation updates for issues 8302 and 8351 (truncating excessive diffs in unittest failure messages and reporting SkipTest exceptions in setUpClass and setUpModule as skips rather than errors).
2010-06-05 21:57:03 +00:00
Alexander Belopolsky
3b818bfbfa
Issue #8899 : time.struct_time now has class and atribute docstrings.
2010-06-05 14:54:26 +00:00
Vinay Sajip
998cc24dd4
Issue #8890 : Documentation changed to avoid reference to temporary files - other cases covered.
2010-06-04 13:41:02 +00:00
Vinay Sajip
9a26aabf89
Issue #8890 : Documentation changed to avoid reference to temporary files.
2010-06-03 22:34:42 +00:00
R. David Murray
52dcd45906
#1368247 : make set_charset/MIMEText automatically encode unicode _payload.
...
Fixes (mysterious, to the end user) UnicodeErrors when using utf-8 as
the charset and unicode as the _text argument. Also makes the way in
which unicode gets encoded to quoted printable for other charsets more
sane (it only worked by accident previously). The _payload now is encoded
to the charset.output_charset if it is unicode.
2010-06-02 22:03:15 +00:00
Antoine Pitrou
c395545a4a
Issue #8873 : add a documentation note about possible performance issues with the
...
default of unbuffered IO in subprocess.Popen.
2010-06-02 17:08:47 +00:00
Senthil Kumaran
98bc31f5e0
Fix issue8788 - description of doseq parameter in urllib.urlencode
2010-06-02 02:19:15 +00:00
Georg Brandl
b1a14051b7
Put docs for RegexObject.search() before RegexObject.match() to mirror re.search() and re.match() order.
2010-06-01 07:25:23 +00:00
R. David Murray
ac94f4f716
#7583 : clarify discussion of hard tab expansion in doctests.
2010-06-01 01:42:41 +00:00
Antoine Pitrou
de535cb615
Improve documentation for getaddrinfo() (part of #8857 )
2010-05-31 17:01:01 +00:00
Stefan Krah
3d08d88459
Fix typo
2010-05-29 12:54:35 +00:00
Antoine Pitrou
9fe6199b4e
Issue #8840 : Make documentation for truncate() clearer
2010-05-29 12:06:13 +00:00
Benjamin Peterson
9b14ae8814
2to3 doesn't fix test_support #6583
2010-05-28 03:10:31 +00:00
R. David Murray
172e06e019
Issue 8818: urlparse/urlsplit keyword is 'scheme', not 'default_scheme'.
2010-05-25 15:32:06 +00:00
Georg Brandl
f0757a2937
#8016 : add the CP858 codec (approved by Benjamin). (Also add CP720 to the tests, it was missing there.)
2010-05-24 21:29:07 +00:00
Steven Bethard
74bd9cf7d0
argparse documentation updates (including updates to optparse and getopt documentation that were promised in the PEP)
2010-05-24 02:38:00 +00:00
Georg Brandl
151973e1c8
#1436346 : make it more obvious that timetuple[7] is yday.
2010-05-23 21:29:29 +00:00
Georg Brandl
f93ce0c1f5
#8785 : less confusing description of regex.find*.
2010-05-22 08:17:23 +00:00
Georg Brandl
fa0fdb89e9
#8709 : mention Windows support for os.devnull.
2010-05-21 22:03:29 +00:00
Georg Brandl
042d6a4f75
Correct info for Semaphore.acquire() semantics under OSX.
2010-05-21 21:47:05 +00:00
Georg Brandl
dd59f1bf92
#8707 : remove duplicate paragraph part.
2010-05-21 21:30:47 +00:00
Georg Brandl
233eb54051
Add missing parameter in SimpleXMLRPCServer signature.
2010-05-21 20:58:12 +00:00
Georg Brandl
da69add804
typo
2010-05-21 20:52:46 +00:00
Georg Brandl
16fd5cdfeb
#8783 : replace link to now dead hash collision FAQ.
2010-05-21 20:24:45 +00:00
Vinay Sajip
c76defc118
Updated logging documentation with more dictConfig information.
2010-05-21 17:41:34 +00:00
Benjamin Peterson
a85bd06a82
fix extra 't' #8778
2010-05-20 22:23:37 +00:00
Stefan Krah
4a769059be
Fix typo.
2010-05-19 15:59:40 +00:00
Ezio Melotti
019551fa1b
Fix typo in argparse doc.
2010-05-19 00:32:52 +00:00
Vinay Sajip
a38cd52e96
Fixed minor typo in ReST markup.
2010-05-18 08:16:27 +00:00
Senthil Kumaran
71a632433f
Fix minor typo.
2010-05-18 03:20:43 +00:00
Andrew M. Kuchling
1b553473ed
Add cross-reference to later section
2010-05-16 23:31:16 +00:00
Antoine Pitrou
308c2af9a4
Document that SSL v2 is insecure.
2010-05-16 14:16:56 +00:00
Victor Stinner
8ded477916
Doc: replace PEP xxx by :pep:`xxx` to create a link on the PEP
2010-05-14 14:20:07 +00:00
Andrew M. Kuchling
f09bc66083
#8696 : add documentation for logging.config.dictConfig (PEP 391)
2010-05-12 18:56:48 +00:00
Fred Drake
62bebdf49f
- clarify Attr.name comment on the presence of colons in namespace mode
...
- document Attr.value
- wrap some long lines
2010-05-12 02:24:50 +00:00
Fred Drake
5840469067
fix error introduced in previous commit, and the adjacent additional typo
2010-05-12 01:22:03 +00:00
Brian Curtin
b9bf97132d
#8575 - Update and reorganize some _winreg contents.
...
I've removed the hopeful note about a future higher-level module since
it's been in there for quite a long time and nothing of the sort has
come up. There are a few places where markup was added to cross-reference
other sections, and many of the external links have been removed and now
point to newly created sections containing previously undocumented
information.
The Value Types section was created and it's contents were taken from
a function-specific area, since it applies to more than just that
function. It fits in better with the other newly documented constants.
2010-05-11 19:13:13 +00:00
Fred Drake
8b37dd1613
fix typo
2010-05-11 18:12:27 +00:00
Andrew M. Kuchling
5d864c847e
Fix typo
2010-05-10 23:13:41 +00:00
Georg Brandl
6487952a46
Fix typo.
2010-05-10 21:51:33 +00:00
Georg Brandl
6f635f41f2
Consolidate deprecation messages.
2010-05-10 21:50:57 +00:00
Georg Brandl
0ddc30b7f9
Fix reference direction.
2010-05-10 21:46:50 +00:00
Georg Brandl
c630195784
#8642 : fix wrong function name.
2010-05-10 21:02:51 +00:00
Florent Xicluna
638b869004
Add a link on maketrans().
2010-05-10 19:59:22 +00:00
Eric Smith
368ede83d9
Issue 8671: Whitespace fix.
2010-05-09 14:04:59 +00:00
Mark Dickinson
7000e9e01b
Issue #8644 : Improve accuracy of timedelta.total_seconds method.
...
(Backport of r80979 to py3k.) Thanks Alexander Belopolsky.
2010-05-09 09:30:06 +00:00
Michael Foord
959c16d7a4
Updating documentation and adding docstrings to unittest.TestCase.assertRegexpMatches and assertNotRegexpMatches. Issue 8038.
2010-05-08 16:40:52 +00:00
Michael Foord
8851b71c6f
Documenting test discovery from package name and potential problems with test discovery importing tests from the wrong location. Issue 7780 and issue 8547.
2010-05-08 15:09:37 +00:00
Benjamin Peterson
328e3775df
ensure that availability information is on its own line at the end of the function docs
2010-05-06 22:49:28 +00:00
Benjamin Peterson
7aaef849f9
Availability gets its own line
2010-05-06 22:33:46 +00:00
Andrew M. Kuchling
a14f2d1147
Use anonymous hyperlinks
2010-05-06 13:03:39 +00:00
Andrew M. Kuchling
4758183f0a
Reword paragraph; fix filename, which should be pyconfig.h
2010-05-06 01:09:47 +00:00
Mark Dickinson
9319548e56
Issue 8628: fix incorrect documentation for numbers.Complex.imag.
2010-05-05 21:52:39 +00:00
Ronald Oussoren
9545a23c7f
In a number of places code still revers
...
to "sys.platform == 'mac'" and that is
dead code because it refers to a platform
that is no longer supported (and hasn't been
supported for several releases).
Fixes issue #7908 for the trunk.
2010-05-05 19:09:31 +00:00
Jesus Cea
c3ce9e357d
wbits negative was documented SEVEN years ago
2010-05-03 16:09:21 +00:00
Andrew M. Kuchling
7de14ac034
Minor grammar fix
2010-05-01 12:05:52 +00:00
Andrew M. Kuchling
603831825b
Markup fix; clarify by adding 'in that order'
2010-04-30 01:32:47 +00:00
Andrew M. Kuchling
545336673e
Fix typos
2010-04-30 01:02:15 +00:00
Andrew M. Kuchling
3ded421fd5
Reword paragraph to make its meaning clearer.
...
Antoine Pitrou: is my version of the paragraph still correct?
R. David Murray: is this more understandable than the previous version?
2010-04-30 00:52:31 +00:00
Giampaolo Rodolà
a01f6892d6
Fixes issue 8543 (asynchat documentation issues)
2010-04-29 20:31:17 +00:00
Senthil Kumaran
f62b50f306
Fixing the Broken links of mechanize library.
2010-04-29 19:46:08 +00:00
Ezio Melotti
ab9149dc8a
Group the Windows entries in getfilesystemencoding doc, move the win 9x one at the bottom of the list and fix some markup.
2010-04-29 16:07:20 +00:00
Andrew M. Kuchling
fb759a25f2
Fix doubled 'the'.
...
Markup fixes to use :exc:, :option: in a few places.
(Glitch: unittest.main's -c ends up a link to the Python
interpreter's -c option. Should we skip using :option: for that
switch, or disable the auto-linking somehow?)
2010-04-29 01:44:30 +00:00
Antoine Pitrou
689405ee14
Clarify and fix the documentation for IOBase.close()
2010-04-28 19:57:33 +00:00
Antoine Pitrou
ece349e517
State clearly that truncate() doesn't move the file position,
...
and remove a duplicate of its specification.
2010-04-28 19:53:35 +00:00
Senthil Kumaran
ed9204346e
Fixed Issue6312 - httplib fails with HEAD requests to pages with "transfer-encoding: chunked"
2010-04-28 17:20:43 +00:00
Nick Coghlan
dfb45dfd04
Issue 7490: make IGNORE_EXCEPTION_DETAIL also ignore details of the module containing the exception under test (original patch by Lennart Regebro)
2010-04-28 14:29:06 +00:00
Benjamin Peterson
eef5c35c14
make slice notation in (r)find docs consistent
2010-04-27 22:56:31 +00:00
Benjamin Peterson
a9bd6d5ea7
reject None as the buffering argument like the C implementation does #8546
2010-04-27 21:01:54 +00:00
Michael Foord
47b5440f43
Adding versionadded to various new unittest functions in documentation
2010-04-26 23:36:47 +00:00
Michael Foord
5c322ece96
Adding unittest.removeHandler function / decorator for removing the signal.SIGINT signal handler. With tests and docs.
2010-04-25 19:02:46 +00:00
Georg Brandl
adbcf1f4a8
Patch from Tim Hatch: Make socket setblocking <-> settimeout examples symmetric.
2010-04-25 10:57:15 +00:00
Georg Brandl
1e518258c9
Fix code example to have valid syntax so that it can be highlighted.
2010-04-25 10:56:41 +00:00
Georg Brandl
bb091e733c
Patch from Tim Hatch: Minor spelling changes to _winreg docs.
2010-04-25 10:55:58 +00:00
Georg Brandl
a3f1e4cde7
Patch from Tim Hatch: Remove reference to winreg being the fabled high-level registry interface.
2010-04-25 10:55:16 +00:00
Georg Brandl
9bfb78d698
Patch from Tim Hatch: Better cross-referencing in socket and winreg docs.
2010-04-25 10:54:42 +00:00
Georg Brandl
1f62087649
Remove LaTeXy index entry syntax.
2010-04-25 10:29:17 +00:00
Georg Brandl
404bd7f473
#8528 : fix typo.
2010-04-25 10:16:00 +00:00
Brian Curtin
5fa9fb4062
Fix #5774 . Some _winreg functions are documented as taking kwargs but don't.
2010-04-24 17:10:22 +00:00
Georg Brandl
f8bff488bd
Markup fixes.
2010-04-24 08:56:58 +00:00
Sean Reifscheider
f6ce3cb84e
issue8451: Making syslog module use sys.argv[0] for "ident".
2010-04-23 08:31:55 +00:00
Senthil Kumaran
398246169c
Changed tests to only urlparse one, which was enough, addressed Ezio's comment
...
on Invalid url check statement and versionchanged string in docs.
2010-04-22 12:10:13 +00:00
Senthil Kumaran
0a36181953
Updated the RFCs list in the See Also section of urlparse.rst
2010-04-22 05:48:35 +00:00
Tarek Ziadé
e593fad81b
removed ztar support in shutil.make_archive
2010-04-20 21:09:06 +00:00
Ezio Melotti
8c09ebcf0c
#8472 : fix wrong function name in functions.rst: itertools.filterfalse -> itertools.ifilterfalse
2010-04-20 16:49:48 +00:00
Brian Curtin
1f8dd363b7
Add version info for os.kill and signal changes from #1220212 .
2010-04-20 15:23:18 +00:00
Tarek Ziadé
8a12f940fe
Fixed #8463 : added missing reference to bztar in shutil's documentation.
2010-04-19 21:28:21 +00:00
Antoine Pitrou
0a6373c1a9
Issue #8322 : Add a *ciphers* argument to SSL sockets, so as to change the
...
available cipher list. Helps fix test_ssl with OpenSSL 1.0.0.
2010-04-17 17:10:38 +00:00
Georg Brandl
c9a8a4aab8
#8370 : fix module name in backported doc addition.
2010-04-14 21:36:49 +00:00
Georg Brandl
4a589c3ede
#8399 : add note about Windows and O_BINARY.
2010-04-14 19:16:38 +00:00
Georg Brandl
6c50efe76b
Add an x-ref to where the O_ constants are documented and move the SEEK_ constants after lseek().
2010-04-14 13:50:31 +00:00
Raymond Hettinger
44340e6d78
Add usage notes for collections.Counter().
2010-04-12 21:12:06 +00:00
Mark Dickinson
78ab583d63
More struct doc tweaks.
2010-04-12 20:38:36 +00:00
Mark Dickinson
b633f10f81
Rewrap some long lines in struct module doc source.
2010-04-12 19:46:20 +00:00
Mark Dickinson
bbacb838c9
Issue #7355 : Various improvements to struct module documentation.
...
- note early on that the result of struct.pack includes padding
bytes by default
- add examples showing how order of struct fields can affect size
(due to padding)
- better headers and references; introduction to format strings
- integrate packing notes into table
Many thanks to Meador Inge for the patch.
2010-04-12 19:25:32 +00:00
R. David Murray
1a14d3d169
Issue #7585 : use tab between components in unified and context diff headers.
...
Instead of spaces between the filename and date (or whatever the string
is that follows the filename, if any) use tabs. This is what the unix
'diff' command does, for example, and difflib was intended to follow
the 'standard' way of doing diffs. This improves compatibility with
patch tools. The docs and examples are also changed to recommended that
the date format used be the ISO 8601 format, which is what modern diff
tools emit by default.
Patch by Anatoly Techtonik.
2010-04-12 16:35:19 +00:00
Barry Warsaw
fa900d47b8
typo
2010-04-12 14:40:49 +00:00
Andrew M. Kuchling
884d0a3c27
Two typo fixes
2010-04-11 12:48:08 +00:00
Andrew M. Kuchling
ca2413e2ad
Punctuation fix
2010-04-11 01:40:06 +00:00
Georg Brandl
90aae551b1
#8360 : skipTest was added in 2.7.
2010-04-10 11:15:24 +00:00
Raymond Hettinger
a1d61d0495
Fixup new itertools recipes.
2010-04-10 07:01:32 +00:00
Michael Foord
efc2f497fd
Correction of unittest documentation typos and omissions
2010-04-08 04:33:20 +00:00
Vinay Sajip
497256ba18
Issue #8331 : logging: fixed some grammatical errors in documentation.
2010-04-07 09:40:52 +00:00
Vinay Sajip
ccd8bc8a83
Issue #8327 : logging: Clarification of propagation functionality in documentation.
2010-04-06 22:32:37 +00:00
Mark Dickinson
ad971d62ee
More NaN consistency doc fixes.
2010-04-06 22:18:23 +00:00
Mark Dickinson
e07acb5f15
Use consistent spelling for nans (thanks Georg for noticing).
2010-04-06 22:10:55 +00:00
Mark Dickinson
99e73f9145
Issue #7947 : Clarify math module behaviour for IEEE 754 special cases, along
...
with a number of additional minor edits and typo corrections.
2010-04-06 19:50:03 +00:00
Georg Brandl
abe448c49b
#8320 : document return value of recv_into().
2010-04-06 08:18:15 +00:00
Antoine Pitrou
f9de534c21
Issue #8321 : Give access to OpenSSL version numbers from the `ssl` module,
...
using the new attributes `ssl.OPENSSL_VERSION`, `ssl.OPENSSL_VERSION_INFO`
and `ssl.OPENSSL_VERSION_NUMBER`.
2010-04-05 21:35:07 +00:00
Michael Foord
d341ec82c7
Further documentation fix for unittest.rst
2010-04-05 10:30:14 +00:00
Michael Foord
c5ff3f6ff0
Furterh documentation fix for unittest.rst
2010-04-05 10:28:27 +00:00
Michael Foord
3165503b4a
Documentation fixes for unittest
2010-04-05 10:26:26 +00:00
Ezio Melotti
9ccc58113e
Fix markup errors.
2010-04-05 08:16:41 +00:00
Ezio Melotti
01fa86a0bd
Fix markup, punctuation and whitespaces in _winreg.rst.
2010-04-05 08:02:54 +00:00
Michael Foord
554303530c
Document signal handling functions in unittest.rst
2010-04-05 00:39:50 +00:00
Michael Foord
ddb20df018
Adding documentation for new unittest.main() parameters
2010-04-04 23:28:44 +00:00
Ezio Melotti
6f65d2dd1b
Fix markup in decimal.rst.
2010-04-04 23:21:53 +00:00
Michael Foord
09e2980c15
unittest documentation formatting changes
2010-04-04 22:41:54 +00:00
Mark Dickinson
b1affc517f
Add versionchanged entry for Decimal(float) construction.
...
Also add an example of constructing a Decimal directly from a float,
update the quickstart tutorial, and tweak another couple of
sentences.
2010-04-04 22:09:21 +00:00
Raymond Hettinger
bb006cf26c
Add tests for cmp_to_key.
...
Adopt PEP 8 compliant function name.
Factor-out existing uses cmp_to_key.
Update documentation to use internal pointers instead of external resource.
2010-04-04 21:45:01 +00:00
Raymond Hettinger
a551f31d48
Add functools.CmpToKey()
2010-04-04 18:34:45 +00:00
Raymond Hettinger
0d57caa267
Documentation nit
2010-04-04 07:33:46 +00:00
Ezio Melotti
4edfe96381
Revert 79733 - Counter is new in 2.7, the versionadded is not necessary - and fix a typo.
2010-04-04 06:50:58 +00:00
Ezio Melotti
0cee3794c7
Add a versionadded to Counter.subtract() doc.
2010-04-04 06:41:27 +00:00
Raymond Hettinger
20ae90d887
Issue 5479: Add functools.total_ordering class decorator.
2010-04-04 01:24:59 +00:00
Antoine Pitrou
945d4ccdd9
Fix wording / typography, and a slightly misleading statement
...
(memoryviews don't support complex structures right now)
2010-04-03 21:22:38 +00:00
Raymond Hettinger
5f516edd77
Add count() method to collections.deque().
2010-04-03 18:10:37 +00:00
Michael Foord
ba097ec1be
Documenting new features in unittest
2010-04-03 17:03:11 +00:00
Mark Dickinson
4846a8e828
Issue #8300 : Let struct.pack use __index__ to convert and pack non-integers.
...
Based on a patch by Meador Inge.
2010-04-03 14:05:10 +00:00
Raymond Hettinger
34c35b2788
Add subtract() method to collections.Counter() objects.
2010-04-03 10:22:00 +00:00
Brian Curtin
e5aa886b44
Implement #1220212 . Add os.kill support for Windows.
...
os.kill takes one of two newly added signals, CTRL_C_EVENT and
CTRL_BREAK_EVENT, or any integer value. The events are a special case
which work with subprocess console applications which implement a
special console control handler. Any other value but those two will
cause os.kill to use TerminateProcess, outright killing the process.
This change adds win_console_handler.py, which is a script to implement
SetConsoleCtrlHandler and applicable handler function, using ctypes.
subprocess also gets another attribute which is a necessary flag to
creationflags in Popen in order to send the CTRL events.
2010-04-02 23:26:06 +00:00
Mark Dickinson
7c63eee485
Issue #8294 : Allow float and Decimal arguments in Fraction constructor.
2010-04-02 22:27:36 +00:00