You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2010/03/18 15:40:27 UTC
[jira] Created: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
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
Priority: Minor
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.
Re: [jira] Created: (DERBY-4591) Documentation needed for global case-insensitive setting (DERBY-1748)
Posted by Gunnar Grim <gg...@grim.se>.
Thursday 18 March 2010 15.40.27 skrev Kim Haase (JIRA):
> 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
> Priority: Minor
>
>
> 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.
>
I have now added an attachment to the issue, with suggested text for the developers guide.
Gunnar
Re: [jira] Created: (DERBY-4591) Documentation needed for global case-insensitive setting (DERBY-1748)
Posted by Gunnar Grim <gg...@grim.se>.
Another attachment added, with suggested text for the reference manual.
Gunnar
[jira] Resolved: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-4591.
------------------------------
Resolution: Fixed
Committed patch DERBY-4591-2.diff to documentation trunk at revision 936999.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.
[jira] Assigned: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase reassigned DERBY-4591:
--------------------------------
Assignee: Kim Haase
> 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
>
> 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.
[jira] Updated: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4591:
-----------------------------
Issue & fix info: [Patch Available]
> 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
> 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.
[jira] Closed: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase closed DERBY-4591.
----------------------------
Closing, since changes have appeared in Latest Alpha Manuals.
> 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.1.0
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Fix For: 10.6.1.0
>
> Attachments: DERBY-4591-2.diff, DERBY-4591-4.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html, tdevdvlpcollation.html
>
>
> 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.
[jira] Reopened: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase reopened DERBY-4591:
------------------------------
Thanks for the additional comments, Knut. It would be good to get this info into the documentation, so I'm reopening the issue to make that change.
> 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.
[jira] Updated: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4591:
-----------------------------
Attachment: DERBY-4591-4.diff
tdevdvlpcollation.html
Using à with the correct LANG setting does work for both HTML and PDF, as you said (I think I knew this at some point but forgot!).
So I'm attaching DERBY-4591-4.diff and the output file, tdevdvlpcollation.html. Will commit soon.
> 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-2.diff, DERBY-4591-4.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html, tdevdvlpcollation.html
>
>
> 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.
[jira] Updated: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4591:
-----------------------------
Attachment: DERBY-4591-2.diff
rrefattribcollation.html
Attaching DERBY-4591-2.diff and rrefattribcollation.html, with changes to the collation attribute topic of the Reference Manual. I changed the wording of the suggested changes so that the order and syntax are parallel.
I'll commit this soon.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.
[jira] Commented: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12860248#action_12860248 ]
Kim Haase commented on DERBY-4591:
----------------------------------
Thanks, Knut, for the reminder about the environment.
I think this may be hopeless -- the same thing happens both with the simple text editor I usually use (the one in CDE --- very old) and NetBeans. There seems to be no way to control what format the editor saves in. I don't think it looks at the header at all.
In both editors I used Compose-a-backtick to create what in the editor looked like an a with a grave accent, but in my terminal with the LANG variable set to en_US.UTF-8, it turned into an A with a tilde in a Solaris terminal window and a Greek lowercase alpha in a Windows command prompt window (when I did a grep for another word in the line that contained it). And of course I still get the "Invalid byte 2 of 3-byte UTF-8 sequence" error.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.
[jira] Updated: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4591:
-----------------------------
Attachment: DERBY-4591.zip
DERBY-4591.stat
DERBY-4591.diff
Attaching DERBY-4591.diff, DERBY-4591.stat, and DERBY-4591.zip, with changes to two collation topics in the Developer's Guide and one in the Reference Manual. In addition to the changes noted in the files refman.txt and devguide.txt attached to DERBY-1748, I made some corrections in the "Character-based collation in Derby" topic, and added some cross-references among the three topics.
Thanks in advance for feedback!
> 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
> Attachments: 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.
[jira] Reopened: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase reopened DERBY-4591:
------------------------------
Very sorry, one more thing. I was going to add that the reason I did not adopt the second suggestion is that the escape sequences look fine in the output HTML docs but show up as just "#" in the PDF. And I didn't think I had a way to type letters with accent marks directly in my environment -- but I just experimented with the "Compose" key on my keyboard and I think I figured it out. So what the heck. Patch 3 coming up.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.
[jira] Resolved: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-4591.
------------------------------
Resolution: Fixed
Fix Version/s: 10.6.0.0
Issue & fix info: (was: [Patch Available])
Committed patch DERBY-4591.diff to documentation trunk at revision 932066.
Feel free to reopen this issue if more work is needed.
> 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.
[jira] Commented: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12852848#action_12852848 ]
Kim Haase commented on DERBY-4591:
----------------------------------
I plan to commit this patch in a couple of working days if I don't get any requests for changes.
> 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
> 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.
[jira] Commented: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Knut Anders Hatlen (JIRA)" <ji...@apache.org>.
[ 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.
[jira] Resolved: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-4591.
------------------------------
Resolution: Fixed
Committed patch DERBY-4591-4.diff to documentation trunk at revision 937540. (There was no DERBY-4591-3.diff; I'm afraid I lost count.)
> 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-2.diff, DERBY-4591-4.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html, tdevdvlpcollation.html
>
>
> 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.
[jira] Updated: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4591:
-----------------------------
Attachment: DERBY-4591.zip
DERBY-4591.diff
Attaching revised versions of DERBY-4591.diff and DERBY-4591.zip to include Gunnar's suggestion about mentioning compatibility with other databases.
> 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
> 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.
[jira] Commented: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Knut Anders Hatlen (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12860183#action_12860183 ]
Knut Anders Hatlen commented on DERBY-4591:
-------------------------------------------
Hi Kim. I don't see this error if I add 'à' and save the file with UTF-8 encoding. I do see the same error if I save the file with ISO-8859-1 encoding. My text editor (Emacs) automatically picks the correct file encoding based on the header in the XML file, which says:
<?xml version="1.0" encoding="utf-8"?>
If you cannot get your editor to save as UTF-8, you may change the header to say ISO-8859-1 instead, and it should work.
As to using escape sequences, the character showed up just fine in the PDF version when I tried. What's the locale you're using? According to http://db.apache.org/derby/manuals/dita.html#Setting+up+your+environment, you need to set the LANG variable to en_US.UTF-8.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.
[jira] Commented: (DERBY-4591) Documentation needed for global
case-insensitive setting (DERBY-1748)
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4591?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12859975#action_12859975 ]
Kim Haase commented on DERBY-4591:
----------------------------------
Putting the à character in the source file works, but when I try to build the book I get a DITA error:
[pipeline] [Fatal Error] tdevdvlpcollation.dita:54:13: Invalid byte 2 of 3-byte UTF-8 sequence.
[pipeline] org.xml.sax.SAXParseException: Invalid byte 2 of 3-byte UTF-8 sequence.
Does anyone know how to solve this problem? If not, we may as well leave the Dev Guide topic as is.
> 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-2.diff, DERBY-4591.diff, DERBY-4591.diff, DERBY-4591.stat, DERBY-4591.zip, DERBY-4591.zip, rrefattribcollation.html
>
>
> 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.