142 Commits

Author	SHA1	Message	Date
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	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	262cc7f6b6	Issue #10875: Update Regular Expression HOWTO; last bit.	2011-01-10 23:13:21 +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	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	42dd524cff	Fix typo	2010-11-16 20:57:59 +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	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
Georg Brandl	6faee4e2ce	#9911: doc copyedits.	2010-09-21 14:48:28 +00:00
R. David Murray	44ef7749dc	#9608, #8518 : clarify and improve discussion of exceptions in howto.	2010-09-11 18:12:25 +00:00
Raymond Hettinger	53c58f8bcc	Forward port sorting howto	2010-09-01 09:15:42 +00:00
Georg Brandl	7cb1319688	Terminology fix: exceptions are raised, except in generator.throw().	2010-08-03 12:06:29 +00:00
Benjamin Peterson	d7c3ed54ef	Merged revisions 80605-80609,80642-80646,80651-80652,80674,80684-80686,80748,80852,80854,80870,80872-80873,80907,80915-80916,80951-80952,80976-80977,80985,81038-81040,81042,81053,81070,81104-81105,81114,81125,81245,81285,81402,81463,81516,81562-81563,81567,81593,81635,81680-81681,81684,81801,81888,81931-81933,81939-81942,81963,81984,81991,82120,82188,82264-82267 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r80605 | andrew.kuchling | 2010-04-28 19:22:16 -0500 (Wed, 28 Apr 2010) | 1 line Add various items ........ r80606 | andrew.kuchling | 2010-04-28 20:44:30 -0500 (Wed, 28 Apr 2010) | 6 lines 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?) ........ r80607 | andrew.kuchling | 2010-04-28 20:45:41 -0500 (Wed, 28 Apr 2010) | 1 line Add various unittest items ........ r80608 | benjamin.peterson | 2010-04-28 22:18:05 -0500 (Wed, 28 Apr 2010) | 1 line update pypy description ........ r80609 | benjamin.peterson | 2010-04-28 22:30:59 -0500 (Wed, 28 Apr 2010) | 1 line update pypy url ........ r80642 | andrew.kuchling | 2010-04-29 19:49:09 -0500 (Thu, 29 Apr 2010) | 1 line Always add space after RFC; reword paragraph ........ r80643 | andrew.kuchling | 2010-04-29 19:52:31 -0500 (Thu, 29 Apr 2010) | 6 lines 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? ........ r80644 | andrew.kuchling | 2010-04-29 20:02:15 -0500 (Thu, 29 Apr 2010) | 1 line Fix typos ........ r80645 | andrew.kuchling | 2010-04-29 20:32:47 -0500 (Thu, 29 Apr 2010) | 1 line Markup fix; clarify by adding 'in that order' ........ r80646 | andrew.kuchling | 2010-04-29 20:33:40 -0500 (Thu, 29 Apr 2010) | 1 line Add various items; rearrange unittest section a bit ........ r80651 | andrew.kuchling | 2010-04-30 08:46:55 -0500 (Fri, 30 Apr 2010) | 1 line Minor grammar re-wording ........ r80652 | andrew.kuchling | 2010-04-30 08:47:34 -0500 (Fri, 30 Apr 2010) | 1 line Add item ........ r80674 | andrew.kuchling | 2010-04-30 20:19:16 -0500 (Fri, 30 Apr 2010) | 1 line Add various items ........ r80684 | andrew.kuchling | 2010-05-01 07:05:52 -0500 (Sat, 01 May 2010) | 1 line Minor grammar fix ........ r80685 | andrew.kuchling | 2010-05-01 07:06:51 -0500 (Sat, 01 May 2010) | 1 line Describe memoryview ........ r80686 | antoine.pitrou | 2010-05-01 07:16:39 -0500 (Sat, 01 May 2010) | 4 lines Fix attribution. Travis didn't do much and he did a bad work. (yes, this is a sensitive subject, sorry) ........ r80748 | andrew.kuchling | 2010-05-03 20:24:22 -0500 (Mon, 03 May 2010) | 1 line Add some more items; the urlparse change is added twice ........ r80852 | andrew.kuchling | 2010-05-05 20:09:47 -0500 (Wed, 05 May 2010) | 1 line Reword paragraph; fix filename, which should be pyconfig.h ........ r80854 | andrew.kuchling | 2010-05-05 20:10:56 -0500 (Wed, 05 May 2010) | 1 line Add various items ........ r80870 | andrew.kuchling | 2010-05-06 09:14:09 -0500 (Thu, 06 May 2010) | 1 line Describe ElementTree 1.3; rearrange new-module sections; describe dict views as sets; small edits and items ........ r80872 | andrew.kuchling | 2010-05-06 12:21:59 -0500 (Thu, 06 May 2010) | 1 line Add 2 items; record ideas for two initial sections; clarify wording ........ r80873 | andrew.kuchling | 2010-05-06 12:27:57 -0500 (Thu, 06 May 2010) | 1 line Change section title; point to unittest2 ........ r80907 | andrew.kuchling | 2010-05-06 20:45:14 -0500 (Thu, 06 May 2010) | 1 line Add a new section on the development plan; add an item ........ r80915 | antoine.pitrou | 2010-05-07 05:15:51 -0500 (Fri, 07 May 2010) | 3 lines Fix some markup and a class name. Also, wrap a long line. ........ r80916 | andrew.kuchling | 2010-05-07 06:30:47 -0500 (Fri, 07 May 2010) | 1 line Re-word text ........ r80951 | andrew.kuchling | 2010-05-07 20:15:26 -0500 (Fri, 07 May 2010) | 1 line Add two items ........ r80952 | andrew.kuchling | 2010-05-07 20:35:55 -0500 (Fri, 07 May 2010) | 1 line Get accents correct ........ r80976 | andrew.kuchling | 2010-05-08 08:28:03 -0500 (Sat, 08 May 2010) | 1 line Add logging.dictConfig example; give up on writing a Ttk example ........ r80977 | andrew.kuchling | 2010-05-08 08:29:46 -0500 (Sat, 08 May 2010) | 1 line Markup fixes ........ r80985 | andrew.kuchling | 2010-05-08 10:39:46 -0500 (Sat, 08 May 2010) | 7 lines Write summary of the 2.7 release; rewrite the future section some more; mention PYTHONWARNINGS env. var; tweak some examples for readability. And with this commit, the "What's New" is done... except for a complete read-through to polish the text, and fixing any reported errors, but those tasks can easily wait until after beta2. ........ r81038 | benjamin.peterson | 2010-05-09 16:09:40 -0500 (Sun, 09 May 2010) | 1 line finish clause ........ r81039 | andrew.kuchling | 2010-05-10 09:18:27 -0500 (Mon, 10 May 2010) | 1 line Markup fix; re-word a sentence ........ r81040 | andrew.kuchling | 2010-05-10 09:20:12 -0500 (Mon, 10 May 2010) | 1 line Use title case ........ r81042 | andrew.kuchling | 2010-05-10 10:03:35 -0500 (Mon, 10 May 2010) | 1 line Link to unittest2 article ........ r81053 | florent.xicluna | 2010-05-10 14:59:22 -0500 (Mon, 10 May 2010) | 2 lines Add a link on maketrans(). ........ r81070 | andrew.kuchling | 2010-05-10 18:13:41 -0500 (Mon, 10 May 2010) | 1 line Fix typo ........ r81104 | andrew.kuchling | 2010-05-11 19:38:44 -0500 (Tue, 11 May 2010) | 1 line Revision pass: lots of edits, typo fixes, rearrangements ........ r81105 | andrew.kuchling | 2010-05-11 19:40:47 -0500 (Tue, 11 May 2010) | 1 line Let's call this done ........ r81114 | andrew.kuchling | 2010-05-12 08:56:07 -0500 (Wed, 12 May 2010) | 1 line Grammar fix ........ r81125 | andrew.kuchling | 2010-05-12 13:56:48 -0500 (Wed, 12 May 2010) | 1 line #8696: add documentation for logging.config.dictConfig (PEP 391) ........ r81245 | andrew.kuchling | 2010-05-16 18:31:16 -0500 (Sun, 16 May 2010) | 1 line Add cross-reference to later section ........ r81285 | vinay.sajip | 2010-05-18 03:16:27 -0500 (Tue, 18 May 2010) | 1 line Fixed minor typo in ReST markup. ........ r81402 | vinay.sajip | 2010-05-21 12:41:34 -0500 (Fri, 21 May 2010) | 1 line Updated logging documentation with more dictConfig information. ........ r81463 | georg.brandl | 2010-05-22 03:17:23 -0500 (Sat, 22 May 2010) | 1 line #8785: less confusing description of regex.find*. ........ r81516 | andrew.kuchling | 2010-05-25 08:34:08 -0500 (Tue, 25 May 2010) | 1 line Add three items ........ r81562 | andrew.kuchling | 2010-05-27 08:22:53 -0500 (Thu, 27 May 2010) | 1 line Rewrite wxWidgets section ........ r81563 | andrew.kuchling | 2010-05-27 08:30:09 -0500 (Thu, 27 May 2010) | 1 line Remove top-level 'General Questions' section, pushing up the questions it contains ........ r81567 | andrew.kuchling | 2010-05-27 16:29:59 -0500 (Thu, 27 May 2010) | 1 line Add item ........ r81593 | georg.brandl | 2010-05-29 03:46:18 -0500 (Sat, 29 May 2010) | 1 line #8616: add new turtle demo "nim". ........ r81635 | georg.brandl | 2010-06-01 02:25:23 -0500 (Tue, 01 Jun 2010) | 1 line Put docs for RegexObject.search() before RegexObject.match() to mirror re.search() and re.match() order. ........ r81680 | vinay.sajip | 2010-06-03 17:34:42 -0500 (Thu, 03 Jun 2010) | 1 line Issue #8890: Documentation changed to avoid reference to temporary files. ........ r81681 | sean.reifschneider | 2010-06-03 20:51:26 -0500 (Thu, 03 Jun 2010) | 2 lines Issue8810: Clearing up docstring for tzinfo.utcoffset. ........ r81684 | vinay.sajip | 2010-06-04 08:41:02 -0500 (Fri, 04 Jun 2010) | 1 line Issue #8890: Documentation changed to avoid reference to temporary files - other cases covered. ........ r81801 | andrew.kuchling | 2010-06-07 08:38:40 -0500 (Mon, 07 Jun 2010) | 1 line #8875: Remove duplicated paragraph ........ r81888 | andrew.kuchling | 2010-06-10 20:54:58 -0500 (Thu, 10 Jun 2010) | 1 line Add a few more items ........ r81931 | georg.brandl | 2010-06-12 01:26:54 -0500 (Sat, 12 Jun 2010) | 1 line Fix punctuation. ........ r81932 | georg.brandl | 2010-06-12 01:28:58 -0500 (Sat, 12 Jun 2010) | 1 line Document that an existing directory raises in mkdir(). ........ r81933 | georg.brandl | 2010-06-12 01:45:33 -0500 (Sat, 12 Jun 2010) | 1 line Update version in README. ........ r81939 | georg.brandl | 2010-06-12 04:45:01 -0500 (Sat, 12 Jun 2010) | 1 line Use newer toctree syntax. ........ r81940 | georg.brandl | 2010-06-12 04:45:28 -0500 (Sat, 12 Jun 2010) | 1 line Add document on how to build. ........ r81941 | georg.brandl | 2010-06-12 04:45:58 -0500 (Sat, 12 Jun 2010) | 1 line Fix gratuitous indentation. ........ r81942 | georg.brandl | 2010-06-12 04:46:03 -0500 (Sat, 12 Jun 2010) | 1 line Update README. ........ r81963 | andrew.kuchling | 2010-06-12 15:00:55 -0500 (Sat, 12 Jun 2010) | 1 line Grammar fix ........ r81984 | georg.brandl | 2010-06-14 10:58:39 -0500 (Mon, 14 Jun 2010) | 1 line #8993: fix reference. ........ r81991 | andrew.kuchling | 2010-06-14 19:38:58 -0500 (Mon, 14 Jun 2010) | 1 line Add another bunch of items ........ r82120 | andrew.kuchling | 2010-06-20 16:45:45 -0500 (Sun, 20 Jun 2010) | 1 line Note that Python 3.x isn't covered; add forward ref. for UTF-8; note error in 2.5 and up ........ r82188 | benjamin.peterson | 2010-06-23 19:02:46 -0500 (Wed, 23 Jun 2010) | 1 line remove reverted changed ........ r82264 | georg.brandl | 2010-06-27 05:47:47 -0500 (Sun, 27 Jun 2010) | 1 line Confusing punctuation. ........ r82265 | georg.brandl | 2010-06-27 05:49:23 -0500 (Sun, 27 Jun 2010) | 1 line Use designated syntax for optional grammar element. ........ r82266 | georg.brandl | 2010-06-27 05:51:44 -0500 (Sun, 27 Jun 2010) | 1 line Fix URL. ........ r82267 | georg.brandl | 2010-06-27 05:55:38 -0500 (Sun, 27 Jun 2010) | 1 line Two typos. ........	2010-06-27 22:32:30 +00:00
Georg Brandl	45cceeb608	Add descriptor HOWTO to py3k docs.	2010-05-19 21:39:51 +00:00
Victor Stinner	766ad36de5	Merged revisions 81163 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r81163 | victor.stinner | 2010-05-14 16:20:07 +0200 (ven., 14 mai 2010) | 2 lines Doc: replace PEP xxx by :pep:`xxx` to create a link on the PEP ........	2010-05-14 14:36:18 +00:00
Georg Brandl	386bc6d380	Merged revisions 80150,80460-80461 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r80150 | r.david.murray | 2010-04-17 17:45:38 +0200 (Sa, 17 Apr 2010) | 2 lines Update link to Apple Publication Style guide. ........ r80460 | georg.brandl | 2010-04-25 12:16:00 +0200 (So, 25 Apr 2010) | 1 line #8528: fix typo. ........ r80461 | georg.brandl | 2010-04-25 12:17:27 +0200 (So, 25 Apr 2010) | 1 line #8522: use with statement instead of try-finally for file handling. ........	2010-04-25 10:19:53 +00:00
Ezio Melotti	19192dd402	Merged revisions 79797 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r79797 | ezio.melotti | 2010-04-05 15:51:45 +0300 (Mon, 05 Apr 2010) | 1 line Fix some broken URLs. ........	2010-04-05 13:25:51 +00:00
Ezio Melotti	079d5ed6f8	Merged revisions 79781 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r79781 | ezio.melotti | 2010-04-05 06:51:38 +0300 (Mon, 05 Apr 2010) | 1 line #8212: rephrase the webservers howto and fix some mistakes. ........	2010-04-05 04:04:35 +00:00
Ezio Melotti	8bc4bbd21d	Merged revisions 79362 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r79362 | ezio.melotti | 2010-03-24 01:53:20 +0200 (Wed, 24 Mar 2010) | 1 line Another typo. ........	2010-03-23 23:56:06 +00:00