Commit Graph

171 Commits

Author SHA1 Message Date
Georg Brandl 891391bf68 Merge doc fixes. 2011-03-06 11:12:42 +01:00
Georg Brandl a2388be2af #11239: add } to list of metacharacters (it is only a metacharacter sometimes, ie. when closing a {n,m} group, but so is ]. 2011-03-06 11:07:11 +01:00
Vinay Sajip dcc9513c67 Issue #11331: fixed documentation in logging cookbook. 2011-02-26 14:24:29 +00:00
Georg Brandl f6c8fd62b9 Merged revisions 86537,86867-86868,86881,86887,86913-86915,86931-86933,86960,86964,86974,86980,86996,87008,87050 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k

........
  r86537 | georg.brandl | 2010-11-19 23:09:04 +0100 (Fr, 19 Nov 2010) | 1 line

  Do not put a raw REPLACEMENT CHARACTER in the document.
........
  r86867 | georg.brandl | 2010-11-29 15:50:54 +0100 (Mo, 29 Nov 2010) | 1 line

  Fix indentation bug.
........
  r86868 | georg.brandl | 2010-11-29 15:53:15 +0100 (Mo, 29 Nov 2010) | 1 line

  Fix heading style inconsistencies.
........
  r86881 | georg.brandl | 2010-11-30 08:43:28 +0100 (Di, 30 Nov 2010) | 1 line

  #10584: fix bad links.
........
  r86887 | georg.brandl | 2010-11-30 15:57:54 +0100 (Di, 30 Nov 2010) | 1 line

  Fix typo.
........
  r86913 | georg.brandl | 2010-12-01 16:32:43 +0100 (Mi, 01 Dez 2010) | 1 line

  Add missing word, and add a better reference to the actual function.
........
  r86914 | georg.brandl | 2010-12-01 16:36:33 +0100 (Mi, 01 Dez 2010) | 1 line

  #10594: fix parameter names in PyList API docs.
........
  r86915 | georg.brandl | 2010-12-01 16:44:25 +0100 (Mi, 01 Dez 2010) | 1 line

  Fix some markup and style in the unittest docs.
........
  r86931 | georg.brandl | 2010-12-02 10:06:12 +0100 (Do, 02 Dez 2010) | 1 line

  Fix-up documentation of makedirs().
........
  r86932 | david.malcolm | 2010-12-02 17:41:00 +0100 (Do, 02 Dez 2010) | 2 lines

  Fix spelling of Jamie Zawinski's surname in urllib.parse docstring (issue 10606)
........
  r86933 | georg.brandl | 2010-12-02 19:02:01 +0100 (Do, 02 Dez 2010) | 1 line

  #10597: fix Py_SetPythonHome docs by pointing to where the meaning of PYTHONHOME is already documented.
........
  r86960 | georg.brandl | 2010-12-03 08:55:44 +0100 (Fr, 03 Dez 2010) | 1 line

  #10360: catch TypeError in WeakSet.__contains__, just like WeakKeyDictionary does.
........
  r86964 | georg.brandl | 2010-12-03 10:58:38 +0100 (Fr, 03 Dez 2010) | 1 line

  #10549: fix interface of docclass() for text documenter.
........
  r86974 | georg.brandl | 2010-12-03 16:30:09 +0100 (Fr, 03 Dez 2010) | 1 line

  Markup consistency fixes.
........
  r86980 | georg.brandl | 2010-12-03 18:19:27 +0100 (Fr, 03 Dez 2010) | 1 line

  Fix punctuation.
........
  r86996 | georg.brandl | 2010-12-03 20:56:42 +0100 (Fr, 03 Dez 2010) | 1 line

  Fix indentation.
........
  r87008 | georg.brandl | 2010-12-04 10:04:04 +0100 (Sa, 04 Dez 2010) | 1 line

  Fix typo.
........
  r87050 | georg.brandl | 2010-12-04 18:09:30 +0100 (Sa, 04 Dez 2010) | 1 line

  Fix typo.
