db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Knut Anders Hatlen (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-4591) Documentation needed for global case-insensitive setting (DERBY-1748)
Date Fri, 09 Apr 2010 07:27:52 GMT

    [ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12855305#action_12855305

Knut Anders Hatlen commented on DERBY-4591:

Hi Kim,
The docs look good. Thanks for writing them!

I've got a couple of ideas for some minor improvements:

1) Reference manual: In the list of valid attribute values, I think it would be good to add
one sentence explaining the typical meaning of the different strengths. For example:
 - PRIMARY typically means that only differences in the base letter are considered significant,
case and accents are not considered significant.
 - SECONDARY typically means that case differences are not considered significant, whereas
differences in base letters or accents are significant.
 - TERTIARY typically means that differences in the base letter, accents or case are all considered
 - IDENTICAL means that all differences are considered significant.

2) tdevdvlpcollation: The "'a' with grave" part could be written as "'à' ('a' with grave)"
for clarity. (The escape sequence for "à" is "&#224;", if you would like to avoid non-ascii
characters in the source file, although it should be fine to type the character directly and
save as UTF-8, see the declaration of encoding in the header.)

Otherwise, the changes look great.

> Documentation needed for global case-insensitive setting (DERBY-1748)
> ---------------------------------------------------------------------
>                 Key: DERBY-4591
>                 URL: https://issues.apache.org/jira/browse/DERBY-4591
>             Project: Derby
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions:
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>             Fix For:
>         Attachments: DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip,
> The new feature implemented by DERBY-1748 needs to be documented. It appears that the
following topics will need to be changed, at least:
> Reference Manual: collation=collation attribute
> Developer's Guide: "Creating a database with territory-based collation", "Character-based
collation in Derby". 
> It's pretty hard to tell from all the discussion under DERBY-1748 exactly what has changed
and what the new feature does, so a functional spec for that issue that describes the new
feature clearly would be very helpful.

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message