Opened 7 years ago

Closed 7 years ago

Last modified 7 years ago

#10377 closed (fixed)

Improve database notes with respect to cx_Oracle 5.0 Unicode bug

Reported by: ubernostrum Owned by: ubernostrum
Component: Documentation Version: 1.0
Severity: Keywords:
Cc: ikelly Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Since #9935 documented multiple people getting bit by a Unicode-corrupting bug in cx_Oracle 5.0, it might be a good idea to have the database notes section of the docs be a bit more clear on the fact that 5.0 should not be used (currently it says, misleadingly, "4.3.1 or later" in one place, while stating the requirement of 4.x further back in the paragraph.

The attached patch tries to make this clear, and also recommends cx_Oracle 5.0.1 which, per upstream announce, resolved the bug.

If one of our Oracle gurus (I'm cc'ing Ian on this) could verify the text (and maybe double-check against 5.0.1 to make sure it really did fix things), I'll commit this and do a backport into the 1.0.x docs as well.

Attachments (1)

cx_oracle-note.diff (1.1 KB) - added by ubernostrum 7 years ago.
Patch which breaks 5.0 warning out into a separate paragraph

Download all attachments as: .zip

Change History (4)

Changed 7 years ago by ubernostrum

Patch which breaks 5.0 warning out into a separate paragraph

comment:1 Changed 7 years ago by ikelly

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

I've run the test suite against cx_Oracle 5.0.1 and found no problems, so I think we're good there. The text looks good to me, except that we also mention cx_Oracle versions in docs/topcis/install.txt; that should be updated as well.

comment:2 Changed 7 years ago by ubernostrum

  • Resolution set to fixed
  • Status changed from new to closed

(In [9922]) Fixed #10377: Added clearer warning to database notes for cx_Oracle 5.0.

comment:3 Changed 7 years ago by ubernostrum

(In [9923]) [1.0.X] Fixed #10377: Added clearer warning to database notes for cx_Oracle 5.0.

Note: See TracTickets for help on using tickets.
Back to Top