73 commits

Author	SHA1	Message	Date
Stanley	fde74be61b	gh-73196: Add namespace/scope clarification for inheritance section (#92840) ... Add namespace/scope clarification for inheritance section	2022-10-07 12:04:14 -07:00
Ned Batchelder	3440d197a5	Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551) ... Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021	2022-07-05 11:16:10 +02:00
Nicolas Haller	88f0d0c1e8	gh-89158: Add some REPL secondary prompt markers (#93073) ... This fixes an issue on tutorial/classes.rst section 9.4 where the example "class Warehouse" was truncated when pressing the >>> button to hide the prompts and output.	2022-05-23 00:58:07 -04:00
Vivek Vashist	c5d18a5014	Fix the output of built-in iter() function example in Iterators (Section 9.8) of The Python Tutorial (GH-30110) ... Updated the output for it=iter(s) from <iterator object at 0x00A1DB50> to <str_iterator object at 0x10c90e650>	2021-12-16 18:40:12 +08:00
Victor Stinner	bb0b08540c	bpo-40204: Fix reference to terms in the doc (GH-21865) ... Sphinx 3 requires to refer to terms with the exact case. For example, fix the Sphinx 3 warning: Doc/library/pkgutil.rst:71: WARNING: term Loader not found in case sensitive match.made a reference to loader instead.	2020-08-14 12:20:05 +02:00
Paul McMillan	4f28f75dee	Fix repeated words in Classes tutorial (GH-21455) ... The phrase "At any time during execution," was repeated twice. Automerge-Triggered-By: @Mariatta	2020-07-13 18:26:23 -07:00
Joannah Nanjekye	9ed3cd8ba0	bpo-26205: Specify the number of nested scopes (GH-21324) ... * Clarify number of scopes * Indicate 3 or 4 Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>	2020-07-05 22:42:24 -03:00
Antoine	e5e56328af	bpo-39869: Fix typo in 'Instance objects' section. (GH-18889)	2020-03-10 07:17:40 -07:00
Shanavas M	7142df5ea2	bpo-39431: Also mention nonlocal in assignment quirk (GH-17375)	2020-01-23 13:09:21 -05:00
Raymond Hettinger	483ae0cf1d	bpo-12634: Clarify an awkward section of the tutorial (GH-15406)	2019-08-22 23:27:04 -07:00
Serhiy Storchaka	2b57c43f21	bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)	2018-12-19 08:09:46 +02:00
Andrés Delfino	c5eec4426d	Add a reference to the name mangling description in the tutorial to the index. (GH-10138)	2018-11-07 19:59:45 +02:00
Berker Peksag	13ae4d4438	bpo-21196: Clarify name mangling rules in tutorial (GH-5667) ... Initial patch by Chandan Kumar.	2018-10-20 02:33:48 +02:00
Aaron Ang	c0f0a7669c	bpo-28677: Improve phrasing of when instance attribute is referenced (GH-6208)	2018-07-25 17:21:32 +03:00
Stéphane Wirtel	ab328756d7	bpo-32722: Remove useless example in the Classes tutorial (#5446) ... In the tutorial about the Generator expression, there is an example with a dict comprehension and not with a generator expression, just removed the code.	2018-02-01 15:31:07 +08:00
Emily Morehouse	f190eb59e6	bpo-32452: clarify term 'brackets' in generator tutorial (#5079) ... Updates documentation for generator expressions in classes tutorial: Clarify usage of ambiguous term "brackets" by replacing with "square brackets". Updated subsequent lines to respect line breaks. (#5079)	2018-01-01 20:34:53 -05:00
Trey Hunner	3fbd70018f	bpo-30466: Add brief explanation of classes to tutorial (GH-1804)	2017-07-12 19:30:37 -07:00
UltimateCoder	8856940cf2	bpo-28315: Improve code examples in docs (GH-1372) ... Replace File "<stdin>", line 1, in ? with File "<stdin>", line 1, in <module>	2017-05-03 09:46:45 -07:00
R David Murray	4ec1590fbf	#29005: clarify terminology in tutorial 'method' discussion. ... Patch by Jim Fasarakis-Hilliard.	2016-12-18 14:59:58 -05:00
Berker Peksag	cea632ece5	Issue #21864: Remove outdated section about exceptions from the tutorial ... Move the still relevant parts of it to the previous chapter, "Errors and Exceptions".	2016-11-06 21:15:01 +03:00
Martin Panter	bae5d81f5d	Issue #24314: Fix doc links for general attributes like __name__, __dict__	2016-06-18 03:57:31 +00:00
Berker Peksag	8e937f80c9	Fix typo in Python tutorial	2016-06-01 09:36:14 -07:00
Serhiy Storchaka	dba903993a	Issue #23921: Standardized documentation whitespace formatting. ... Original patch by James Edwards.	2016-05-10 12:01:23 +03:00
Georg Brandl	f0d2ed73ac	minor grammar fixes (from docs@python.org)	2014-10-31 09:29:38 +01:00
Georg Brandl	e73778c1ac	Use https:// URLs when referring to python.org hosts.	2014-10-29 08:36:35 +01:00
Ezio Melotti	79a1ffde9b	#22170: avoid printing newlines twice in tutorial example.	2014-08-08 17:23:32 +03:00
Raymond Hettinger	04ba0bb80c	Issue #11974: Add tutorial section on class and instance variables ... (Based on a patch from Renee Chu.)	2014-06-23 18:08:01 -07:00
Serhiy Storchaka	91aaeac050	Issue #19193: Improved cross-references in the tutorial.	2013-10-09 09:54:46 +03:00
Georg Brandl	a0ec296599	Remove newline in method that makes it possible to copy example to the interactive interpreter.	2013-10-06 09:42:46 +02:00
Benjamin Peterson	143d034ecd	merge 3.2	2012-10-12 12:04:32 -04:00
Ezio Melotti	7fa822275b	Fix links to the __next__ method.	2012-10-12 13:42:08 +03:00
Senthil Kumaran	065dedaf47	Fix closes Issue: 14217 - 3.2 branch	2012-03-08 20:56:52 -08:00
Senthil Kumaran	74d5657c80	Fix closes Issue: 14217 - Appropriate sphinx directive for output. Patch by Tshepang Lekhonkhobe	2012-03-08 20:54:34 -08:00
Terry Jan Reedy	ea868d32a1	Minor correction. #11418	2012-01-11 14:54:34 -05:00
Terry Jan Reedy	982c91e4c9	Merge with 3.2	2012-01-11 14:56:22 -05:00
Éric Araujo	2527796a22	Merge from 3.2 (#10318, #12255, #12043, #12417 and other fixes)	2011-07-29 03:11:09 +02:00
Éric Araujo	72db3459e4	Make indentation comply with our style guide and the rest of the file	2011-07-26 16:54:24 +02:00
Raymond Hettinger	6ddefd7916	Issue 12086: add example showing how to use name mangling.	2011-06-25 16:30:39 +02:00
Raymond Hettinger	142d0f5e5a	Issue 12086: add example showing how to use name mangling.	2011-06-25 16:31:06 +02:00
Georg Brandl	6c32b4a601	merge with 3.2	2011-05-01 22:37:46 +02:00
Georg Brandl	da623ed9f4	Split combined code/doctest code blocks in two blocks, to enable proper highlighting.	2011-05-01 22:37:23 +02:00
Georg Brandl	2cdee708e9	Split combined code/doctest code blocks in two blocks, to enable proper highlighting.	2011-05-01 22:34:31 +02:00
Georg Brandl	52d3e7e6a5	Name c -> cls in example.	2011-03-07 08:31:52 +01:00
Georg Brandl	a192828ea1	#9138: reword introduction to classes in Python.	2010-10-17 10:44:11 +00:00
Georg Brandl	17dafdc249	Clarify that abs() is not a namespace.	2010-08-02 20:44:34 +00:00
Georg Brandl	067425520e	Clarification. Yay importlib!	2010-07-19 11:28:05 +00:00
Mark Dickinson	cf48e44130	Remove mention of execfile from the tutorial.	2010-07-12 09:37:40 +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	c4a55fccab	Recorded merge of revisions 78024 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r78024 | georg.brandl | 2010-02-06 19:44:44 +0100 (Sa, 06 Feb 2010) | 1 line #5341: fix "builtin" where used as an adjective ("built-in" is correct). ........	2010-02-06 18:46:57 +00:00
Georg Brandl	a6053b4846	Merged revisions 74542,74544-74548,74550,74554-74555,74578,74588,74590,74603,74616-74618,74621 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r74542 | georg.brandl | 2009-08-23 23:28:56 +0200 (So, 23 Aug 2009) | 1 line Restore alphabetic order. ........ r74544 | georg.brandl | 2009-08-24 19:12:30 +0200 (Mo, 24 Aug 2009) | 1 line #6775: fix python.org URLs in README. ........ r74545 | georg.brandl | 2009-08-24 19:14:29 +0200 (Mo, 24 Aug 2009) | 1 line #6772: mention utf-8 as utf8 alias. ........ r74546 | georg.brandl | 2009-08-24 19:20:40 +0200 (Mo, 24 Aug 2009) | 1 line #6725: spell "namespace" consistently. ........ r74547 | georg.brandl | 2009-08-24 19:22:05 +0200 (Mo, 24 Aug 2009) | 1 line #6718: fix example. ........ r74548 | georg.brandl | 2009-08-24 19:24:27 +0200 (Mo, 24 Aug 2009) | 1 line #6677: mention "deleting" as an alias for removing files. ........ r74550 | georg.brandl | 2009-08-24 19:48:40 +0200 (Mo, 24 Aug 2009) | 1 line #6677: note that rmdir only removes empty directories. ........ r74554 | georg.brandl | 2009-08-27 20:59:02 +0200 (Do, 27 Aug 2009) | 1 line Typo fix. ........ r74555 | georg.brandl | 2009-08-27 21:02:43 +0200 (Do, 27 Aug 2009) | 1 line #6787: reference fix. ........ r74578 | tarek.ziade | 2009-08-29 15:33:21 +0200 (Sa, 29 Aug 2009) | 1 line fixed #6801: symmetric_difference_update also accepts pipe ........ r74588 | georg.brandl | 2009-08-30 10:35:01 +0200 (So, 30 Aug 2009) | 1 line #6803: fix old name. ........ r74590 | georg.brandl | 2009-08-30 13:51:53 +0200 (So, 30 Aug 2009) | 1 line #6801: fix copy-paste oversight. ........ r74603 | georg.brandl | 2009-08-31 08:38:29 +0200 (Mo, 31 Aug 2009) | 1 line other -> others where multiple arguments are accepted. ........ r74616 | georg.brandl | 2009-09-01 09:46:26 +0200 (Di, 01 Sep 2009) | 1 line #6808: clarification. ........ r74617 | georg.brandl | 2009-09-01 09:53:37 +0200 (Di, 01 Sep 2009) | 1 line #6765: hint that log(x, base) is not very sophisticated. ........ r74618 | georg.brandl | 2009-09-01 10:00:47 +0200 (Di, 01 Sep 2009) | 1 line #6810: add a link to the section about frame objects instead of just a description where to find it. ........ r74621 | georg.brandl | 2009-09-01 10:06:03 +0200 (Di, 01 Sep 2009) | 1 line #6638: fix wrong parameter name and markup a class. ........	2009-09-01 08:11:14 +00:00