........
2011-02-25 09:48:21 +00:00
Brett Cannon 6277fa4f7d Update the porting HOWTO to be a little less harsh on using 2to3.
Patch reviewed by Raymond Hettinger, permission from Georg Brandl to commit
during an RC.
2011-02-18 01:34:28 +00:00
Georg Brandl 829befb9e3 Fix markup error and update suspicious ignores. 2011-02-13 09:59:39 +00:00
Brett Cannon a2f154459a Tweak wording about equality comparison. 2011-02-09 22:55:13 +00:00
Georg Brandl 7a0afd3f07 Spelling fixes. 2011-02-07 15:44:27 +00:00
Georg Brandl 2cb2fa9796 Consistent heading spacing, and fix two typos. 2011-02-07 15:30:45 +00:00
Eli Bendersky 7ac3419a6c Fix some typos and grammar 2011-02-07 04:44:19 +00:00
Eli Bendersky 2d062de1d8 Fix some typos and grammar
[commit during RC with Brett's approval]
2011-02-07 04:19:57 +00:00
Raymond Hettinger 810cd3479f Small markup and wording tweaks for the sorting-howto. 2011-02-06 06:11:29 +00:00
Brett Cannon 98135d07e7 Mention that people going the source compatibility route should run 2to3 to find pain points. 2011-02-05 22:22:47 +00:00
Brett Cannon 45aa7cc7a7 Soften wording on doctest. 2011-02-05 22:16:40 +00:00
Brett Cannon ce71ab2d69 Re-arrange and clarify some __future__ import statements.
The absolute_import statement got moved to a new Python 2.5 and Newer section
as it was available since then. The division statement got moved to Common
Gotchas since it has been around for so long that any modern Python program can
use it.
2011-02-05 22:05:05 +00:00
Éric Araujo 5405a0b3d3 Use an internal reference instead of hard-coded URI. 2011-02-05 16:03:12 +00:00
Antoine Pitrou bd866e972c Everybody hates this one :) (bytes indexing) 2011-02-05 12:13:38 +00:00
Antoine Pitrou e6a1464b89 Soften the wording about tracebacks. Reference cycles *don't*
prevent garbage collection! (fortunately)
2011-02-05 12:01:07 +00:00
Antoine Pitrou 5c28cfdc0c Fix entries pertaining to file I/O 2011-02-05 11:53:39 +00:00
Antoine Pitrou 8d8f7c5e01 Mention -b and -bb 2011-02-05 11:40:05 +00:00
Brett Cannon 4b0c24a3ae use 3-space indents. 2011-02-03 22:14:58 +00:00
Brett Cannon 8045d97819 Add a HOWTO on how to port from Python 2 to Python 3. 2011-02-03 22:01:54 +00:00
Georg Brandl 375aec2315 Fix a few doc errors, mostly undefined keywords. 2011-01-15 17:03:02 +00:00
Benjamin Peterson 6e1d0a829d Merged revisions 87949 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r87949 | benjamin.peterson | 2011-01-11 22:44:41 -0600 (Tue, 11 Jan 2011) | 1 line

  fix weirdly ambigious sentence
........
2011-01-12 04:51:02 +00:00
Benjamin Peterson 1efb8dc871 fix weirdly ambigious sentence 2011-01-12 04:44:41 +00:00
Raymond Hettinger b436b6cabc Revert r87946. The virtues of readability and of examples that
can be cut and pasted are more important than having a doctests
on examples that already work.
2011-01-12 01:16:57 +00:00
Terry Reedy fdf2925452 Issue #10225: Correct interactive Doc/howto/sorting.rst examples so doctest runs.
Based on part of A. Belopolsky's patch.
2011-01-11 23:05:50 +00:00
Terry Reedy 23f4fb9a96 Issue #10875: Update Regular Expression HOWTO; additional backport. 2011-01-10 23:16:24 +00:00
Terry Reedy 262cc7f6b6 Issue #10875: Update Regular Expression HOWTO; last bit. 2011-01-10 23:13:21 +00:00
Terry Reedy 8663e346dc Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'. 2011-01-10 21:49:11 +00:00
Terry Reedy aacfd4a0cf Issue #10875: Update Regular Expression HOWTO; patch by 'SilentGhost'. 2011-01-10 21:27:49 +00:00
Vinay Sajip 2427ab9d6f logging HOWTO: fixed markup for numbered handler list. 2011-01-04 13:58:49 +00:00
Vinay Sajip 7d10129369 Added logging documentation cross-references. 2010-12-26 21:22:33 +00:00
Vinay Sajip e6f1e435d4 Improved logging cookbook for logging with multiprocessing. 2010-12-26 18:47:51 +00:00
Vinay Sajip 1397ce1821 Logging documentation updates. 2010-12-24 12:03:48 +00:00
Vinay Sajip 689b68ad2d Logging documentation updates. 2010-12-22 15:04:15 +00:00
Vinay Sajip c63619bcf2 Logging documentation reorganised. 2010-12-19 12:56:57 +00:00
Georg Brandl ab32fec83c Merged revisions 85572-85573,85606,85609-85622,85624,85626-85627,85629,85631,85633,85635-85636,85638-85639,85641-85642 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k

