[issue13828] Further improve casefold documentation

Jim Jewett added the comment: Unicode probably won't make the correction, because of backwards compatibility. I do support the sentence suggested in Thorsten's most recent reply. Is expanding ligatures the only other normalization it does? Ideally, we should also mention that it shifts to the

[issue13828] Further improve casefold documentation

Thorsten added the comment: I see. I found the documents. That's an issue. That usage is incorrect. It is still valid to upper case "ß" to SS since "ẞ" is fairly new as an official German character, but the other way around is not valid. As such the current sentence in documentation also just

[issue13828] Further improve casefold documentation

Benjamin Peterson added the comment: Correctness of casefolding is defined by the Unicode standard, which currently states that "ß" folds to "ss". -- ___ Python tracker ___ __

[issue13828] Further improve casefold documentation

Thorsten added the comment: German example in casefolding is plain incorrect. #Casefolding is similar to lowercasing but more aggressive because it is #intended to remove all case distinctions in a string. For example, the #German lowercase letter 'ß' is equivalent to "ss". Since it is alread

[issue13828] Further improve casefold documentation

Cheryl Sabella added the comment: Assigning to @Mariatta for the sprints. -- assignee: docs@python -> Mariatta nosy: +Mariatta, cheryl.sabella stage: -> needs patch versions: +Python 3.7, Python 3.8 -Python 3.3 ___ Python tracker

[issue13828] Further improve casefold documentation

Marc Richter added the comment: +1 as well. To be honest, I did not understand what this function does in detail yet. Since not too long ago (2017) in Germany, there was an uppercase-variant for the special letter from this function's example (ß) been added to the official orthography [1]. Is

[issue13828] Further improve casefold documentation

Raymond Hettinger added the comment: > In addition to lowercasing, this function also expands ligatures, for > example, "fi" becomes "fi". +1 I would have found that sentence to be helpful. -- nosy: +rhettinger ___ Python tracker

[issue13828] Further improve casefold documentation

Mark Summerfield added the comment: I think the str.casefold() docs are fine as far as they go, rightly covering what it _does_ rather than _how_, yet providing a reference for the details. But what they lack is more complete information. For example I discovered this: >>> x = "files and shuffles

[issue13828] Further improve casefold documentation

Benjamin Peterson added the comment: It's a bit unfriendly to launch into discussion of "compatiblity caseless matching" when the new reader probably has no idea what "compatibility-equivalence" is. -- ___ Python tracker

[issue13828] Further improve casefold documentation

Jim Jewett added the comment: Frankly, I do think that sample code is too long, but correctness matters ... perhaps a better solution would be to add either a method or a unicodedata function that does the work, then the extra note could just say Note that most case-insensitive matches should

[issue13828] Further improve casefold documentation

New submission from Jim Jewett : > http://hg.python.org/cpython/rev/0b5ce36a7a24 > changeset:   74515:0b5ce36a7a24 > +   Casefolding is similar to lowercasing but more aggressive because it is > +   intended to remove all case distinctions in a string. For example, the > German > +   lowercase