Skip to content

Commit

Permalink
Little more explanation around explicit character set + fix typos
Browse files Browse the repository at this point in the history
  • Loading branch information
mrotteveel committed Jan 6, 2017
1 parent 6ae0926 commit 5bb9363
Showing 1 changed file with 11 additions and 7 deletions.
18 changes: 11 additions & 7 deletions src/documentation/release_notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -588,8 +588,8 @@ encoding, charSet or localEncoding). Please specify a connection character set
information."_ ([JDBC-446](http://tracker.firebirdsql.org/browse/JDBC-446))

In Jaybird 2.2 and earlier, Jaybird would default to connection character set
`NONE` if no character set had been specified (through `lc_ctype`/`encoding`
and/or `charSet`/`localEncoding`). This can result in incorrect character set
`NONE` if no character set had been specified (through `encoding`
and/or `charSet`). This can result in incorrect character set
handling when the database is used from different locales.

To address this change, explicitly set the connection character set using
Expand All @@ -598,13 +598,17 @@ one of the following options:
* Use connection property `encoding` (or `lc_ctype`) with a Firebird character
set name.

Use `encoding=NONE` for the 'old' default behavior (with some caveats, see
Use `encoding=NONE` for the old default behavior (with some caveats, see
other sections).

* Use connection property `charSet` (or `localEncoding`) with a Java character
set name.

* Use a combination of `encoding` and `charSet`, if you want to reinterpret a
Firebird character set in a Java character set other than the default
mapping.

* By providing a default character set with system property
* By providing a default Firebird character set with system property
`org.firebirdsql.jdbc.defaultConnectionEncoding`. Jaybird will apply the
specified character set as the default when no character set is specified
in the connection properties.
Expand Down Expand Up @@ -636,7 +640,7 @@ Exceptions
sub-classes anymore, but in general we strive to use the standard
exceptions where possible.

* Class `FBSQLWarning` has been removed and replaced with `SQLWarning`.
* Class `FBSQLWarning` has been removed and replaced with `java.sql.SQLWarning`.

* Methods with `throws FBSQLException` changed to `throws SQLException`

Expand Down Expand Up @@ -1044,9 +1048,9 @@ The following methods will be removed in Jaybird 3.1:
- `GDSHelper.iscVaxLong(byte[] buffer, int pos, int length)` use
`VaxEncoding.iscVaxLong(byte[] buffer, int startPosition, int length)`
instead.
- `MaintenaceManager.commitTransaction(int transactionId)`, use
- `MaintenanceManager.commitTransaction(int transactionId)`, use
`MaintenanceManager.commitTransaction(long transactionId)` instead.
- `MaintenaceManager.rollbackTransaction(int transactionId)`, use
- `MaintenanceManager.rollbackTransaction(int transactionId)`, use
`MaintenanceManager.rollbackTransaction(long transactionId)` instead.

### Removal of deprecated constants ###
Expand Down

0 comments on commit 5bb9363

Please sign in to comment.