[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-05 Thread Tim Peters
Tim Peters added the comment: Terry, your suggested replacement statement looks like an improvement to me. Perhaps the longer explanation could be placed in a footnote. Note that I'm old ;-) I grew up on plain old ASCII, decades & decades ago, and tabs are in fact the only "characters" I've

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-05 Thread Terry J. Reedy
Terry J. Reedy added the comment: I have an alternate replacement: "These lines can be confusing if the sequences contain tab characters or other characters that result in the indicator symbols in these lines being mislocated." Or leave the current sentence as is. Explanation with the

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-03 Thread Jürgen Gmach
Jürgen Gmach added the comment: First I need to apologize for not providing more info already when I created the issue. Initially, I did not even plan to create an issue, and thought the PR with the context of the current documentation would be sufficient information. Thanks for taking your

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-03 Thread Terry J. Reedy
Terry J. Reedy added the comment: After 3+ years of Github I did not remember that B diffs use lines with change position markers and in particular that at they (often? always?) start with ?s. IDLE also uses color to mark positions (for syntax errors). The following would have been clearer

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-02 Thread Tim Peters
Tim Peters added the comment: Lines beginning with "?" are entirely synthetic: they were not present in either input. So that's what that part means. I'm not clear on what else could be materially clearer without greatly bloating the text. For example, >>> d = difflib.Differ() >>> for L

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-02 Thread Terry J. Reedy
Terry J. Reedy added the comment: The quote is in the following section. https://docs.python.org/3/library/difflib.html#difflib.Differ I do not really understand the previous line "Lines beginning with ‘?’ attempt to guide the eye to intraline differences, and were not present in either input

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-01 Thread Karthikeyan Singaravelan
Change by Karthikeyan Singaravelan : -- nosy: +tim.peters ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue43689] difflib: mention other "problematic" characters in documentation

2021-04-01 Thread Jürgen Gmach
New submission from Jürgen Gmach : In the documentation you can currently read for the "?"-output: "These lines can be confusing if the sequences contain tab characters." >From first hand experience :-), I can assure it is also very confusing for >other types of whitespace characters, such as