Commit Graph

166 Commits

Author SHA1 Message Date
Georg Brandl 78f11edf3f Merged revisions 85530,85534,85538,85540-85542 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r85530 | georg.brandl | 2010-10-15 17:32:05 +0200 (Fr, 15 Okt 2010) | 1 line

  Refrain from using inline suites.
........
  r85534 | georg.brandl | 2010-10-15 18:19:43 +0200 (Fr, 15 Okt 2010) | 1 line

  #9801: document how list and dict proxies created by Managers behave w.r.t. mutable items.
........
  r85538 | georg.brandl | 2010-10-15 18:35:46 +0200 (Fr, 15 Okt 2010) | 1 line

  #7303: add documentation for useful pkgutil functions and classes.
........
  r85540 | georg.brandl | 2010-10-15 18:42:37 +0200 (Fr, 15 Okt 2010) | 1 line

  #6798: fix wrong docs for the arguments to several trace events.
........
  r85541 | georg.brandl | 2010-10-15 18:53:24 +0200 (Fr, 15 Okt 2010) | 1 line

  #4968: updates to inspect.is* function docs.
........
  r85542 | georg.brandl | 2010-10-15 19:01:15 +0200 (Fr, 15 Okt 2010) | 1 line

  #7790: move table of struct_time members to the actual description of struct_time.
........
2010-11-26 07:34:20 +00:00
Senthil Kumaran bf02429c43 Merged revisions 86310 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r86310 | senthil.kumaran | 2010-11-08 09:53:13 +0800 (Mon, 08 Nov 2010) | 3 lines

  Fix Issue 10303: a small clarification in the tutorial.
........
2010-11-08 02:12:57 +00:00
Georg Brandl fc3901e5bf Clarify. 2010-11-05 07:38:48 +00:00
Georg Brandl 44c3ceb8ac #8267: Use sorted() to get a sorted list of dict keys. 2010-10-15 15:31:09 +00:00
Mark Dickinson 33e5935b53 More tweaks to floating-point section of the tutorial. 2010-08-04 21:44:47 +00:00
Georg Brandl 7d4bfb338d Merged revisions 83536,83546-83548,83550,83554-83555,83558,83563,83565,83571,83574-83575 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r83536 | georg.brandl | 2010-08-02 19:49:25 +0200 (Mo, 02 Aug 2010) | 1 line

  #8578: mention danger of not incref'ing weak referenced object.
........
  r83546 | georg.brandl | 2010-08-02 21:16:34 +0200 (Mo, 02 Aug 2010) | 1 line

  #7973: Fix distutils options spelling.
........
  r83547 | georg.brandl | 2010-08-02 21:19:26 +0200 (Mo, 02 Aug 2010) | 1 line

  #7386: add example that shows that trailing path separators are stripped.
........
  r83548 | georg.brandl | 2010-08-02 21:23:34 +0200 (Mo, 02 Aug 2010) | 1 line

  #8172: how does one use a property?
........
  r83550 | georg.brandl | 2010-08-02 21:32:43 +0200 (Mo, 02 Aug 2010) | 1 line

  #9451: strengthen warning about __*__ special name usage.
........
  r83554 | georg.brandl | 2010-08-02 21:43:05 +0200 (Mo, 02 Aug 2010) | 1 line

  #7280: note about nasmw.exe.
........
  r83555 | georg.brandl | 2010-08-02 21:44:48 +0200 (Mo, 02 Aug 2010) | 1 line

  #8861: remove unused variable.
........
  r83558 | georg.brandl | 2010-08-02 22:05:19 +0200 (Mo, 02 Aug 2010) | 1 line

  #8648: document UTF-7 codec functions.
........
  r83563 | georg.brandl | 2010-08-02 22:21:21 +0200 (Mo, 02 Aug 2010) | 1 line

  #9037: add example how to raise custom exceptions from C code.
........
  r83565 | georg.brandl | 2010-08-02 22:27:20 +0200 (Mo, 02 Aug 2010) | 1 line

  #9111: document that do_help() looks at docstrings.
........
  r83571 | georg.brandl | 2010-08-02 22:44:34 +0200 (Mo, 02 Aug 2010) | 1 line

  Clarify that abs() is not a namespace.
........
  r83574 | georg.brandl | 2010-08-02 22:47:56 +0200 (Mo, 02 Aug 2010) | 1 line

  #6867: epoll.register() returns None.
