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

Jump to bottom

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

Closed
wants to merge 3 commits into from
+38 −2
Closed

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

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b520341
8261621: Delegate Unicode history from JLS to j.l.Character
naotoj Feb 12, 2021
b94b41c
Removed empty <p> tag
naotoj Feb 12, 2021
c90cd66
Added a text about the variations from the base Unicode versions.
naotoj Feb 17, 2021
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
40 src/java.base/share/classes/java/lang/Character.java
View file
Open in desktop
@@ -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