[ 
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 significant.
 - 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 "à", 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: 10.6.0.0
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>             Fix For: 10.6.0.0
>
>         Attachments: DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, 
> DERBY-4591.zip, 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.

Reply via email to