Skip to content

Document PEP 3134 in tutorials/errors.rst #82007

Closed

Description

@maxking
BPO 37826
Nosy @rhettinger, @methane, @maxking, @miss-islington
PRs
  • bpo-37826: Document exception chaining in Python tutorial for errors. #15243
  • bpo-42179: Doc/tutorial: Remove mention of __cause__ #23162
  • Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

    Show more details

    GitHub fields:

    assignee = None
    closed_at = <Date 2019-08-16.21:58:04.426>
    created_at = <Date 2019-08-11.18:36:06.429>
    labels = ['docs']
    title = 'Document PEP 3134 in tutorials/errors.rst'
    updated_at = <Date 2020-11-05.09:05:04.157>
    user = 'https://github.com/maxking'

    bugs.python.org fields:

    activity = <Date 2020-11-05.09:05:04.157>
    actor = 'methane'
    assignee = 'docs@python'
    closed = True
    closed_date = <Date 2019-08-16.21:58:04.426>
    closer = 'maxking'
    components = ['Documentation']
    creation = <Date 2019-08-11.18:36:06.429>
    creator = 'maxking'
    dependencies = []
    files = []
    hgrepos = []
    issue_num = 37826
    keywords = ['patch']
    message_count = 4.0
    messages = ['349406', '349426', '349510', '349751']
    nosy_count = 5.0
    nosy_names = ['rhettinger', 'methane', 'docs@python', 'maxking', 'miss-islington']
    pr_nums = ['15243', '23162']
    priority = 'normal'
    resolution = None
    stage = 'resolved'
    status = 'closed'
    superseder = None
    type = None
    url = 'https://bugs.python.org/issue37826'
    versions = []

    Activity

    1. maxking commented on Aug 11, 2019

      @maxking
      ContributorAuthor

      Looking at the docs, I couldn't find the raise from documentation anywhere in the Errors and Exceptions page (https://docs.python.org/3/tutorial/errors.html) page, which seems to be the landing page for Python Exceptions.

      I do see however that it is documented on the top page of https://docs.python.org/3/library/exceptions.html and raise statement's docs (https://docs.python.org/3/reference/simple_stmts.html#raise), both of which are pretty hard to discover.

      It would be nice to add the docs for raise from in the Errors and Exception page too.

    2. rhettinger commented on Aug 12, 2019

      @rhettinger
      Contributor

      This is a reasonable suggestion.

      Would you like to submit a pull request?

    3. maxking commented on Aug 13, 2019

      @maxking
      ContributorAuthor

      Yes, I am gonna work on a PR.

    4. miss-islington commented on Aug 14, 2019

      @miss-islington
      Contributor

      New changeset dcfe111 by Miss Islington (bot) (Abhilash Raj) in branch 'master':
      bpo-37826: Document exception chaining in Python tutorial for errors. (GH-15243)
      dcfe111

    5. transferred this issue fromon Apr 10, 2022
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

    Metadata

    Metadata

    Assignees

    No one assigned

      Labels

      docsDocumentation in the Doc dir

      Projects

      No projects

        Milestone

        No milestone

        Relationships

        None yet

        Development

        No branches or pull requests

        Issue actions