Commit Graph

12328 Commits

Author SHA1 Message Date
Georg Brandl f354f8e369 Closes #14306: clarify expensiveness of try-except and update code snippet 2012-03-17 16:58:05 +01:00
Senthil Kumaran e3d73544ad explain json.dumps for non-string keys in dicts. closes issue6566. Patch contributed Kirubakaran Athmanathan 2012-03-17 00:37:38 -07:00
R David Murray bee24df3a7 #11780: s/throw/raise/ 2012-03-16 22:11:22 -04:00
R David Murray 0cc4e53d1d #11780: document that email.encoders throw TypeError on multipart messages. 2012-03-16 22:06:08 -04:00
R David Murray 32a3b147b2 #12758: removing confusing mention of UTC from time.time description
Patch by Dylan Sarber.
2012-03-15 03:05:01 -04:00
Georg Brandl f590e0458e Closes #14289: put a link to the CHM download page on the docs download page. 2012-03-14 08:18:47 +01:00
Senthil Kumaran c768d4caa8 closes issue14257 - Grammatical fix 2012-03-12 10:05:04 -07:00
Senthil Kumaran 814d316888 closes issue14257 minor error in glossary wording regarding __hash__ 2012-03-11 21:04:05 -07:00
Senthil Kumaran 15b6f3f825 Fix closes issue14258 - added clarification to \W and \S flags 2012-03-11 20:37:39 -07:00
Mark Dickinson 5081957642 Closes #9574: Note that complex constructor doesn't allow whitespace around central operator. 2012-03-10 16:09:35 +00:00
Jason R. Coombs d6a80ee2c7 Use PEP-8 style in logging example 2012-03-07 10:24:04 -05:00
Éric Araujo d2e19b5173 Move xml.etree higher and xml.parsers.expat lower in the markup ToC.
I assume that most users looking at this page are looking for a library
to process XML, not a low-level parser.  First proposed in #11379.
2012-03-05 16:44:49 +01:00
Éric Araujo 76c6aa860c Use source reST role instead of file where it makes sense.
source generates a nifty link to the Mercurial web viewer.
2012-03-05 16:43:41 +01:00
Éric Araujo 47546e6e3d Remove mention of defunct file.
Misc/COPYRIGHT was renamed twelve years ago to LICENSE and later copied
to the main docs, to which there is already a link.
2012-03-05 16:30:46 +01:00
Georg Brandl 21ccb7318d Fix link to global module index. 2012-03-03 21:25:42 +01:00
Eli Bendersky 2b65408dec Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases 2012-03-02 07:45:55 +02:00
Petri Lehtinen a15a8d2a0c sqlite3: Port relevant documentation changes from 3.2
Initial patch by Johannes Vogel. Issue #13491.
2012-03-01 21:48:30 +02:00
Ezio Melotti d9de93eb67 #14155: remove duplication about search vs match in re doc. 2012-02-29 13:37:07 +02:00
Ezio Melotti 38ae5b2392 #10713: Improve documentation for \b and \B and add a few tests. Initial patch and tests by Martin Pool. 2012-02-29 11:40:00 +02:00
Larry Hastings 0555cde98d Issue #13086: Update howto/cporting.rst to discuss "Python 3" instead of "3.0". 2012-02-28 15:17:23 -08:00
Éric Araujo 92904d3a4a Branch merge 2012-02-26 03:48:36 +01:00
Éric Araujo 6d37c4e388 Add versionadded for sys.flags.hash_randomization variable 2012-02-26 02:03:39 +01:00
Éric Araujo 060b812a4b Fix markup errors 2012-02-26 02:00:35 +01:00
Éric Araujo a358bc3ca2 State explicitely that PYTHONDONTWRITEBYTECODE is equivalent to -B 2012-02-26 01:38:26 +01:00
Éric Araujo a318a3b2fb Avoid relying on the default reST role in logging library doc 2012-02-26 01:36:31 +01:00
Éric Araujo c446ce78b8 Document that shutil.make_archive does not typecheck its logger argument 2012-02-26 01:33:49 +01:00
Éric Araujo d4e714c746 Fix typo (#13467) 2012-02-26 01:29:09 +01:00
Éric Araujo c8e29dba91 Mark up constants in socket doc as such 2012-02-26 01:25:11 +01:00
Éric Araujo 576c6d7ee1 Hide or remove user-visible XXX notes from distutils doc (#13716).
Requested by Florent Xicluna with the rationale that they make the docs
look unfinished.  When I get to replace the XXX notes with the real info
for packaging, I’ll backport it.

Also removed a few XXX notes that were not visible in the HTML but could
waste contributors’ time by suggesting improvements that are never going
to happen for distutils.
2012-02-26 01:21:31 +01:00
Éric Araujo c3cc2acb09 Improve interlinking of archiving/compression modules docs.
- Remove duplicate list of links to the other modules from each
  module’s doc (people can already go up to library/archiving and
  there they can see the list).

- Link to shutil high-level operations.

Reviewed by Nadeem Vawda in #6715.
2012-02-26 01:10:14 +01:00
Sandro Tosi 8b48c66ebd Issue #13999: refer to multiprocessing.Queue when needed 2012-02-25 19:35:16 +01:00
Ezio Melotti f5ea48fd3b #14114: don't include copybutton.js in the htmlhelp output. 2012-02-25 19:24:24 +02:00
Georg Brandl 66e565ee48 merge with 2.6 2012-02-21 22:38:31 +01:00
Georg Brandl 3aec568e6e Remove reST markup from --help output. Also: O(n**2) is dict construction, not single insertion. 2012-02-21 22:36:27 +01:00
Benjamin Peterson aee9dfba4a merge 2.6 with hash randomization fix 2012-02-20 21:44:56 -05:00
Barry Warsaw 1e13eb084f - Issue #13703: oCERT-2011-003: add -R command-line option and PYTHONHASHSEED
environment variable, to provide an opt-in way to protect against denial of
  service attacks due to hash collisions within the dict and set types.  Patch
  by David Malcolm, based on work by Victor Stinner.
2012-02-20 20:42:21 -05:00
Vinay Sajip 7d13cd3f5d logging: clarified documentation for Handler.handleError. 2012-02-20 18:34:07 +00:00
Éric Araujo bb42f5ed7f Add missing “::” markup and wrap overlong lines 2012-02-20 02:08:01 +01:00
Sandro Tosi 09c05fde63 don't split 'Hye-Shik Chang' name; thanks to Sergey from docs@ 2012-02-19 12:29:43 +01:00
Sandro Tosi 8d38fcf5a9 Refer to 'time' and 'datetime' submodules; thanks to Erik Johnson from docs@
This is needed after the move to Sphinx 1.x and it's the same way 3.x braches
managed it.
2012-02-18 20:28:35 +01:00
Ezio Melotti c39b552603 #14020: improve HTMLParser documentation. 2012-02-18 01:46:04 +02:00
Petri Lehtinen 002b202009 Fix errors in sqlite3's Cursor.rowcount documentation
Closes #13995.
2012-02-16 21:42:34 +02:00
Sandro Tosi c0b1172459 Issue #11836: document multiprocessing.queues.SimpleQueue 2012-02-15 22:39:52 +01:00
Éric Araujo d9756beb87 Improve doc for atexit.register (#12297) 2012-02-15 17:08:34 +01:00
Senthil Kumaran ef18737b7f shutil copy module reference doc fix. 2012-02-13 23:17:45 +08:00
Gregory P. Smith 12426998ce Issue #13930: Adds ability for 2to3 to write its output to a different
directory tree instead of overwriting the input files.  Adds three command
line options: -o/--output-dir, -W/--write-unchanged-files and --add-suffix.

Feature backports into stable release branches for 2to3 are allowed by
a special exemption:
 http://mail.python.org/pipermail/python-dev/2011-December/115089.html
2012-02-12 15:51:21 -08:00
Éric Araujo 46652326be Update mention of Subversion repo in the FAQ 2012-02-12 04:54:43 +01:00
Éric Araujo 4ad7f7f31a distutils 2.7’s Extension does not support optional (#13865).
Reported by Miki Tebeka.
2012-02-10 05:31:28 +01:00
Senthil Kumaran 59e7c8f177 Issue #9021: Add an introduction to the copy module. Doc changes suggested by Terry Reedy. 2012-02-09 18:22:01 +08:00
Senthil Kumaran 607e31eddf Fix Issue #6005: Examples in the socket library documentation use sendall,
where relevant, instead send method. Patch contributed by Brian Brazil.
2012-02-09 17:43:31 +08:00
Nadeem Vawda d15c5a869d Clarify note in BZ2File docs about lack of multi-stream support (issue #1625). 2012-02-05 14:27:01 +02:00
Georg Brandl 922ae2c931 Closes #13944: fix capitalization of class name. 2012-02-05 09:25:22 +01:00
Nadeem Vawda acd51f9ea9 Issue #1625: Document BZ2File's lack of support for multi-stream inputs. 2012-02-04 23:43:25 +02:00
Petri Lehtinen fe6f9d0edc Document absoluteness of sys.executable
Closes #13402.
2012-02-02 21:26:05 +02:00
Raymond Hettinger 65de77ed9e Clean-up docs for input() 2012-02-02 00:52:33 -08:00
Raymond Hettinger 6d837a3769 Add pure python equivalent code for reduce(). 2012-02-02 00:48:46 -08:00
Raymond Hettinger c5f310c827 Clarify the note for UserList 2012-02-01 19:00:09 -08:00
Raymond Hettinger 1d23199791 Use validate SQL in the example (this was confusing to readers) 2012-02-01 13:41:11 -08:00
Raymond Hettinger 81a55c01b8 Show the import in the sqlite3 example 2012-02-01 13:32:45 -08:00
Brian Curtin 3c8807bd5e merge. 2012-02-01 15:22:50 -06:00
Brian Curtin b4bef305fd merge from fb225c289bf0 2012-02-01 15:17:39 -06:00
Raymond Hettinger 6ab9813605 Use xrange in the example 2012-02-01 08:55:21 -08:00
Raymond Hettinger 9f55b63060 fix whitespace 2012-02-01 08:54:14 -08:00
Raymond Hettinger bdb7fe4c84 Add a usage note 2012-02-01 08:52:44 -08:00
Georg Brandl 1d8e6fd45e Fix #13900: resolve self-referential description of a parameter. 2012-01-29 15:38:47 +01:00
Benjamin Peterson 78028b0589 note that get() is not affected by default_factory (closes #13887) 2012-01-27 09:14:01 -05:00
Brett Cannon 64b2b6a84d Issue #13883: Document all platforms PYTHONCASEOK works on. 2012-01-26 18:32:24 -05:00
Benjamin Peterson 0a15103d79 merge heads 2012-01-25 16:43:54 -05:00
Benjamin Peterson dcd37e8154 forgot to resolve this conflict... 2012-01-25 16:43:26 -05:00
Georg Brandl e9401a0476 #13852: some small doc fixes. 2012-01-25 22:36:25 +01:00
Benjamin Peterson af90a40445 kill extra word 2012-01-25 16:30:18 -05:00
Benjamin Peterson bcd6f3994c say bitwise (because I have no idea what a bit-string is) 2012-01-25 16:29:03 -05:00
Georg Brandl dfdc46f274 #13816: fix two minor style issues. Thanks to Justin Wehnes for the patch. 2012-01-23 20:19:33 +01:00
Antoine Pitrou 8fc732f088 Issue #12922: fix the TextIOBase documentation to include a description of seek() and tell() methods. 2012-01-21 20:27:59 +01:00
Ezio Melotti 51ab3519d8 Move a space. 2012-01-21 16:40:03 +02:00
Sandro Tosi 2d71e5c6b9 fix typo; thanks to Justin Watt from docs@ 2012-01-21 10:59:12 +01:00
Georg Brandl 27a4918c99 Fix conf.py for Sphinx 1.0. 2012-01-21 08:58:22 +01:00
Terry Jan Reedy 0bb1251e1a whitespace 2012-01-21 00:32:23 -05:00
Terry Jan Reedy 96a0a46353 Issue13820 as and with really became keywords in 2.6.
Original rewording by Jim Jewett
2012-01-21 00:24:25 -05:00
Sandro Tosi cb21227407 Issue #13605: more meaningful example + fixes 2012-01-19 22:22:35 +01:00
Sandro Tosi 10f047dca8 Issue #13605: add documentation for nargs=argparse.REMAINDER 2012-01-19 21:59:34 +01:00
Sandro Tosi d53abd3154 Issue #11948: clarify modules search path 2012-01-19 11:28:15 +01:00
Meador Inge da747c3d97 Issue #2134: Clarify token.OP handling rationale in tokenize documentation. 2012-01-19 00:17:44 -06:00
Sandro Tosi 25e76bdb69 file.next() doc refers to itself 2012-01-17 18:57:30 +01:00
Sandro Tosi 03c6110b21 revert part of cefe4f38fa0e, as agreed with Éric 2012-01-17 18:32:02 +01:00
Sandro Tosi 6008a8b5ba Issue: #12409: remove obsolete susp-entries 2012-01-16 18:01:55 +01:00
Ezio Melotti 8eab1fdc8b #13715: fix typo in unicodedata doc. Patch by Eli Collins. 2012-01-16 08:42:32 +02:00
Ezio Melotti 055d70d588 #13695: fix a couple of typos in the doc. 2012-01-16 08:21:24 +02:00
Sandro Tosi bde7eacd85 fix typo; thanks to Jan Heidbrink from docs@ 2012-01-15 16:34:29 +01:00
Sandro Tosi 7d77c6f6e0 remove 'Documenting Python' and its references, it's now on devguide 2012-01-14 22:22:54 +01:00
Georg Brandl c86bb00ee5 Fix label names. 2012-01-14 17:06:53 +01:00
Sandro Tosi 9a5606886c how could I have missed :cmember: in import.rst? 2012-01-14 16:51:16 +01:00
Sandro Tosi a76bb03c55 None is not a keyword, link file.next() to functions.html#next 2012-01-14 16:43:14 +01:00
Sandro Tosi d6e87f43d6 update part of sphinxext 2012-01-14 16:42:21 +01:00
Sandro Tosi 98ed08f24e update to new C roles and directives 2012-01-14 16:42:02 +01:00
Sandro Tosi bbd41d0874 update Sphinx reference from 0.6.7 to 1.0.7 2012-01-14 16:41:26 +01:00
Terry Jan Reedy 150122a5a2 #11633 about buffering of print 2012-01-14 00:06:37 -05:00
Terry Jan Reedy 4ba76b68b9 closes #13730 2012-01-13 23:41:31 -05:00
Antoine Pitrou 2d047e85b7 Merge 2012-01-12 08:09:15 +01:00
Antoine Pitrou d716c73d03 Issue #13724: improve documentation for socket.create_connection. 2012-01-12 08:06:19 +01:00
Terry Jan Reedy 477a06c142 Minor correction. Closes #11418 2012-01-11 14:51:07 -05:00
Terry Jan Reedy 1d79eb6abe Closes #13754 String returned if less than *or equal to* x 3 2012-01-11 03:19:28 -05:00
Senthil Kumaran 8070ddcd9b port to 2.7 - Issue9637 - Details that case of Proxy env var does not matter. 2012-01-11 01:35:02 +08:00
Raymond Hettinger a0ff91cac0 Fix stock symbol for Microsoft 2012-01-10 09:51:51 +00:00
Raymond Hettinger c766b31dbc Update the sorting howto to reflect the PEP 8 advisory to define all six rich comparisons. 2012-01-10 07:55:17 +00:00
Antoine Pitrou df4c986f9e Issue #13747: fix SSL compatibility table. 2012-01-09 21:43:18 +01:00
Antoine Pitrou 4a7e0c896c Issue #13747: fix documentation error about the default SSL version. 2012-01-09 21:35:11 +01:00
Sandro Tosi e5f93ef268 Py_SetPythonHome() can be called before Py_Initialize(); thanks to Cody Smith from docs@ 2012-01-07 18:32:06 +01:00
Sandro Tosi f788cf70f8 clarify recv* are blocking operations; thanks to Chris Kogelnik from docs@ 2012-01-07 17:56:43 +01:00
Raymond Hettinger 36cdca1277 Clarify that vars() doesn't place extra restrictions on __dict__. 2012-01-05 23:23:52 -08:00
Sandro Tosi 24f207e99e Issue #12042: a queue is only used to retrive results; preliminary patch by Jordan Stadler 2012-01-05 19:48:30 +01:00
Sandro Tosi 7f418f67a8 Issue #11984: remove reference to parser, it's not showing symbol usage anymore 2012-01-05 19:05:44 +01:00
Sandro Tosi 8b211fc123 Issue #10772: add count and help argparse action; patch by Marc Sibson 2012-01-04 23:24:48 +01:00
Sandro Tosi 499718de49 Issue #6031: improve serve_forever() description 2012-01-03 22:35:41 +01:00
Sandro Tosi 711f54798c Issue #9349: add argparse.SUPPRESS to help doc 2012-01-03 18:31:51 +01:00
Sandro Tosi 8448dfa17d Issue #13302: backport part of 3ed28f28466f 2012-01-01 23:41:44 +01:00
Sandro Tosi e827c13566 Issue #13690: add re.DEBUG; patch by Filip Gruszczyński 2012-01-01 12:52:24 +01:00
Benjamin Peterson 5f8d60647b add another year to glorious PSF IP 2011-12-31 22:42:26 -06:00
Sandro Tosi 117e1f00a8 fix some broken URLs 2011-12-31 18:13:59 +01:00
Eli Bendersky 4b76f8a76c Some formatting & grammar fixes for the multiprocessing doc 2011-12-31 07:05:12 +02:00
Benjamin Peterson c016f46df5 use booleans 2011-12-30 13:47:25 -06:00
Georg Brandl 2c9eee1af9 I do not think we will ever have auto-indent at the prompt, that is for IPython and the like. 2011-12-25 19:03:07 +01:00
Sandro Tosi 44585bd347 fix "Title underline too short" sphinx warning 2011-12-25 17:13:10 +01:00
Sandro Tosi a4d06e7bc8 use double-quote char instead of unicode ones; thanks to tomo cocoa from docs@ 2011-12-25 17:05:30 +01:00
Sandro Tosi 4526273d7f fix to sent/send typo 2011-12-25 11:43:37 +01:00
Sandro Tosi dbcbd101e7 fix Constuctor/Constructor typo; thanks to Anthon van der Neut from docs@ 2011-12-25 11:27:22 +01:00
Sandro Tosi 238612a003 point IronPython to ironpython.net; thanks to Lazar Pancic from docs@ 2011-12-24 23:13:08 +01:00
Sandro Tosi ec53eb817a fix Rather that/Rather than; thanks to Reuben Thomas from docs@ 2011-12-24 19:55:49 +01:00
Sandro Tosi 4fbad84cb6 remove spurious dot from string formatting example; thanks to Anthon van der Neut from docs@ 2011-12-24 15:52:36 +01:00
Sandro Tosi 55ae12b019 correct syslog.openlog() argument name to logoption; thanks to Arnaud Gomes-do-Vale from docs@ 2011-12-24 14:51:26 +01:00
Senthil Kumaran 17fbe402d4 porting mimetype doc changes from 3.2.
Issue12798 - Update mimetypes documentation. Correct the doc section where
common_types was mentioned under MimeTypes class, move it to helper function
category and other documentation improvements contributed by Sandro Tosi.
2011-12-23 11:08:31 +08:00
Senthil Kumaran a9091d2611 Issue13443 - Remove the functional module examples from 2.7 (as module is
maintained only till 2.5 and tests had failures with 2.7) and update the links
int the howto document.
2011-12-22 23:44:53 +08:00
Benjamin Peterson 587c7381c7 note the blinding speed of these functions 2011-12-20 10:12:41 -06:00
Benjamin Peterson 5879ca1fd9 don't mention implementation detail 2011-12-19 16:41:11 -05:00
Ezio Melotti 2d679a42bf s/:c:type:/:ctype:/g 2011-12-19 07:17:08 +02:00
Ezio Melotti d0ffcd601e #3932: suggest passing unicode to HTMLParser.feed(). 2011-12-19 07:15:26 +02:00
Ezio Melotti 080b6f071f #13387: rephrase unclear sentence. 2011-12-19 07:04:48 +02:00
Victor Stinner 28a545e234 Issue #13617: Document that the result PyUnicode_AsUnicode() and
PyUnicode_AsWideChar() may contain embedded null characters.

Patch written by Arnaud Calmettes.
2011-12-18 19:39:53 +01:00
Victor Stinner cc1a0865f1 Issue #13522: Fix _Py_co_pow() documentation
Patch written by Arnaud Calmettes.
2011-12-18 02:56:18 +01:00
Antoine Pitrou c9e180043c Issue #13522: document error return values of some float and complex C API functions. 2011-12-18 01:25:27 +01:00
Ezio Melotti 13c82d00c4 #13613: fix example in re doc. 2011-12-17 01:17:17 +02:00
Ezio Melotti 05a7f0dcac #6570: clarify tutorial section about keyword arguments. 2011-12-13 15:49:22 +02:00
Ezio Melotti 4a72d1a661 #13549: improve tutorial section about listcomps. 2011-12-13 14:50:21 +02:00
Antoine Pitrou 22da68b1b0 Issue #13527: remove mention of Python megawidgets and Tkinter3000 WCK
from the doc. These two projects appear dead.
2011-12-04 23:56:30 +01:00
Meador Inge 5295718399 Issue #13513: IOBase docs incorrectly link to the readline module 2011-12-03 12:13:42 -06:00
Ezio Melotti 2692be9d20 #13494: s/cast/convert/. Also add a link. 2011-12-02 19:47:24 +02:00
Ezio Melotti c2ed44f4f2 #13499: fix example adding >>> before the comments. 2011-12-02 19:26:48 +02:00
Vinay Sajip da75dd2a9b Added a configuration dictionary example to the logging cookbook. 2011-11-23 14:27:11 +00:00
Vinay Sajip 3639807a79 Closes #13459: Clarified documentation on Logger.propagate. Thanks to Mike Fogel for the patch. 2011-11-23 08:51:35 +00:00
Raymond Hettinger 421467f8f0 Note the store_true and store_false also create the appropriate defaults. 2011-11-20 11:05:23 -08:00