Commit Graph

557 Commits

Author SHA1 Message Date
Vinay Sajip ab960f838c Fixed typo in documentation. 2014-06-25 07:30:46 +01:00
Zachary Ware 0aecc18bab Fix typo reported by Jesse W on docs@ 2014-06-16 11:13:01 -05:00
Senthil Kumaran e9738239ba #21693 - Fix the broken link for pylons project. 2014-06-11 06:19:21 -07:00
Vinay Sajip e81c637bf8 Updated logging HOWTO section on optimization. 2014-06-02 00:30:48 +01:00
Benjamin Peterson 419f1fa9bc fix typo in variable name (closes #21586) 2014-05-26 15:10:42 -07:00
Raymond Hettinger ae4bab71e3 Don't grow strings by concatenation. Use ''.join() instead. 2014-05-18 21:02:25 +01:00
Benjamin Peterson 9e599673b4 fix off-by-one error (closes #21330) 2014-04-22 21:54:10 -04:00
Andrew Svetlov 08af00047b Get rid of deprecated IOError in the doc 2014-04-01 01:13:30 +03:00
Raymond Hettinger 4ab532bbfe Issue 21014: Use booleans instead of 0 and 1 in examples. 2014-03-28 16:39:25 -07:00
Vinay Sajip 4908910ab7 Updated external link in documentation. 2014-03-25 11:21:41 +00:00
Larry Hastings 3732ed2414 Merge in all documentation changes since branching 3.4.0rc1. 2014-03-15 21:13:56 -07:00
Benjamin Peterson bfca3ca114 fix typo (closes #20892) 2014-03-11 13:59:37 -05:00
Brett Cannon c39e892955 Issue #20813: Backport Python 2/3 HOWTO updates 2014-03-07 12:28:35 -05:00
Vinay Sajip d591cba9cf Merged documentation update from 3.3. 2014-02-03 11:52:24 +00:00
Vinay Sajip 554f22ff1d Added cookbook entry on logging filter configuration using dictConfig(). 2014-02-03 11:51:45 +00:00
Larry Hastings 7726ac9163 #Issue 20456: Several improvements and bugfixes for Argument Clinic,
including correctly generating code for Clinic blocks inside C
preprocessor conditional blocks.
2014-01-31 22:03:12 -08:00
Larry Hastings 0e25410319 Documentation fixes, including fixing "suspicious" problems. 2014-01-26 00:42:02 -08:00
Ezio Melotti a3642b67ca #20348: fix headers markup in Argument Clinic howto. Patch by Moritz Neeb. 2014-01-25 17:27:46 +02:00
Larry Hastings 42d9e1b9f3 Doc fixes for Argument Clinic. 2014-01-22 05:49:11 -08:00
Larry Hastings b7ccb20423 Issue #20294: Argument Clinic now supports argument parsing for __new__ and
__init__ functions.
2014-01-18 23:50:21 -08:00
Larry Hastings 537d760766 Doc improvements for Clinic howto "Goals" section. 2014-01-18 01:08:50 -08:00
Larry Hastings bebf73511a Issue #20287: Argument Clinic's output is now configurable, allowing
delaying its output or even redirecting it to a separate file.
2014-01-17 17:47:17 -08:00
Vinay Sajip 5714e815c9 Merged documentation update from 3.3. 2014-01-17 18:36:41 +00:00
Vinay Sajip eb14deca15 Added example to recently added cookbook entry. 2014-01-17 18:36:02 +00:00
Brett Cannon f0996a9970 Issue #20208: Clarify some things in the Python porting HOWTO.
Thanks to Rodrigo Bernardo Pimentel, Ondřej Čertík, and Dmitry
Shachnev for the feedback leading to the changes.
2014-01-17 11:45:01 -05:00
Larry Hastings 2a727916c5 Issue #20226: Major improvements to Argument Clinic.
* You may now specify an expression as the default value for a
  parameter!  Example: "sys.maxsize - 1".  This support is
  intentionally quite limited; you may only use values that
  can be represented as static C values.
* Removed "doc_default", simplified support for "c_default"
  and "py_default".  (I'm not sure we still even need
  "py_default", but I'm leaving it in for now in case a
  use presents itself.)
* Parameter lines support a trailing '\\' as a line
  continuation character, allowing you to break up long lines.
* The argument parsing code generated when supporting optional
  groups now uses PyTuple_GET_SIZE instead of PyTuple_GetSize,
  leading to a 850% speedup in parsing.  (Just kidding, this
  is an unmeasurable difference.)
* A bugfix for the recent regression where the generated
  prototype from pydoc for builtins would be littered with
  unreadable "=<object ...>"" default values for parameters
  that had no default value.
* Converted some asserts into proper failure messages.
* Many doc improvements and fixes.
2014-01-16 11:32:01 -08:00
Vinay Sajip 3763f2bc07 Merged documentation update from 3.3. 2014-01-15 15:09:43 +00:00
Vinay Sajip cbefe3b9a0 Added cookbook entry on alternative formatting styles. 2014-01-15 15:09:05 +00:00
Larry Hastings 4a714d48ad Issue #20268: Argument Clinic now supports cloning the parameters
and return converter from existing functions.
2014-01-14 22:22:41 -08:00
Larry Hastings 0191be3899 Minor doc fix in Clinic howto. 2014-01-12 13:57:36 -08:00
Larry Hastings 4a55fc5a9d Issue #20214: Fixed a number of small issues and documentation errors in
Argument Clinic (see issue for details).
2014-01-12 11:09:57 -08:00
Zachary Ware c1cb227b3f Closes #20200: Argument Clinic custom converter example should be in a
'python' clinic block, not a 'clinic' clinic block.  Patch written by
Ryan Smith-Roberts.
2014-01-09 21:41:23 -06:00
Larry Hastings 61272b77b0 Issue #19273: The marker comments Argument Clinic uses have been changed
to improve readability.
2014-01-07 12:41:53 -08:00
Larry Hastings 77561cccb2 Issue #20141: Improved Argument Clinic's support for the PyArg_Parse "O!"
format unit.
2014-01-07 12:13:13 -08:00
Brett Cannon 9ca21b3e1d Issue #20096: Update the Python 2/3 porting HOWTO to focus on
source-compatibility instead of 2to3.
2014-01-07 11:52:04 -05:00
Larry Hastings 6d2ea21337 Argument Clinic: fixed test suite, improved howto. 2014-01-05 02:50:45 -08:00
Larry Hastings 78cf85c669 Issue #19659: Added documentation for Argument Clinic. 2014-01-04 12:44:57 -08:00
Serhiy Storchaka f47036c130 Removed spaces before colons and semicolons. 2013-12-24 11:04:36 +02:00
Serhiy Storchaka 89e84e7523 Removed spaces before colons and semicolons. 2013-12-24 11:05:24 +02:00
Serhiy Storchaka 2a6145290b Removed spaces before commas and periods. 2013-12-23 18:21:57 +02:00
Serhiy Storchaka a4d170d985 Removed spaces before commas and periods. 2013-12-23 18:20:51 +02:00
Vinay Sajip 1b8b868b84 Merged minor documentation update from 3.3. 2013-12-06 11:23:08 +00:00
Vinay Sajip b1a92a4c89 Added minor clarification in logging HOWTO. 2013-12-06 11:22:24 +00:00
Serhiy Storchaka 0e90e99188 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:19:53 +02:00
Serhiy Storchaka fbc1c26803 Issue #19795: Improved markup of True/False constants. 2013-11-29 12:17:13 +02:00
Ezio Melotti 613a97e193 #19778: fix a couple of re reprs in the documentation. 2013-11-25 22:47:01 +02:00
Ezio Melotti 7571941db6 #19639: update the repr of the match objects in the docs. Patch by Claudiu Popa. 2013-11-23 20:27:27 +02:00
Vinay Sajip 9c10d6b800 Issue #19504: Used American spelling for 'customize'. 2013-11-15 20:58:13 +00:00
Vinay Sajip 56b04352f8 Issue #19504: Used American spelling for 'customize'. 2013-11-15 20:58:47 +00:00
Vinay Sajip b2bc4df40c Closes #18345: Merged documentation update from 3.3. 2013-11-05 10:03:20 +00:00
Vinay Sajip 2c1adcb62b Issue #18345: Added cookbook example illustrating handler customisation. 2013-11-05 10:02:21 +00:00
Georg Brandl 3a19a89eac merge with 3.3 2013-10-29 08:17:08 +01:00
Georg Brandl 3d596fa90b Clarify sentence. 2013-10-29 08:16:56 +01:00
Georg Brandl 325a1c2f37 Fix markup errors in the docs and amend suspicious ignores. 2013-10-27 09:16:01 +01:00
Georg Brandl 186729e812 merge with 3.3 2013-10-27 09:54:53 +01:00
Benjamin Peterson 559ae0fb1c merge 3.3 2013-10-18 12:58:17 -04:00
Benjamin Peterson 910a66566a fix description of super() behavior on descriptors 2013-10-18 12:57:55 -04:00
Serhiy Storchaka 98b28fddd8 Issue #18758: Fixed and improved cross-references. 2013-10-13 23:12:09 +03:00
Serhiy Storchaka bfdcd436f0 Issue #18758: Fixed and improved cross-references. 2013-10-13 23:09:14 +03:00
Serhiy Storchaka 287da2e0b9 Issue #19203: Improved cross-references in the curses howto. 2013-10-13 19:24:30 +03:00
Serhiy Storchaka 04d11a73fa Issue #19203: Improved cross-references in the curses howto. 2013-10-13 18:51:59 +03:00
Georg Brandl 3ebbb04af2 merge with 3.3 2013-10-08 21:54:47 +02:00
Georg Brandl ee82d0b293 Minor grammar fix. 2013-10-08 21:54:37 +02:00
Georg Brandl 736295c347 merge with 3.3 2013-10-06 13:07:14 +02:00
Georg Brandl e47e184c4a Unicode howto: use .txt as a more universally understood extension for text files. 2013-10-06 13:07:10 +02:00
Georg Brandl 98c0665007 merge with 3.3 2013-10-06 10:04:49 +02:00
Georg Brandl dbab26a8c9 curses HOWTO: fix some PEP8 and a code example to actually raise the exception it promises. 2013-10-06 10:04:21 +02:00
Vinay Sajip 5421f35d5e logging: added support for Unix domain sockets to SocketHandler and DatagramHandler. 2013-09-27 18:18:28 +01:00
Andrew Kuchling 46aace343f Merge from 3.3 2013-08-18 18:58:27 -04:00
Andrew Kuchling 3f4f3ba1a8 #18562: various revisions to the regex howto for 3.x
* describe how \w is different when used in bytes and Unicode patterns.

* describe re.ASCII flag to change that behaviour.

* remove personal references ('I generally prefer...')

* add some more links to the re module in the library reference

* various small edits and re-wording.
2013-08-18 18:57:22 -04:00
Vinay Sajip 07b16615bc Issue #18759: Merged updates from 3.3. 2013-08-17 00:40:38 +01:00
Vinay Sajip 67f39777fa Issue #18759: Improved cross-references in logging documentation. 2013-08-17 00:39:42 +01:00
R David Murray bd2a757010 Merge #15130: remove repeat of abstract paragraph from socket howto body. 2013-07-25 13:24:40 -04:00
R David Murray b76b1b1ec8 #15130: remove repeat of abstract paragraph from socket howto body.
Patch by Tshepang Lekhonkhobe.
2013-07-25 13:24:15 -04:00
Vinay Sajip aca61703fa Closes #18541: merged update from 3.3. 2013-07-24 17:52:58 +01:00
Vinay Sajip a92fbe6dce Issue #18541: simplified LoggerAdapter example. 2013-07-24 17:52:01 +01:00
Ned Deily d57b268653 Closes #18452: fix several "occurrence" typos (reported by Févry Thibault). 2013-07-14 12:45:18 -07:00
Ned Deily 0995c47891 Issue #18452: fix several "occurrence" typos (reported by Févry Thibault). 2013-07-14 12:43:16 -07:00
Andrew Kuchling 7aed567f2b Merge from 3.3 2013-06-20 09:51:51 -04:00
Andrew Kuchling 2151fc6416 #4153: update Unicode howto for Python 3.3
* state that python3 source encoding is UTF-8, and give examples

* mention surrogateescape in the 'tips and tricks' section, and
  backslashreplace in the "Python's Unicode Support" section.

* Describe Unicode support provided by the re module.

* link to Nick Coghlan's and Ned Batchelder's notes/presentations.

* default filesystem encoding is now UTF-8, not ascii.

* Describe StreamRecoder class.

* update acks section

* remove usage of "I think", "I'm not going to", etc.

* various edits

* remove revision history and original outline
2013-06-20 09:29:09 -04:00
Andrew Kuchling 2a9c8e8cd3 #17955: minor updates to Functional howto
* Describe compress() and accumulate()
* Add a subsection on combinatoric functions.
* Add a forward link to skip the theoretical discussion in the first section.
* Clarify what filterfalse() is the opposite of.
* Remove the old outline and some notes at the end.
* Various small edits.
2013-05-20 10:14:53 -04:00
Andrew Kuchling 40e39fc8b8 #17700: merge with 3.3 2013-05-09 20:14:01 -04:00
Andrew Kuchling ddcb30440d #17700: update the curses HOWTO for 3.x 2013-05-09 20:05:20 -04:00
R David Murray 775ccdf1fc #7152: Remove incorrectly added reference to DataHandler. 2013-04-28 17:06:01 -04:00
R David Murray d4c1b36c39 Merge: Reflow paragraphs.
(I got a merge conflict on this in urllib.request.rst, which makes no sense to
me.  Hopefully I didn't screw up the previous 3.3 commit.)
2013-04-28 11:30:19 -04:00
R David Murray 9330a94467 Reflow paragraphs.
I know one of them looks worse, but now it is <80 chars and
matches the 2.7 text.
2013-04-28 11:24:35 -04:00
R David Murray 876f08e3ae Merge #7152: Clarify that ProxyHandler is added only if proxy settings are detected.
Behavior confirmation and initial patch by Jessica McKellar.
2013-04-28 11:08:27 -04:00
R David Murray 5aea37ad1d #7152: Clarify that ProxyHandler is added only if proxy settings are detected.
Behavior confirmation and initial patch by Jessica McKellar.
2013-04-28 11:07:16 -04:00
Ezio Melotti cbe19e56ea #17729: merge with 3.3. 2013-04-23 09:58:04 +03:00
Ezio Melotti d638381ee0 #17729: remove the Advocacy HOWTO from the index. 2013-04-23 09:56:30 +03:00
Ezio Melotti 99b3caf514 #17729: merge with 3.3. 2013-04-23 09:25:45 +03:00
Ezio Melotti 8bdcaf794a #17729: remove the outdated Advocacy HOWTO, as suggested by the author. 2013-04-23 09:24:51 +03:00
Georg Brandl 1e6a3a2fe9 merge with 3.3 2013-04-14 10:59:17 +02:00
Georg Brandl a204636b91 bind('') does not do the same as bind('localhost') 2013-04-14 10:59:04 +02:00
Andrew Svetlov c53fd51278 Change wording as Eli Bendersky suggests. 2013-04-06 18:55:31 +03:00
Andrew Svetlov e16f4dc80a Change wording as Eli Bendersky suggests. 2013-04-06 18:55:07 +03:00
Georg Brandl 98297f4807 merge with 3.3 2013-04-06 16:47:34 +02:00
Georg Brandl 2fd4abe6a1 merge with 3.2 branch 2013-04-06 16:39:49 +02:00
Andrew Svetlov a5b89c178b Fix typo 2013-04-05 11:40:01 +03:00
Andrew Svetlov e463b668e8 Fix typo 2013-04-05 11:39:50 +03:00