[OpenJDK 2D-Dev] RFR: 8166034: [macosx] Non-AA Serif font always displays as regular - no bold or oblique.

[Philip Race]

https://bugs.openjdk.java.net/browse/JDK-8166034

Non-AA fonts aren't always being bolded on OS X.
FWIW I believe this is in part a platform (OS) bug since it is terribly 
inconsistent
across fonts and in some cases even sizes.

So we need to look into why but it definitely isn't something that
calls for changing the font used by the Motif L&F as proposed here
http://mail.openjdk.java.net/pipermail/swing-dev/2016-October/006732.html

And it calls out something I've seen a few times recently and I've
documented some examples in the bug report.
So we need to explain in the java.awt.Font spec. that sometimes
we are beholden to the limits of the platform.

Investigating specific issues then become quality bugs .. but not 
conformance ones.

Added class description text below :-

-phil.

diff --git a/src/java.desktop/share/classes/java/awt/Font.java 
b/src/java.desktop/share/classes/java/awt/Font.java
--- a/src/java.desktop/share/classes/java/awt/Font.java
+++ b/src/java.desktop/share/classes/java/awt/Font.java
@@ -154,6 +154,13 @@
   * associated with a font face, each differing in size, style, transform
   * and font features.
   * <p>
+ * The visual rendering of all, or part of, one logical font vis-a-vis 
another
+ * may not always be different where there are limited suitable fonts 
available.
+ * The same is true for one style vis-a-vis another. This is generally
+ * due to one form or another of platform limitation or behavior.
+ * In the absence of such limitations a compliant implementation
+ * will render glyphs which exhibit the requested properties.
+ * <p>
   * The {@link GraphicsEnvironment#getAllFonts() getAllFonts} method
   * of the {@code GraphicsEnvironment} class returns an
   * array of all font faces available in the system. These font faces are