........
  r83575 | georg.brandl | 2010-08-02 22:52:10 +0200 (Mo, 02 Aug 2010) | 1 line

  #9238: zipfile does handle archive comments.
........
2010-08-02 21:44:25 +00:00
Georg Brandl 2c10840e2c Merged revisions 82965 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r82965 | georg.brandl | 2010-07-19 13:28:05 +0200 (Mo, 19 Jul 2010) | 1 line

  Clarification.  Yay importlib!
........
2010-08-01 21:28:47 +00:00
Mark Dickinson d5d3256cac Update the floating-point section of the tutorial for the short float repr. 2010-07-30 12:58:44 +00:00
Georg Brandl 565569b8dc Confusing punctuation. 2010-06-27 10:47:47 +00:00
Georg Brandl b20ada08bd Fix punctuation. 2010-06-12 06:26:54 +00:00
Georg Brandl 9352f1c64e #8346: update version. 2010-04-10 11:16:59 +00:00
Ezio Melotti eb72991fbb Revert r79179 and merge r75584 to explain how to implement a queue using collection.deque instead of a list. 2010-03-31 07:26:24 +00:00
Georg Brandl a39f2afe9b Mention inefficiency of lists as queues, add link to collections.deque discussion. 2010-03-21 09:37:54 +00:00
Georg Brandl 0fcd882101 Introduce copy by slicing, used in later chapters. 2010-03-21 09:17:41 +00:00
Steven Bethard e9330e7941 Initial commit of the argparse library, based on argparse 1.1.
Docs still need some updating to make getopt and optparse match the wording promised in the PEP.
There are also probably a number of :class:ArgumentParser etc. links that could be added to the argparse documentation.
2010-03-02 08:38:09 +00:00
Ezio Melotti 062d2b52f3 #7388: "python".capitalize() in the Doc 2009-12-19 22:41:49 +00:00
Mark Dickinson 6b87f117ca Fix some documentation examples involving the repr of a float. 2009-11-24 14:27:02 +00:00
Mark Dickinson f058d2dc08 Issue #7369: Fibonacci series should start at 0 in tutorial example. 2009-11-23 16:39:05 +00:00
Ezio Melotti c4cd6d3765 fix highlight in the datetime example 2009-11-12 09:10:02 +00:00
Georg Brandl 07de4fc978 Add proper references. 2009-10-22 16:17:05 +00:00
Georg Brandl 4d94d31b6d #6936: for interactive use, quit() is just fine. 2009-09-18 07:22:41 +00:00
Ezio Melotti 2e85f503b1 #6879 - fix misstatement about exceptions 2009-09-16 13:14:05 +00:00
Georg Brandl 49bb9b7f0a #6880: add reference to classes section in exceptions section, which comes earlier. 2009-09-16 09:23:04 +00:00
Michael Foord ee2df03009 Tutorial tweaks. Issue 6849. 2009-09-13 17:07:46 +00:00
Michael Foord 60931a5a58 Change to tutorial wording for reading text / binary files on Windows. Issue #6301. 2009-09-13 16:13:36 +00:00
Georg Brandl 7d4f8fda49 #6777: dont discourage usage of Exception.args or promote usage of Exception.message. 2009-09-04 11:32:18 +00:00
Georg Brandl bf58d80123 #6828: fix wrongly highlighted blocks. 2009-09-03 07:27:26 +00:00
Georg Brandl a88fd7603b #6808: clarification. 2009-09-01 07:46:26 +00:00
Georg Brandl 254c17c758 #6813: better documentation for numberless string formats. 2009-09-01 07:40:54 +00:00
Georg Brandl 0cfbd65975 #6725: spell "namespace" consistently. 2009-08-24 17:20:40 +00:00
Georg Brandl aa66a968d4 Remove potentially confusing sentence in __mangling description. 2009-08-13 12:57:25 +00:00
Georg Brandl fb69631af7 Use locale.format_string() for more than one specifier. 2009-08-13 12:05:52 +00:00
Georg Brandl 4938fefce8 Rewrite the section about classes a bit; mostly tidbits, and a larger update to the section about "private" variables to reflect the Pythonic consensus better. 2009-07-29 17:50:25 +00:00
Georg Brandl 14bb28aa62 Fix a few markup glitches. 2009-07-29 17:15:20 +00:00
Georg Brandl ffefd5a8bb Fix some markup and small factual glitches found by M. Markert. 2009-07-29 17:07:21 +00:00
Georg Brandl 07e20f8729 Add a link to readline, and mention IPython and bpython. 2009-07-29 16:57:05 +00:00
Georg Brandl e2d2704017 #6564: fix section about the two raise syntaxes. 2009-07-24 20:09:46 +00:00
Georg Brandl a1a4bdb30c #6505: fix typos. 2009-07-18 09:06:31 +00:00
Mark Dickinson 11c4941b54 More Decimal quote fixing; backport of r73642 2009-06-28 21:48:15 +00:00
Georg Brandl e3b9b5e4ed #6204: use a real reference instead of "see later". 2009-06-06 17:51:31 +00:00
Georg Brandl 4c324b9801 #6211: elaborate a bit on ways to call the function. 2009-06-06 17:50:05 +00:00
Georg Brandl 7be493a86c Use preferred form of raising exceptions. 2009-05-30 07:31:25 +00:00
Georg Brandl 5a8d7eb7f1 Use raise X(y). 2009-05-22 07:23:32 +00:00
Georg Brandl 5e88eea994 part of #4144: fix exception message in console session. 2009-05-17 08:10:27 +00:00
Antoine Pitrou 789be0c0a0 Issue #2396: backport the memoryview object. 2009-04-02 21:18:34 +00:00
Georg Brandl a08867d8a1 Dont shout to users. 2009-03-31 23:01:27 +00:00
Georg Brandl 354e4cbb1c #5018: remove confusing paragraph. 2009-03-31 22:40:16 +00:00
Georg Brandl 186188d89d #1530012: move TQS section before raw strings. 2009-03-31 20:56:32 +00:00
Georg Brandl a0eea590c7 Add section numbering to some of the larger subdocuments. 2009-03-28 19:57:36 +00:00
Mark Dickinson 3e4caeb3bf Issue #5341: Fix a variety of spelling errors. 2009-02-21 20:27:01 +00:00
Benjamin Peterson a7b55a33f8 revert r69777 since all the experts agree that extra import lines distract from the code 2009-02-20 03:31:23 +00:00
Jeroen Ruigrok van der Werven 5149742e8b Since we recommend one module per import line, reflect this also in the
documentation.
2009-02-19 18:52:21 +00:00
David Goodger a528dc507c markup fix 2009-01-31 22:53:46 +00:00
Georg Brandl 7044b11818 Remove tabs from the documentation. 2009-01-03 21:04:55 +00:00
Georg Brandl c62ef8b4d9 Remove trailing whitespace. 2009-01-03 20:55:06 +00:00
Georg Brandl fc29f27c16 #4811: fix markup glitches (mostly remains of the conversion),
found by Gabriel Genellina.
2009-01-02 20:25:14 +00:00
Benjamin Peterson 42d19e6a2c pretend exceptions don't exist a while longer 2008-12-24 16:10:05 +00:00
Georg Brandl 34196c851a Add reference to enumerate() to indices example. 2008-12-04 18:54:05 +00:00
Andrew M. Kuchling fcdc80bfd2 Fix grammar error; reword two paragraphs 2008-11-06 19:23:02 +00:00
Georg Brandl a8bb5506a6 #4247: add "pass" examples to tutorial. 2008-11-06 18:49:15 +00:00
Georg Brandl c8fd1bc4db Fix typo. 2008-09-16 10:17:45 +00:00
Georg Brandl 9af9498c6e Remove things specific to the old Macintosh, and spell "Mac OS X" consistently. 2008-09-13 17:41:16 +00:00
Benjamin Peterson f2a2c796e3 remove duplicate target 2008-09-13 17:31:08 +00:00
Georg Brandl 3ce0dee9a3 Incorporate some suggestions by Tait Stevens. 2008-09-13 17:18:11 +00:00
Andrew M. Kuchling 54bdbadf76 Use title case 2008-09-13 02:14:15 +00:00
Georg Brandl b04d4853a7 Remove mention of backquotes in the tutorial. 2008-08-08 15:34:34 +00:00
Benjamin Peterson 80790287ab revert last revision; code was right 2008-08-02 03:05:11 +00:00
Benjamin Peterson 1af6fb5298 fix indentation that caused logic bug 2008-08-02 02:57:17 +00:00
Georg Brandl 4b99e9b479 Shorten some overlong lines. 2008-07-26 22:13:29 +00:00
Georg Brandl be44991baa nonlocal is not in 2.6. 2008-07-21 18:26:21 +00:00
Georg Brandl a66bb0a741 #3388: add a paragraph about using "with" for file objects. 2008-07-16 23:35:54 +00:00
Benjamin Peterson 90f36730e2 fix various doc typos #3320 2008-07-12 20:16:19 +00:00
Georg Brandl c5a235bb55 Better quote with single quotes. 2008-05-30 19:17:29 +00:00
Benjamin Peterson dee01d8af8 fix spelling 2008-05-28 11:51:41 +00:00
Benjamin Peterson a436878419 update tutorial function with more appropiate one from Eric Smith 2008-05-28 01:12:35 +00:00
Benjamin Peterson f9ef9881d7 update the tutorial to use str.format 2008-05-26 00:54:22 +00:00
Georg Brandl a6168f9e0a Queue renaming reversal part 3: move module into place and
change imports and other references. Closes #2925.
2008-05-25 07:20:14 +00:00
Brett Cannon 2ee0e8eaec Revert the renaming of repr to reprlib. 2008-05-23 05:03:59 +00:00
Alexandre Vassalotti 50a1acb2ab Changed references to the reprlib module to use its new name. 2008-05-16 06:58:49 +00:00
Georg Brandl 7a148c2357 Fix-up docs for socketserver and queue renaming. 2008-05-12 10:03:16 +00:00
Georg Brandl 605a0c6f7f reload() takes the module itself. 2008-05-11 07:02:17 +00:00
Georg Brandl 68fd63ba9a Add a note about using reload(). 2008-05-09 06:39:58 +00:00
Andrew M. Kuchling 8c65b1ed78 Typo fix 2008-04-15 13:10:41 +00:00
Andrew M. Kuchling 3822af6d3a Add *,**,@ to index, as suggested by
http://farmdev.com/thoughts/24/what-does-the-def-star-variable-or-def-asterisk-parameter-syntax-do-in-python-/

