[issue40561] Provide docstrings for public-facing webbrowser functions

2020-05-09 Thread Brad Solomon
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 Mi

[issue40561] Provide docstrings for public-facing webbrowser functions

2020-05-09 Thread Brad Solomon
Brad Solomon added the comment: The module source notes "Maintained by Georg Brandl." -- ___ Python tracker <https://bugs.python.org/issue40561> ___ ___

[issue40561] Provide docstrings for public-facing webbrowser functions

2020-05-09 Thread Brad Solomon
Change by Brad Solomon : -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue40561> ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue40561] Provide docstrings for public-facing webbrowser functions

2020-05-08 Thread Brad Solomon
Change by Brad Solomon : -- keywords: +patch pull_requests: +19312 stage: -> patch review pull_request: https://github.com/python/cpython/pull/1 ___ Python tracker <https://bugs.python.org/issu

[issue40561] Provide docstrings for public-facing webbrowser functions

2020-05-08 Thread Brad Solomon
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: Do

[issue38387] Document PyDoc_STRVAR

2019-10-06 Thread Brad Solomon
New submission from Brad Solomon : The C-API reference would benefit from a short mention of PyDoc_STRVAR usage, since it is used so frequently within Modules/. -- assignee: docs@python components: Documentation messages: 354053 nosy: bsolomon1124, docs@python priority: normal

[issue37982] Add a --minify argument to json.tool

2019-08-29 Thread Brad Solomon
Brad Solomon added the comment: > json.tool produces more readable representation. Your option is opposite to > this purpose. That is correct, though I'm not sure what point you're trying to make. The purpose of minifying isn't to make the input more readable; it

[issue37982] Add a --minify argument to json.tool

2019-08-29 Thread Brad Solomon
Brad Solomon added the comment: Since, as you point out, json.tool is made for convenience, I see the reverse of pretty-printing (minifying) being just as convenient: $ cat > expanded.json < { > "foo": "bar", > "json": "obj&

[issue37982] Add a --minify argument to json.tool

2019-08-29 Thread Brad Solomon
Change by Brad Solomon : -- keywords: +patch pull_requests: +15277 stage: -> patch review pull_request: https://github.com/python/cpython/pull/15601 ___ Python tracker <https://bugs.python.org/issu

[issue37982] Add a --minify argument to json.tool

2019-08-29 Thread Brad Solomon
New submission from Brad Solomon : I propose adding a command line `--minify` flag to the json/tool.py module. This flag, if specified, uses `indent=None` and `separators=(',', ':')` to eliminate indent and separator whitespace in the output. Minifying JSON (as is also

[issue36960] Make datetime docs more user-friendly

2019-05-18 Thread Brad Solomon
New submission from Brad Solomon : The datetime docs are chalk full of detail. This is a positive aspect, and represents a huge amount of work by Tim Peters and A.M. Kuchling. However, it also may function as an obstacle for beginner readers and those simply seeking to answer a basic question