........
  r85572 | georg.brandl | 2010-10-16 20:51:05 +0200 (Sa, 16 Okt 2010) | 1 line

  #10122: typo fix.
........
  r85573 | georg.brandl | 2010-10-16 20:53:08 +0200 (Sa, 16 Okt 2010) | 1 line

  #10124: typo fix.
........
  r85606 | georg.brandl | 2010-10-17 08:32:59 +0200 (So, 17 Okt 2010) | 1 line

  #10058: tweak wording about exception returns.
........
  r85609 | georg.brandl | 2010-10-17 11:19:03 +0200 (So, 17 Okt 2010) | 1 line

  #8556: use less confusing mapping key in example.
........
  r85610 | georg.brandl | 2010-10-17 11:23:05 +0200 (So, 17 Okt 2010) | 1 line

  #8686: remove potentially confusing wording that does not add any value.
........
  r85611 | georg.brandl | 2010-10-17 11:33:24 +0200 (So, 17 Okt 2010) | 1 line

  #8811: small fixes to sqlite3 docs.
........
  r85612 | georg.brandl | 2010-10-17 11:37:54 +0200 (So, 17 Okt 2010) | 1 line

  #8855: add shelve security warning.
........
  r85613 | georg.brandl | 2010-10-17 11:43:35 +0200 (So, 17 Okt 2010) | 1 line

  Fix hmac docs: it takes and returns bytes, except for hexdigest().
........
  r85614 | georg.brandl | 2010-10-17 11:46:11 +0200 (So, 17 Okt 2010) | 1 line

  #8968: add actual name of token constants.
........
  r85615 | georg.brandl | 2010-10-17 12:05:13 +0200 (So, 17 Okt 2010) | 1 line

  #459007: merge info from PC/getpathp.c and using/windows.rst to document the forming of sys.path under Windows.
........
  r85616 | georg.brandl | 2010-10-17 12:07:29 +0200 (So, 17 Okt 2010) | 1 line

  Fix copy-paste error in example.
........
  r85617 | georg.brandl | 2010-10-17 12:09:06 +0200 (So, 17 Okt 2010) | 1 line

  #5212: md5 weaknesses do not affect hmac, so remove the note about that.
........
  r85618 | georg.brandl | 2010-10-17 12:14:38 +0200 (So, 17 Okt 2010) | 1 line

  #9086: correct wrong terminology about linking with pythonXY.dll.
........
  r85619 | georg.brandl | 2010-10-17 12:15:50 +0200 (So, 17 Okt 2010) | 1 line

  Make file names consistent.
........
  r85620 | georg.brandl | 2010-10-17 12:22:28 +0200 (So, 17 Okt 2010) | 1 line

  Remove second parser module example; it referred to non-readily-available example files, and this kind of discovery is much better done with the AST nowadays anyway.
........
  r85621 | georg.brandl | 2010-10-17 12:24:54 +0200 (So, 17 Okt 2010) | 1 line

  #9105: move pickle warning to a bit more prominent location.
........
  r85622 | georg.brandl | 2010-10-17 12:28:04 +0200 (So, 17 Okt 2010) | 1 line

  #9112: document error() and exit() methods of ArgumentParser.
