[
https://issues.apache.org/jira/browse/DERBY-4627?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Kim Haase updated DERBY-4627:
-----------------------------
Attachment: DERBY-4627.zip
DERBY-4627.stat
DERBY-4627.diff
Attaching DERBY-4627.diff, DERBY-4627.stat, and DERBY-4627.zip, with the
following changes:
A src/devguide/tdevdvlpcustomcollation.dita
A src/devguide/cdevcollationattribs.dita
A src/devguide/cdevcollationlikeequal.dita
A src/devguide/tdevdvlpcaseinscoll.dita
A src/devguide/cdevcollationlocale.dita
M src/devguide/tdevdvlpcollation.dita
M src/devguide/derbydev.ditamap
A src/devguide/cdevcollationoverview.dita
M src/devguide/cdevcollation.dita
I split "Creating a database with locale-based collation" into two topics,
making "Creating a case-insensitive database" a separate topic, and added a new
one, "Creating a customized collator" (should that be "CollatorProvider", or
some other term?), shamelessly scavenging from Knut's very helpful blog article.
I also split the topic near the end, "Character-based collation in Derby", into
four subtopics: "How collation works in Derby", "Locale-based collation",
"Database connection URL attributes that control collation", and "Differences
between LIKE and equal (=) comparisons". So I hope these topics related to
locales and collation are more visible.
I also added to the reltable for the book so that each topic includes links to
related topics at the bottom.
I made some corrections as it seemed appropriate. For example, the "Collation
examples" subtopic used to say, "UCS_BASIC collation sorts all lowercase
letters before uppercase letters." But when I tried it, I found that the
opposite was actually the case.
Please let me know what changes are needed. Thanks in advance.
> Document how to install your own custom collation for use in sorting and
> comparing string data values.
> ------------------------------------------------------------------------------------------------------
>
> Key: DERBY-4627
> URL: https://issues.apache.org/jira/browse/DERBY-4627
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.6.1.0
> Reporter: Rick Hillegas
> Assignee: Kim Haase
> Attachments: DERBY-4627.diff, DERBY-4627.stat, DERBY-4627.zip
>
>
> The Developer's Guide suggests that you are limited to the collations shipped
> with the JRE. Consider, for instance, this sentence in the section titled
> "Character-based collation in Derby":
> "Derby currently supports only running those rules that can be loaded
> dynamically from the running JVM based on the territory attribute. Overrides
> to these rules by the user are not supported."
> This is misleading. A long time ago, Knut wrote a blog explaining how to
> write your own custom collation, plug it into the JRE, and then use it on
> string data stored in Derby:
> http://blogs.sun.com/kah/entry/user_defined_collation_in_apache
> This is a very useful capability of Derby. We should document it.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
