This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Greg Price
Recipients Greg Price, ezio.melotti, vstinner
Date 2019-08-15.04:40:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1565844026.38.0.454772996752.issue37864@roundup.psfhosted.org>
In-reply-to
Content
While working on #36502 and then #18236 about the definition and docs of str.isspace(), I looked closely also at its neighbor str.isprintable().

It turned out that we have the definition of what makes a character "printable" documented in three places, giving two different definitions.
    
The definition in the comment on `_PyUnicode_IsPrintable` is inverted, so that's an easy small fix.
    
With that correction, the two definitions turn out to be equivalent -- but to confirm that, you have to go look up, or happen to know, that those are the only five "Other" categories and only three "Separator" categories in the Unicode character database.  That makes it hard for the reader to tell whether they really are the same, or if there's some subtle difference in the intended semantics.

I've taken a crack at writing some improved docs text for a single definition, borrowing ideas from the C comment as well as the existing docs text; and then pointing there from the other places we'd had definitions. PR coming shortly.
History
Date User Action Args
2019-08-15 04:40:26Greg Pricesetrecipients: + Greg Price, vstinner, ezio.melotti
2019-08-15 04:40:26Greg Pricesetmessageid: <1565844026.38.0.454772996752.issue37864@roundup.psfhosted.org>
2019-08-15 04:40:26Greg Pricelinkissue37864 messages
2019-08-15 04:40:25Greg Pricecreate