........
  r85624 | georg.brandl | 2010-10-17 12:34:28 +0200 (So, 17 Okt 2010) | 1 line

  Some markup and style fixes in argparse docs.
........
  r85626 | georg.brandl | 2010-10-17 12:38:20 +0200 (So, 17 Okt 2010) | 1 line

  #9117: fix syntax for class definition.
........
  r85627 | georg.brandl | 2010-10-17 12:44:11 +0200 (So, 17 Okt 2010) | 1 line

  #9138: reword introduction to classes in Python.
........
  r85629 | georg.brandl | 2010-10-17 12:51:45 +0200 (So, 17 Okt 2010) | 1 line

  #5962: clarify sys.exit() vs. threads.
........
  r85631 | georg.brandl | 2010-10-17 12:53:54 +0200 (So, 17 Okt 2010) | 1 line

  Fix capitalization.
........
  r85633 | georg.brandl | 2010-10-17 12:59:41 +0200 (So, 17 Okt 2010) | 1 line

  #9204: remove mentions of removed types in the types module.
........
  r85635 | georg.brandl | 2010-10-17 13:03:22 +0200 (So, 17 Okt 2010) | 1 line

  #5121: fix claims about default values leading to segfaults.
........
  r85636 | georg.brandl | 2010-10-17 13:06:14 +0200 (So, 17 Okt 2010) | 1 line

  #9237: document sys.call_tracing().
........
  r85638 | georg.brandl | 2010-10-17 13:13:37 +0200 (So, 17 Okt 2010) | 1 line

  Port changes to pickle docs apparently lost in py3k.
........
  r85639 | georg.brandl | 2010-10-17 13:23:56 +0200 (So, 17 Okt 2010) | 1 line

  Make twisted example a bit more logical.
........
  r85641 | georg.brandl | 2010-10-17 13:29:07 +0200 (So, 17 Okt 2010) | 1 line

  Fix documentation of dis.opmap direction.
........
  r85642 | georg.brandl | 2010-10-17 13:36:28 +0200 (So, 17 Okt 2010) | 1 line

  #9730: fix example.
........
2010-11-26 08:49:15 +00:00
Georg Brandl c8c60c2284 Do not put a raw REPLACEMENT CHARACTER in the document. 2010-11-19 22:09:04 +00:00
Alexander Belopolsky 93a6b13f96 Issue #4153: Updated Unicode HOWTO. 2010-11-19 16:09:58 +00:00
Ezio Melotti 4fdf0fe5b7 Merged revisions 86488 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r86488 | ezio.melotti | 2010-11-16 22:57:59 +0200 (Tue, 16 Nov 2010) | 1 line

  Fix typo
........
2010-11-16 21:06:43 +00:00
Ezio Melotti 42dd524cff Fix typo 2010-11-16 20:57:59 +00:00
Georg Brandl eae40ba6f7 Merged revisions 86187 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k

........
  r86187 | georg.brandl | 2010-11-05 07:10:41 +0000 (Fr, 05 Nov 2010) | 1 line

  Move glossary entry to the right position and fix link.
........
2010-11-05 07:11:47 +00:00
Georg Brandl c275e15489 Move glossary entry to the right position and fix link. 2010-11-05 07:10:41 +00:00
Raymond Hettinger c6b6b5bf5a Issue 7402: Improve reduce() example in the python idioms how-to. 2010-10-31 22:01:57 +00:00
Raymond Hettinger 099cfed120 Issue 7402: Improve reduce() example in the python idioms how-to. 2010-10-31 22:00:50 +00:00
Georg Brandl 573caa3476 #10124: typo fix. 2010-10-16 18:53:08 +00:00
Georg Brandl 1f7fffb308 #2830: add html.escape() helper and move cgi.escape() uses in the standard library to it. It defaults to quote=True and also escapes single quotes, which makes casual use safer. The cgi.escape() interface is not touched, but emits a (silent) PendingDeprecationWarning. 2010-10-15 15:57:45 +00:00
Georg Brandl 682d7e0e07 Fix errors found by "make suspicious". 2010-10-06 10:26:05 +00:00
Georg Brandl 60203b41b0 Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00