Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

8261621: Delegate Unicode history from JLS to j.l.Character #2538

Closed
wants to merge 3 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
@@ -1,5 +1,5 @@
/*
* Copyright (c) 2002, 2020, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2002, 2021, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -63,7 +63,43 @@
* <a href="http://www.unicode.org">http://www.unicode.org</a>.
* <p>
* Character information is based on the Unicode Standard, version 13.0.
*
* <p>
* The Java platform has supported different versions of the Unicode
* Standard over time. Upgrades to newer versions of the Unicode Standard
* occurred in the following Java releases, each indicating the new version:
* <table class="striped">
* <caption style="display:none">Shows Java releases and supported Unicode versions</caption>
* <thead>
* <tr><th scope="col">Java release</th>
* <th scope="col">Unicode version</th></tr>
* </thead>
* <tbody>
* <tr><td>Java SE 15</td>
* <td>Unicode 13.0</td></tr>
* <tr><td>Java SE 13</td>
* <td>Unicode 12.1</td></tr>
* <tr><td>Java SE 12</td>
* <td>Unicode 11.0</td></tr>
* <tr><td>Java SE 11</td>
* <td>Unicode 10.0</td></tr>
* <tr><td>Java SE 9</td>
* <td>Unicode 8.0</td></tr>
Copy link
Contributor

@AlanBateman AlanBateman Feb 12, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need the history in the API docs? Will will update this table if there is a MR of the JSR for Java 8 that moves to a new Unicode release?

Copy link
Member Author

@naotoj naotoj Feb 12, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was requested by Alex, and I thought it sounded reasonable and informative. I think if an MR upgrades the supported Unicode version, it should be listed here.

Copy link
Member

@jddarcy jddarcy Feb 12, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should some acknowledgement be made to the changes in Unicode support done by the Java SE 8 and Java SE 11 MRs with respect to extensions of the base Unicode version?

Copy link
Member Author

@naotoj naotoj Feb 12, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about that but decided not to include them here because the changes made in those MRs were not Unicode version upgrades (i.e., version stayed the same). Let me know if you think otherwise.

* <tr><td>Java SE 8</td>
* <td>Unicode 6.2</td></tr>
* <tr><td>Java SE 7</td>
* <td>Unicode 6.0</td></tr>
* <tr><td>Java SE 5.0</td>
* <td>Unicode 4.0</td></tr>
* <tr><td>Java SE 1.4</td>
* <td>Unicode 3.0</td></tr>
* <tr><td>JDK 1.1</td>
* <td>Unicode 2.0</td></tr>
* <tr><td>JDK 1.0.2</td>
* <td>Unicode 1.1.5</td></tr>
* </tbody>
* </table>
* Variations from these base Unicode versions, such as recognized appendixes,
* are documented elsewhere.
* <h2><a id="unicode">Unicode Character Representations</a></h2>
*
* <p>The {@code char} data type (and therefore the value that a