The right entry type to use isn't clear; operator seems wrong, because *,**,@
aren't being used in expressions here.  I put them as 'statement'; 'syntax'
might be better.
2008-04-15 13:10:07 +00:00
Georg Brandl 751a0362aa Don't offend snake lovers. 2008-04-12 19:05:37 +00:00
Georg Brandl 8ca6c84b6f Phase out has_key usage in the tutorial; correct docs for PyMapping_HasKey*. 2008-03-28 12:22:12 +00:00
Georg Brandl 9c6c47bf4b Mark the descitems in the tutorial as "noindex" so that :meth: cross-refs don't link to them. 2008-03-21 14:32:33 +00:00
Georg Brandl 0267781742 Fix lots of broken links in the docs, found by Sphinx' external link checker. 2008-03-15 00:20:19 +00:00
Georg Brandl 6c45dc12b3 Add isinstance/issubclass to tutorial. 2008-03-06 07:31:34 +00:00
Georg Brandl 26bab5f92a Little clarification of assignments. 2008-03-06 07:22:09 +00:00
Georg Brandl db9ff5f565 It's 2.6 now. 2008-03-02 06:28:16 +00:00
Georg Brandl 3ef2063ec8 #2194: fix some typos. 2008-02-26 19:13:45 +00:00
Georg Brandl 4e37c66262 Don't reference pyshell. 2008-02-22 12:56:34 +00:00
Raymond Hettinger 7d5fbaee42 Demonstrate new except/as syntax. 2008-01-30 00:51:58 +00:00
Georg Brandl 2a7d991c6c Clarify "b" mode under Unix. 2008-01-26 14:02:38 +00:00
Gregory P. Smith 7b7ce7854c Fix issue1789: The tutorial contained a misuse of the struct module.
(also remove an unneeded import struct from test_largefile)
2008-01-24 09:38:26 +00:00
Georg Brandl aa0de3f130 #997912: acknowledge nested scopes in tutorial. 2008-01-21 16:51:51 +00:00
Georg Brandl 23bf837a37 Add blurb about executable scripts on Windows. #760657. 2008-01-20 19:40:58 +00:00
Georg Brandl 35f8861386 Add tutorial section about coding style. 2008-01-06 22:05:40 +00:00
Georg Brandl b19be571e0 Some cleanup in the docs. 2007-12-29 10:57:00 +00:00