Description

jordibc

opened on Jul 29, 2024

Issue body actions

Documentation

In https://docs.python.org/3/library/webbrowser.html#browser-controller-objects it says:

 webbrowser.name
    System-dependent name for the browser.

when it should be controller instead of webbrowser (it is the controller object that has the name attribute, not the webbrowser module).

In addition to that, I think that the first sentence,

Browser controllers provide these methods which parallel three of the module-level convenience functions:

would probably be better with something like:

Browser controllers provide the `name` attribute, and these methods which parallel three of the module-level convenience functions:

Thanks!

Linked PRs

• gh-122399: change webbrowser.rst to better describe the contents of controller object #122407
• gh-122399: change webbrowser.rst to better describe the contents of controller object #122410
• [3.13] gh-122399: change webbrowser.rst to better describe the contents of controller object (GH-122407) #132874

Activity

1. jordibc

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Jul 29, 2024
2. AA-Turner commented on Jul 29, 2024

   

   AA-Turner

   on Jul 29, 2024

   Member

   More actions

   Would you be willing to open a PR?

   A
3. jordibc

   added a commit that references this issue on Jul 29, 2024

   webbrowser.rst: better describe the contents of controller object

   559b1e9
4. jordibc commented on Jul 29, 2024

   

   jordibc

   on Jul 29, 2024

   ContributorAuthor

   More actions

   @AA-Turner Sure! I just did in #122407 .

   It turns out that for the documentation in dev, the main part was already changed (webbrowser -> controller). So I just added the second part (mentioning the name attribute).
5. jordibc

   added a commit that references this issue on Jul 29, 2024

   pythongh-122399: change webbrowser.rst to better describe the conten…

   af52ff7
6. jordibc commented on Jul 29, 2024

   

   jordibc

   on Jul 29, 2024

   ContributorAuthor

   More actions

   And this is the PR with the complete change for the branch with the last stable release (3.12): #122410
7. AA-Turner commented on Jul 29, 2024

   

   AA-Turner

   on Jul 29, 2024

   Member

   More actions

   #105546 fixed controller.name but wasn't backported for obvious reasons.

   A
8. hugovk

   added a commit that references this issue on Apr 24, 2025

   gh-122399: change webbrowser.rst to better describe the contents of c…

   1583f9c
9. miss-islington

   added a commit that references this issue on Apr 24, 2025

   pythongh-122399: change webbrowser.rst to better describe the content…

   1ed6783
10. hugovk

    added a commit that references this issue on Apr 24, 2025

    [3.13] gh-122399: change webbrowser.rst to better describe the conten…

    bd4a39f
11. hugovk

    closed this as completedon Apr 24, 2025

Issue actions