8264398: BevelBorderUIResource​(int, Color, Color) and BevelBoder(int, Color, Color) spec should clarify about usage of highlight and shadow color

Reviewed-by: serb

Author: prsadhuk

src/java.desktop/share/classes/javax/swing/border/BevelBorder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 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
@@ -86,6 +86,10 @@ public BevelBorder(int bevelType) {
     /**
      * Creates a bevel border with the specified type, highlight and
      * shadow colors.
+     * The bevel outer highlight color and bevel inner highlight color
+     * will be derived from specified highlight color and
+     * bevel outer shadow color and bevel inner shadow color
+     * will be derived from specified shadow color.
      * @param bevelType the type of bevel for the border
      * @param highlight the color to use for the bevel highlight
      * @param shadow the color to use for the bevel shadow

src/java.desktop/share/classes/javax/swing/plaf/BorderUIResource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 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
@@ -219,6 +219,10 @@ public BevelBorderUIResource(int bevelType) {
 
         /**
          * Constructs a {@code BevelBorderUIResource}.
+         * The bevel outer highlight color and bevel inner highlight color
+         * will be derived from specified highlight color and
+         * bevel outer shadow color and bevel inner shadow color
+         * will be derived from specified shadow color.
          * @param bevelType the type of bevel for the border
          * @param highlight the color to use for the bevel highlight
          * @param shadow the color to use for the bevel shadow