Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Message-ID: <1550630585.3021270798072226.JavaMail.jira@brutus.apache.org>
Date: Fri, 9 Apr 2010 07:27:52 +0000 (UTC)
From: "Knut Anders Hatlen (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Subject: [jira] Commented: (DERBY-4591) Documentation needed for global
 case-insensitive setting (DERBY-1748)
In-Reply-To: <1817640107.342761268923227296.JavaMail.jira@brutus.apache.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable


    [ https://issues.apache.org/jira/browse/DERBY-4591?page=3Dcom.atlassian=
.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=3D1285=
5305#action_12855305 ]=20

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 woul=
d be good to add one sentence explaining the typical meaning of the differe=
nt strengths. For example:
 - PRIMARY typically means that only differences in the base letter are con=
sidered significant, case and accents are not considered significant.
 - SECONDARY typically means that case differences are not considered signi=
ficant, 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 "'=C3=
=A0' ('a' with grave)" for clarity. (The escape sequence for "=C3=A0" 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: 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, D=
ERBY-4591.zip, DERBY-4591.zip
>
>
> The new feature implemented by DERBY-1748 needs to be documented. It appe=
ars that the following topics will need to be changed, at least:
> Reference Manual: collation=3Dcollation attribute
> Developer's Guide: "Creating a database with territory-based collation", =
"Character-based collation in Derby".=20
> 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 t=
hat issue that describes the new feature clearly would be very helpful.

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