dox4/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-11-09 06:00:54 +08:00
Code Issues Packages Projects Releases Wiki Activity
120,673 Commits 6 Branches 685 Tags
3.12
Commit Graph
61 Commits
Author SHA1 Message Date
Miss Islington (bot)GitHubPetr ViktorinAdam Turner
 		7a8097c57a [3.12] gh-116666: Add "token" glossary term (GH-130888) (GH-131368) 
gh-116666: Add "token" glossary term (GH-130888)

Add glossary entry for `token`, and link to it.
Avoid talking about tokens in the SyntaxError intro (errors.rst); at this point
tokenization is too much of a technical detail. (Even to an advanced reader,
the fact that a *single* token is highlighted isn't too relevant. Also, we don't
need to guarantee that it's a single token.)
(cherry picked from commit 30d5205849)

Co-authored-by: Petr Viktorin <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
 2025-03-18 12:51:09 +01:00
Miss Islington (bot)GitHubfunkyrailroad
 		619037af1c [3.12] gh-127265: Remove single quotes from 'arrow's in tutorial/errors.rst (GH-127268) 
(cherry picked from commit 26ff32b305)

Co-authored-by: funkyrailroad <[email protected]>
 2024-11-25 21:42:34 +00:00
Miss Islington (bot)GitHubNice Zombies
 		e46fd7257a [3.12] gh-117597: Clarify exception handling in the tutorial (GH-117681) (#117700) 
(cherry picked from commit a05068db0c)

Co-authored-by: Nice Zombies <[email protected]>
 2024-04-09 21:06:35 +00:00
Miss Islington (bot)GitHubTerry Jan Reedy
 		1231697697 [3.12] gh-116563: Update tutorial error example (GH-116569) (#116624) 
There now may be multiple carets pointing at a token
rather than just a character.  Fix the sentence about
possible causes.
(cherry picked from commit 3e45030076)

Co-authored-by: Terry Jan Reedy <[email protected]>
 2024-03-11 22:11:44 +00:00
Miss Islington (bot)GitHubUnique-UsmanHugo van Kemenade
 		dedbd266d3 [3.12] gh-110383: Explained which error message is generated when there is an unhandled exception (GH-111574) (#112264) 
Co-authored-by: Unique-Usman <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
 2023-11-19 05:29:24 -07:00
Serhiy StorchakaandGitHub d514e1439f [3.12] gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386) (GH-107419) 
(cherry picked from commit f2d07d3289)
 2023-07-29 09:16:27 +03:00
Miss Islington (bot)GitHubJoe Kaufeld
 		e7757ab9e1 [3.12] Reformat code block to make it easier to read (GH-106965) (#107010) 
(cherry picked from commit ed491d9f78)

Co-authored-by: Joe Kaufeld <[email protected]>
 2023-07-22 14:54:13 +02:00
Miss Islington (bot)GitHubC.A.M. Gerlach
 		84cda268bd [3.12] Doc: Add missing ref labels to exception groups/notes sections (GH-106465) (#106473) 
Co-authored-by: C.A.M. Gerlach <[email protected]>
 2023-07-05 23:51:30 -06:00
Jens-Hilmar BradtandGitHub 8709697292 [doc] Fix error in tutorial example: type(exc) is the type rather than the instance (#102751) 2023-03-22 18:43:41 +00:00
DojandGitHub 586b07e1f9 [doc] fix typo (GH-99143) 2022-11-05 21:03:29 +00:00
Shahriar HeidrichandGitHub 395b66a0ae gh-97654: Add auto exception chaining example to tutorial (#97703) 
Add auto exception chaining example to tutorial
 2022-10-04 17:36:04 -07:00
Irit KatrielandGitHub f92bcfe6de gh-89770: [PEP-678] add exception notes to tutorial (GH-30441) 2022-04-20 13:43:10 +01:00
Irit KatrielandGitHub 04f9658c59 gh-90449: Improve accuracy and readability of exceptions tutorial (GH-31899) 2022-04-13 21:45:33 +01:00
Irit KatrielandGitHub c590b581bb bpo-46328: Add sys.exception() (GH-30514) 2022-01-13 12:35:58 +00:00
Irit KatrielandGitHub 9925e70e48 bpo-45292: [PEP-654] exception groups and except* documentation (GH-30158) 2022-01-06 19:05:34 +00:00
Hugo van KemenadeandGitHub 2db5613063 bpo-34538: Remove Exception subclassing from tutorial (GH-30361) 
Remove the bit about subclassing exceptions.

Documentation PR can skip the NEWS label.

Automerge-Triggered-By: GH:iritkatriel
 2022-01-03 14:52:09 -08:00
Raymond HettingerandGitHub 15a64d89a3 bpo-44966: Fix out-of-date traceback message (GH-27867) 2021-08-21 13:59:18 -05:00
Thomas GraingerandGitHub e9a6f1b78b bpo-41576: document BaseException in favor of bare except (GH-21917) 2021-08-06 22:44:15 +02:00
Terry Jan ReedyandGitHub 2f47d8dcc7 bpo-43927: Change 'IOError' to 'OSError' (GH-26289) 
This is the last remaining instance, at least for this chapter, in 3.10 & 3.11.
 2021-05-21 13:54:01 -04:00
Roberto HuesoandGitHub a0b9915a8b bpo-32822: Add finally with return/break/continue to the tutorial (#25600) 
This documents in the tutorial docs the behavior of a finally clause in
case it should re-raise an exception but contains a
return/break/continue statement.
 2021-05-04 14:36:01 +02:00
sblondonandGitHub 2fd928c8c1 bpo-42589: Change URL for 'from' link when used in a raised exception (GH-23872) 
Links for 'raise Exception from x' target to 'The raise statement' (7.8) section instead of 'The import statement' (7.11) section.

There are more modified links than in the bug report because I searched some other ones which can get the same improvement.
 2021-04-29 11:02:40 -07:00
Adorilson BezerraandGitHub 89294e30ff Doc: errors tutorial improvements (GH-16269) 
Improvements:

- Improvements in how try clause works section
  This suggestion is because the execution continues after *except*, not after *try* but before *except*. I guess this form more clear.

- Surrounding some keywords with \*...\*
  For uniformity the highlighted terms  

- Adjust the number of chars per line to 80
 2021-01-30 22:07:11 -08:00
VladimirandGitHub 3f9fe23c05 bpo-42179: Clarify exception chaining (GH-23160) 
* Update errors.rst

Clarify exception chaining behaviour and give a reference to the library documentation.

* Update errors.rst

Wording

* Update errors.rst

Spelling

* Update errors.rst

Remove mentioning of special attributes as folks think it's too much for beginners.
 2020-12-15 18:47:26 -08:00
Inada NaokiandGitHub bde33e428d bpo-42179: Doc/tutorial: Remove mention of __cause__ (GH-23162) 2020-11-06 11:45:01 +09:00
Noah DoersingandGitHub 8bcfd31cc0 Change 'exception happened' to 'exception occurred' in two places (#19767) 2020-04-30 21:30:10 -07:00
Julien PalardandGitHub 446463f8db bpo-39534: Doc: Clarify return in finally (GH-18324) 2020-02-06 23:16:48 +01:00
Mohammad DehghanStéphane WirtelAshwin Ramaswami
 		1ad7be2f16 bpo-38130: Fix error in explaining when an exception is re-raised (GH-16016) 
Co-Authored-By: Ashwin Ramaswami <[email protected]>
 2019-09-26 11:09:05 +02:00
Jason PluradandStéphane Wirtel 9ab6038fe8 Doc: Corrected syntax for return annotation (GH-16265) 
Signed-off-by: Jason Plurad <[email protected]>
 2019-09-19 07:24:29 +02:00
toonarmycaptainandStéphane Wirtel 0cc27417f2 Improve clarity of try-return-finally-return (GH-15677) 
Clarify execution in try-return-finally-return case.
 2019-09-11 17:37:13 +02:00
Abhilash RajandMiss Islington (bot) dcfe111eb5 bpo-37826: Document exception chaining in Python tutorial for errors. (GH-15243) 
https://bugs.python.org/issue37826
 2019-08-14 14:11:32 -07:00
Serhiy StorchakaandGitHub 2b57c43f21 bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
İsmail ArılıkandSerhiy Storchaka fe62d877e3 Fix a typo about a comma. (GH-10306) 2018-11-03 17:05:59 +02:00
Kushal Das ecbca357c9 Closes #28713 uses OSError in the tutorial 2016-11-16 21:13:43 +05:30
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
Terry Jan Reedy 30eee4deec Issue #28815: Change '?' to '<module>' in some doc examples. 
Patch by Mariatta Wijaya.
 2016-09-30 15:38:48 -04:00
Berker Peksag cf79cdb79d Issue #28306: Update exception message of ZeroDivisionError 2016-09-28 22:48:57 +03:00
Raymond Hettinger 7f65af3d2d Issue 27719: Remove a doc example that is not applicable in Python 3 2016-08-12 09:43:59 -07:00
Serhiy Storchaka dba903993a Issue #23921: Standardized documentation whitespace formatting. 
Original patch by James Edwards.
 2016-05-10 12:01:23 +03:00
Martin Panter 7462b64911 Issue #25523: Correct "a" article to "an" article 
This changes the main documentation, doc strings, source code comments, and a
couple error messages in the test suite. In some cases the word was removed
or edited some other way to fix the grammar.
 2015-11-02 03:37:02 +00:00
Andrew Svetlov 08af00047b Get rid of deprecated IOError in the doc 2014-04-01 01:13:30 +03:00
Georg Brandl 53bf15af47 Fix ZeroDivisionError message (reported by Pavel Fedotov on docs@) 2013-10-06 09:11:14 +02:00
Andrew Svetlov 09974b4e9e Drop double newlines printed in some file iteration examples. 
Patch by Steven Kryskalla.
 2012-12-08 17:59:03 +02:00
Georg Brandl ee8783d0fc Merged revisions 74817-74820,74822-74824 via svnmerge from 
svn+ssh://[email protected]/python/trunk

........
  r74817 | georg.brandl | 2009-09-16 11:05:11 +0200 (Mi, 16 Sep 2009) | 1 line

  Make deprecation notices as visible as warnings are right now.
........
  r74818 | georg.brandl | 2009-09-16 11:23:04 +0200 (Mi, 16 Sep 2009) | 1 line

  #6880: add reference to classes section in exceptions section, which comes earlier.
........
  r74819 | georg.brandl | 2009-09-16 11:24:57 +0200 (Mi, 16 Sep 2009) | 1 line

  #6876: fix base class constructor invocation in example.
........
  r74820 | georg.brandl | 2009-09-16 11:30:48 +0200 (Mi, 16 Sep 2009) | 1 line

  #6891: comment out dead link to Unicode article.
........
  r74822 | georg.brandl | 2009-09-16 12:12:06 +0200 (Mi, 16 Sep 2009) | 1 line

  #5621: refactor description of how class/instance attributes interact on a.x=a.x+1 or augassign.
........
  r74823 | georg.brandl | 2009-09-16 15:06:22 +0200 (Mi, 16 Sep 2009) | 1 line

  Remove strange trailing commas.
........
  r74824 | georg.brandl | 2009-09-16 15:11:06 +0200 (Mi, 16 Sep 2009) | 1 line

  #6892: fix optparse example involving help option.
........
 2009-09-16 16:00:31 +00:00
Georg Brandl 397ad860e9 #4144: fix output of console sessions. 2009-05-17 08:14:39 +00:00
Georg Brandl 48310cd3f2 Remove trailing whitespace. 2009-01-03 21:18:54 +00:00
Benjamin Peterson 5478b47355 Merged revisions 66457-66459,66465-66468,66483-66485,66487-66491 via svnmerge from 
svn+ssh://[email protected]/python/trunk

........
  r66457 | antoine.pitrou | 2008-09-13 15:30:30 -0500 (Sat, 13 Sep 2008) | 5 lines

  Issue #3850: Misc/find_recursionlimit.py was broken.

  Reviewed by A.M. Kuchling.
........
  r66458 | benjamin.peterson | 2008-09-13 17:54:43 -0500 (Sat, 13 Sep 2008) | 1 line

  fix a name issue; note all doc files should be encoded in utf8
........
  r66459 | benjamin.peterson | 2008-09-14 11:02:22 -0500 (Sun, 14 Sep 2008) | 1 line

  clarify that radix for int is not 'guessed'
........
  r66465 | skip.montanaro | 2008-09-14 21:03:05 -0500 (Sun, 14 Sep 2008) | 3 lines

  Review usage.  Fix a mistake in the new-style class definition.  Add a
  couple new definitions (CPython and virtual machine).
........
  r66466 | skip.montanaro | 2008-09-14 21:19:53 -0500 (Sun, 14 Sep 2008) | 2 lines

  Pick up a few more definitions from the glossary on the wiki.
........
  r66467 | benjamin.peterson | 2008-09-14 21:53:23 -0500 (Sun, 14 Sep 2008) | 1 line

  mention that object.__init__ no longer takes arbitrary args and kwargs
........
  r66468 | andrew.kuchling | 2008-09-15 08:08:32 -0500 (Mon, 15 Sep 2008) | 1 line

  Rewrite item a bit
........
  r66483 | georg.brandl | 2008-09-16 05:17:45 -0500 (Tue, 16 Sep 2008) | 2 lines

  Fix typo.
........
  r66484 | benjamin.peterson | 2008-09-16 16:20:28 -0500 (Tue, 16 Sep 2008) | 2 lines

  be less wordy
........
  r66485 | georg.brandl | 2008-09-17 03:45:54 -0500 (Wed, 17 Sep 2008) | 2 lines

  #3888: add some deprecated modules in whatsnew.
........
  r66487 | skip.montanaro | 2008-09-17 06:50:36 -0500 (Wed, 17 Sep 2008) | 2 lines

  usage
........
  r66488 | andrew.kuchling | 2008-09-17 07:57:04 -0500 (Wed, 17 Sep 2008) | 1 line

  Markup fixes
........
  r66489 | andrew.kuchling | 2008-09-17 07:58:22 -0500 (Wed, 17 Sep 2008) | 2 lines

  Remove comment about improvement: pystone is about the same, and
  the improvements seem to be difficult to quantify
........
  r66490 | andrew.kuchling | 2008-09-17 08:04:53 -0500 (Wed, 17 Sep 2008) | 1 line

  Note sqlite3 version; move item
........
  r66491 | benjamin.peterson | 2008-09-17 16:54:56 -0500 (Wed, 17 Sep 2008) | 1 line

  document compileall command flags
........
 2008-09-17 22:25:09 +00:00
Georg Brandl f5f2630db6 #3525: 3.0 exception changes in tutorial. 2008-08-08 06:50:56 +00:00
Benjamin Peterson e6f00637be Merged revisions 63655 via svnmerge from 
svn+ssh://[email protected]/python/trunk

........
  r63655 | benjamin.peterson | 2008-05-25 19:54:22 -0500 (Sun, 25 May 2008) | 2 lines

  update the tutorial to use str.format
........
 2008-05-26 01:03:56 +00:00
Neal Norwitz 752abd0d3c Convert a lot of print statements to print functions in docstrings, 
documentation, and unused/rarely used functions.
 2008-05-13 04:55:24 +00:00
Georg Brandl e6bcc9145e Remove many "versionchanged" items that didn't use the official markup, 
but just some text embedded in the docs.

Also remove paragraph about implicit relative imports from tutorial.
 2008-05-12 18:05:20 +00:00