[issue42496] Don't change indentation of RST markup
Georg Brandl added the comment: To be clear, this has nothing to do with the amount of indentation, but that the directive below (the versionadded) has 4 spaces, and the paragraph above had 5 before the change. Therefore the further-indented paragraph is taken as a blockquote. -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue42496> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue42153] doc: library imaplib a url not available
Georg Brandl added the comment: It doesn't make sense to include the archive link, the documentation it refers to is available in the GitHub repository under docs/. -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue42153> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue42284] The grammar specification is inconsistent with the implementation of Python parser.
Georg Brandl added the comment: This grammar specification doesn't contain a full specification of code that won't raise SyntaxError. There are several conditions that aren't checked by the generated parser, but at a later stage in the compilation process. While probably possible to express in general, this would make the grammar much more complex. For this example, it would require different definitions of `suite`, `stmt`, `simple_stmt`, `compound_stmt` and so on, to track where control-flow statements are allowed. Other definitions need to track `nonlocal` and you'd get a combinatorial explosion of productions. You could propose a PR to add a note somewhere on that page (but on the master branch, not 3.6 which is unmaintained). -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue42284> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue41825] os.waitid() documentation needs TLC
Change by Georg Brandl : -- keywords: +patch pull_requests: +21394 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/22356 ___ Python tracker <https://bugs.python.org/issue41825> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue41825] os.waitid() documentation needs TLC
New submission from Georg Brandl : There are a few points where `os.waitid()` docs need improvement. Current text: Wait for the completion of one or more child processes. idtype can be P_PID, P_PGID or P_ALL. id specifies the pid to wait on. options is constructed from the ORing of one or more of WEXITED, WSTOPPED or WCONTINUED and additionally may be ORed with WNOHANG or WNOWAIT. The return value is an object representing the data contained in the siginfo_t structure, namely: si_pid, si_uid, si_signo, si_status, si_code or None if WNOHANG is specified and there are no children in a waitable state. Problems are: * The given use of the *pid* argument is only for the case of `idtype=P_PID`. For `P_ALL` it is ignored, and for `P_PGID` it specifies that the child's PGID must be *pid*. * "One or more child processes" is misleading -- the function waits for until exactly one child process to exit (or aborts with WNOHANG). Sure, there can be multiple candidate processes, but this should be formulated differently. * The explanation of *options* is quite cumbersome, it seems to be copied directly from the manpage (where it is laid out much more clearly and with explanation of the different options). Additionally the flags P_*, W* and CLD_* are just stated as-is, and need explanation in the docs. You should not need to consult the manpage to be able to use the function at all. -- assignee: docs@python components: Documentation keywords: easy messages: 377263 nosy: docs@python, georg.brandl priority: normal severity: normal stage: needs patch status: open title: os.waitid() documentation needs TLC type: enhancement versions: Python 3.10, Python 3.8, Python 3.9 ___ Python tracker <https://bugs.python.org/issue41825> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue1678077] improve telnetlib.Telnet so option negotiation becomes easie
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue1678077> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19915] int.bit_at(n) - Accessing a single bit in O(1)
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue19915> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue1249749] Encodings and aliases do not match runtime
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue1249749> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue1105770] null source chars handled oddly by tokenize
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue1105770> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue1611944] sndhdr.what() does not recognize wav file
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue1611944> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue919238] Recursive variable definition causes sysconfig infinite loop
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue919238> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue11105] Compiling evil ast crashes interpreter
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue11105> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26053] regression in pdb output between 2.7 and 3.5
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue26053> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue22107] tempfile module misinterprets access denied error on Windows
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue22107> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25467] Put “deprecated” warnings first
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue25467> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue22577] local variable changes lost after pdb jump command
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue22577> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue1823] Possible to set invalid Content-Transfer-Encoding on email.mime.multipart.MIMEMultipart
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue1823> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20119] pdb c(ont(inue)) optional one-time-only breakpoint (like perl debugger)
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue20119> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue18280] Documentation is too personalized
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue18280> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26794] curframe can be None in pdb.py
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue26794> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue24160] Pdb sometimes raises exception when trying to remove a breakpoint defined in a different debugger session
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue24160> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue23163] pdb docs need to contain a statement on threads/multithreaded debugging
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue23163> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue19081] zipimport behaves badly when the zip file changes while the process is running
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue19081> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26214] textwrap should minimize number of breaks in extra long words
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue26214> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue28850] Regression in Python 3: Subclassing PrettyPrinter.format doesn't work anymore
Change by Georg Brandl : -- nosy: -georg.brandl ___ Python tracker <https://bugs.python.org/issue28850> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue40994] Very confusing documenation for abc.Collections
Georg Brandl added the comment: FWIW, I think Sydney's right. Shared entries should only be used for closely related, or interdependent, APIs, which those here are not. -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue40994> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration
Georg Brandl added the comment: Don't hesitate to send requests back to the Sphinx tracker if any changes appear to be too restrictive to you. It is a documentation tool, not a compiler. -- nosy: +georg.brandl ___ Python tracker <https://bugs.python.org/issue40204> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue40058] Running test_datetime twice fails with: module 'datetime' has no attribute '_divide_and_round'
Georg Brandl added the comment: Sorry, it seems that was far too long ago for me to remember anything :) -- ___ Python tracker <https://bugs.python.org/issue40058> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue29869] Underscores in numeric literals not supported in lib2to3.
Georg Brandl added the comment: > In particular, we must have at least one digit following `0[xXbBoO]` and must > be before any underscores. This is not true (but your test file does the right thing). -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue29869> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue29557] binhex documentation claims unknown bug
Georg Brandl added the comment: I don't remember anything specific about this, sorry. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue29557> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] PEP 515: Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Thanks Brett! -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] PEP 515: Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Please go ahead. Thanks for taking care of this! -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: @Serhiy/anyone: can I get another review, so that we can commit this in time for beta? Thanks! -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue12345] Add math.tau
Georg Brandl added the comment: Please folks. Stop taking this so seriously and remember that this is the language where you can type in >>> import antigravity and it actually works. (Sort of.) -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue12345> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue27228] just for clearing: os.path.normpath("file://a") returns "file:/a"
Georg Brandl added the comment: `os.path` does not handle URIs of any type, so this behavior is correct as Steven says. -- nosy: +georg.brandl resolution: -> not a bug status: open -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue27228> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Thanks for the detailed review, Serhiy! Next try incoming. -- Added file: http://bugs.python.org/file42939/numeric_underscores_final_v8.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue27060] Documentation of assertItemsEqual in unittest is VERY misleading in 2.7
Changes by Georg Brandl <ge...@python.org>: -- nosy: +michael.foord ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue27060> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Thanks Eric! Serhiy, do you want to do a review? The v6/v7 patches are based on your "strict" patch with the constructor changes adapted from v4. New version v7 addresses the review comments from Stefan and Martin. -- Added file: http://bugs.python.org/file42887/numeric_underscores_final_v7.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue27036] Mark up of references in different form
Georg Brandl added the comment: Not really, no. You have to add a :ref: target label for the function. If it's only a few instances, that should be manageable. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue27036> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Note: the changes for format()ting ("_" as thousands separator) are still missing. Eric, would you consider doing this part? -- nosy: +eric.smith ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Changes by Georg Brandl <ge...@python.org>: Removed file: http://bugs.python.org/file41892/numeric_underscores_v2.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Changes by Georg Brandl <ge...@python.org>: Removed file: http://bugs.python.org/file42852/numeric_underscores_final_v5.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Changes by Georg Brandl <ge...@python.org>: Removed file: http://bugs.python.org/file41888/numeric_underscores.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Changes by Georg Brandl <ge...@python.org>: Removed file: http://bugs.python.org/file41894/numeric_underscores_v3_full.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Changes by Georg Brandl <ge...@python.org>: Added file: http://bugs.python.org/file42854/numeric_underscores_final_v6.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: New patch; implements the accepted version of the PEP. I added the additional tests, thanks Stefan! -- Added file: http://bugs.python.org/file42852/numeric_underscores_final_v5.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue17765] weakref.ref ignores a 'callback' keyword argument
Georg Brandl added the comment: Serhiy, feel free to go ahead and commit, I don't have my keys with me ATM. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue17765> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26736] Use HTTPS protocol in links
Georg Brandl added the comment: Newer Sphinx versions already redefine docutils' RFC and PEP URLs to use https. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26736> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26914] Fix formatting of lists in PEP 420
Georg Brandl added the comment: Yep, they should all be gone. I tried to make sure by running the sources through docutils and finding nested nodes. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26914> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26921] Incorrect usage of a/an articles in PEPs
Georg Brandl added the comment: Also LGTM. It's easy to spot PEPs written by French people :) -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26921> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26916] Word duplications in PEPs
Georg Brandl added the comment: LGTM. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26916> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26914] Fix formatting of lists in PEP 420
Changes by Georg Brandl <ge...@python.org>: -- resolution: -> fixed status: open -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26914> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26914] Fix formatting of lists in PEP 420
Georg Brandl added the comment: Looks pretty rampant to me :) Anyway, +1 for fixing, you can just do it without review if you have the time. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26914> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26847] filter docs unclear wording
Georg Brandl added the comment: You didn't test your examples: >>> [] == False False False is not equal to the "empty value" of any other type than other numeric types. (This is mostly because of how booleans were originally introduced to Python.) "is false", on the other hand, is the conventional shorthand for `bool(x) == False`. -- nosy: +georg.brandl resolution: -> not a bug status: open -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26847> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26821] array module "minimum size in bytes" table is wrong for int/long
Georg Brandl added the comment: Agreed. -- resolution: -> not a bug status: open -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26821> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26821] array module "minimum size in bytes" table is wrong for int/long
Georg Brandl added the comment: Indeed, I don't think the `array` module is much used anymore. If you're looking to serialize or deserialize fixed-size formats, you'll probably want the `struct` module. It has both native and fixed-size modes. For anything else involving arrays (mostly, but not exclusively, of numbers), just use numpy. It has a much more developed system of data types for its arrays, and supports views. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26821> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26755] Update version{added,changed} docs in devguide
Georg Brandl added the comment: Now that "added" doesn't mention the second argument, the "This one *must* have the second argument (explanation of the change)." should be changed. Otherwise +1. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26755> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26736] Use HTTPS protocol in links
Georg Brandl added the comment: +1 -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26736> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26576] Tweak wording of decorator docos
Georg Brandl added the comment: (Also, toggled your "is committer" bit so you get the Python logo next to your name.) -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26576> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: The last patch isn't up to date with the PEP; Serhiy's patch is the closest one. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26576] Tweak wording of decorator docos
Georg Brandl added the comment: The patch is definitely an improvement. What about a remark like ", except that `deco` is evaluated before the function `f` is created"? That should cover the remaining difference. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26576> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26576] Tweak wording of decorator docos
Georg Brandl added the comment: That is definitely supported. Whether it's actually useful to document, I'm not sure. "except that the original function is not temporarily bound to the name `f`" could work. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26576> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26535] Minor typo in the docs for struct.unpack
Georg Brandl added the comment: That sounds good to me. Maybe without so many parentheses :) -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26535> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26525] Documentation of ord(c) easy to misread
Georg Brandl added the comment: Sure! -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26525> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26512] Vocabulary: Using "integral" in library/stdtypes.html
Georg Brandl added the comment: There's two different uses here: The one use in "truncated to Integral" means that you get an integer type out. It is not specified to be `int` because `__trunc__` may return other types. It could be made into a link like the other use of Integral. The other uses are "integral float", which is *not* the same as an integer. It is a float whose value is a whole number, and AFAIK "integral" is the correct adjective for that. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26512> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue23921] Standardize documentation whitespace, formatting
Georg Brandl added the comment: I had no idea we had so many cases of wonky indentation :) This looks good to me, apart from a few comments I left on rietveld. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue23921> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26462] Patch to enhance literal block language declaration
Georg Brandl added the comment: Looks good now! I left a few comments on Rietveld. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26462> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26462] Patch to enhance literal block language declaration
Georg Brandl added the comment: Thanks for the patch! Most "bash" blocks should be "console" (since the prompt is shown). "pycon" should not be needed, since it is detected automatically. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26462> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26449] Tutorial on Python Scopes and Namespaces uses confusing 'read-only' terminology
Georg Brandl added the comment: I think rephrasing with "... can only be read" would keep the intended meaning, but avoid the problematic "the namespaces are readonly" meaning. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26449> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25910] Fixing links in documentation
Georg Brandl added the comment: Reopening, for fixing the rest of the broken ones. -- nosy: +georg.brandl resolution: fixed -> status: closed -> open ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue25910> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25910] Fixing links in documentation
Changes by Georg Brandl <ge...@python.org>: -- status: languishing -> open ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue25910> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26442] Doc refers to xmlrpc.client but means xmlrpc.server
Georg Brandl added the comment: Thanks! -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26442> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26444] Fix 2 typos on ElementTree docs
Georg Brandl added the comment: Reflow is kinda bad for patch review :) -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26444> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26435] Fix versionadded/versionchanged documentation directives
Georg Brandl added the comment: Ok, that was a bug in rstlint. Fixed now - and now I can find quite a few instances, will fix them (most of them are in this patch). -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26435> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26435] Fix versionadded/versionchanged documentation directives
Georg Brandl added the comment: These are interpreted as comments by docutils. "make suspicious" only checks for markup erroneously remaining in the output. "make check", which runs tools/rstlint.py, should pick them up though. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26435> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26423] __len__() returns 32 bit int on windows leading to overflows
Georg Brandl added the comment: You need to call `x.__len__()` explicitly. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26423> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26408] pep-8 requires a few corrections
Georg Brandl added the comment: -Consistency within one module or function is most important. +Consistency within one module or function is the most important. You left out "thing" from the patch; is that intended? -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26408> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26408] pep-8 requires a few corrections
Georg Brandl added the comment: I can't really comment on the grammar changes, but the rest looks good to me. This is not very smooth, in both versions: -Consistency within one module or function is most important. +Consistency within one module or function is the most important thing. -But most importantly: know when to be inconsistent -- sometimes the -style guide just doesn't apply. When in doubt, use your best +But more importantly: know when to be inconsistent -- sometimes the +style guide just isn't applicable. When in doubt, use your best (Consistency is already *most* important, but then comes something *more* important?) -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26408> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26366] Use “.. versionadded” over “.. versionchanged” where appropriate
Georg Brandl added the comment: > Well then, if this is the sort of place where the status quo is sacred, > then there is nothing more to discuss. That wasn't my intention when quoting the old documenting guide, it was just to show what the intent was (and still is), and that I didn't just invent it. As Fred says, the status quo is not sacred, but we are usually pragmatic and a nontrivial amount of weight is needed to change it. > But if anyone reading this is open to the idea, please re-read my previous > comment in this thread. The quoted LaTeX docs are clear, but I still > believe my “all changes = (deprecated-removed changes) + (added changes) + > (other changes)” interpretation makes more sense than the LaTeX definition. It's one interpretation, yes. My interpretation (which coincides with the one written back then by Fred) is that the versionchanged applies to the API item in whose block it occurs. And a function is not *added* by the addition of a parameter, it is *changed* by that. The parameter itself is not a marked- up API item. If the structure was like .. function:: foo(a, b) .. parameter:: a .. parameter:: b then adding a parameter c would definitely be marked up as .. parameter:: c .. versionadded: 3.x Anyway. You think your interpretation is better, others including myself prefer the current one. This is exactly the kind of argument where the status quo wins because the churn necessary to change is not justified. > It’s not my desire to be troublesome by making one more appeal. I simply > want to point out that just because somebody wrote the LaTeX definitions a > long time ago doesn’t mean that we cannot rewrite them. They were written > by somebody just like us, after all. Again, you're mistaking the reason I quoted them. > If it’s not obvious by now, I feel strongly about good semantic markup. > The purpose of semantic markup is to describe what something *is*. I just > think that changes form a hierarchy, with a generic “change” as something > of the base class, and “deprecated”, “removed”, and “added” as > specializations. That's a nice strawman -- we all feel semantic markup is important, and we are talking about nothing but semantic markup here. We're just discussing the interpretation of one aspect of the semantics. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26366> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26385] the call of tempfile.NamedTemporaryFile fails and leaves a file on the disk
Changes by Georg Brandl <ge...@python.org>: -- nosy: -georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26385> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26378] Typo in regex documentation
Georg Brandl added the comment: Thanks for the report! -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26378> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26366] Use “.. versionadded” over “.. versionchanged” where appropriate
Georg Brandl added the comment: The devguide should be updated, yes. And probably someone should look at the remaining versionadded's... -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26366> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26366] Use “.. versionadded” over “.. versionchanged” where appropriate
Georg Brandl added the comment: Hi Tony, thanks for the patch, and for the will to contribute. I'm not sure this patch should be merged though; the original intention was to use "versionadded" where the API item is completely new. So "The parameter x was added" in a function is using "versionchanged" because only an aspect of the function's signature was changed. There may be a bit of confusion because many people wrote changes, and not every change is reviewed by the same developers, but this is the original intent that I think we should not change wholesale. -- nosy: +georg.brandl ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26366> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: It's mostly for consistency. For example, ``int(x, 0)`` is defined by the docs as "interpret x as in a literal". Other bases have special cases as well, e.g. "0x" is accepted by base 16. In the current version of the conversions, the string is scanned for "_" before doing the more expensive allocation+copy. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Thanks, I hadn't looked at cdecimal yet - I was planning to ask you to do the necessary changes there :) But there are a few versions of this (e.g. converting unicode digits to ASCII) scattered throughout the codebase, it would make sense to consolidate on this occasion. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25726] sys.setprofile / sys.getprofile asymetry
Georg Brandl added the comment: Ok, this is because internally, sys.setprofile (or to be exact, PyEval_SetProfile) sets two things: a C function, and a "profileobj", which is the argument to setprofile(). sys.setprofile sets the C function to the "profile_trampoline", which supports calling Python profile functions. The profileobj is the Python profile function. The C profiler sets the C function to a different callback, and uses the profileobj for storing the reference to the Profiler object. sys.getprofile just returns the profileobj, which means that you can't save/restore the profiler state with the two functions when using cProfile. There is not much we can do here except for explicitly documenting this. -- assignee: -> docs@python components: +Documentation nosy: +docs@python ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue25726> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26355] Emit major version based canonical URLs for docs
Georg Brandl added the comment: So we'd have to add a tag? Should be easy. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26355> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Hm. On the one hand there is a spec, so it can be argued that underscores don't belong to Decimal. On the other hand, if we get Decimal literals at one point, there will be a strong argument for allowing underscores in them as in all other number literals. Although supporting them in strings can also be added at that time. -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: Raymond, you've also worked on Decimal - do you have an opinion on allowing underscores in Decimal(string) conversions? -- nosy: +rhettinger ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: New patch matching revision of PEP. -- Added file: http://bugs.python.org/file41892/numeric_underscores_v2.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: New patch with minimal doc updates. -- Added file: http://bugs.python.org/file41896/numeric_underscores_v4_full.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: This patch includes int(), float(), complex() operations, as well as _pydecimal. -- Added file: http://bugs.python.org/file41894/numeric_underscores_v3_full.diff ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25709] Problem with string concatenation and utf-8 cache.
Georg Brandl added the comment: Backpicked to 3.3. Sorry for the wait. -- resolution: -> fixed status: open -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue25709> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20741] Documentation archives should be available also in tar.xz format
Changes by Georg Brandl <ge...@python.org>: -- assignee: georg.brandl -> ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue20741> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue4173] PDF documentation: long verbatim lines are cut off at right hand side
Changes by Georg Brandl <ge...@python.org>: -- assignee: georg.brandl -> ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue4173> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue4145] tabulary entries in PDF documentation
Changes by Georg Brandl <ge...@python.org>: -- assignee: georg.brandl -> ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue4145> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue24668] Deprecate 00000 as a synonym for 0
Georg Brandl added the comment: Closing now. -- status: pending -> closed ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue24668> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue15693] expose glossary link on hover
Changes by Georg Brandl <ge...@python.org>: -- assignee: georg.brandl -> ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue15693> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue25709] Problem with string concatenation and utf-8 cache.
Georg Brandl added the comment: Actually I prefer Greg to Gerg, so it's only half bad. :D -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue25709> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue26331] Tokenizer: allow underscores for grouping in numeric literals
Georg Brandl added the comment: It sure is more strict, but I don't think it's simpler (and it's definitely not simpler to implement). (Also 1_j is pretty nice, I wouldn't want to lose that.) We can also check what other languages do. * Rust: very much like this, but trailing underscores allowed. * Perl 5: same as here, but underscores after dot and trailing underscores allowed. * Ruby: only between digits. * Swift: the grammar productions say it's basically the same as Rust. The textual description says "between digits". -- ___ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue26331> ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com