[issue40561] Provide docstrings for public-facing webbrowser functions

Terry J. Reedy added the comment: Current open doc: https://docs.python.org/3.9/library/webbrowser.html#webbrowser.open -- ___ Python tracker ___ _

[issue40561] Provide docstrings for public-facing webbrowser functions

Terry J. Reedy added the comment: I just got my development machine back, so I will handle this. I first determined that code and doc are same in all 3 versions (except for audit event bit, which I am willing to leave out). -- versions: +Python 3.7 _

[issue40561] Provide docstrings for public-facing webbrowser functions

Brad Solomon added the comment: To no surprise, not a lot of activity with the module over the last few years as it is fairly cut-and-dry. $ git shortlog -sn --since '5 years ago' Lib/webbrowser.py 3 Serhiy Storchaka 1 David Steele 1 Guido van Rossum 1 Michael Haas

[issue40561] Provide docstrings for public-facing webbrowser functions

Terry J. Reedy added the comment: Except is isn't, as he has been inactive for years. Git log may or may not show more recent commits. My dev machine is being repaired but should be back soon. -- ___ Python tracker

[issue40561] Provide docstrings for public-facing webbrowser functions

Brad Solomon added the comment: The module source notes "Maintained by Georg Brandl." -- ___ Python tracker ___ ___ Python-bugs-lis

[issue40561] Provide docstrings for public-facing webbrowser functions

Change by Brad Solomon : -- nosy: +georg.brandl ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.

[issue40561] Provide docstrings for public-facing webbrowser functions

Terry J. Reedy added the comment: Missing docstrings are almost a bug, but I am not sure if we backport additions. This needs the attention of a coredev to review, approve, and merge, but there is no particular 'webbrowser' maintainer. If no one shows up, you might use git to find those who

[issue40561] Provide docstrings for public-facing webbrowser functions

Change by Brad Solomon : -- keywords: +patch pull_requests: +19312 stage: -> patch review pull_request: https://github.com/python/cpython/pull/1 ___ Python tracker ___ ___

[issue40561] Provide docstrings for public-facing webbrowser functions

New submission from Brad Solomon : Currently 'pydoc webbrowser.open' simply displays the function signature without a useful explanation of what 'new' does (and the parameter name/value set is not intuitive by name alone). -- assignee: docs@python components: Documentation messages: 3