src/share/classes/java/awt/ComponentOrientation.java

*** 1,7 ****
  /*
!  * Copyright (c) 1998, 2006, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1998, 2014, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 124,151 ****
--- 124,154 ----
  
      /**
       * Are lines horizontal?
       * This will return true for horizontal, left-to-right writing
       * systems such as Roman.
+      * @return  {@code true} if this orientation has horizontal lines
       */
      public boolean isHorizontal() {
          return (orientation & HORIZ_BIT) != 0;
      }
  
      /**
       * HorizontalLines: Do items run left-to-right?<br>
       * Vertical Lines:  Do lines run left-to-right?<br>
       * This will return true for horizontal, left-to-right writing
       *         systems such as Roman.
+      * @return {@code true} if this orientation is left-to-right
       */
      public boolean isLeftToRight() {
          return (orientation & LTR_BIT) != 0;
      }
  
      /**
       * Returns the orientation that is appropriate for the given locale.
       * @param locale the specified locale
+      * @return  the orientation for the locale
       */
      public static ComponentOrientation getOrientation(Locale locale) {
          // A more flexible implementation would consult a ResourceBundle
          // to find the appropriate orientation.  Until pluggable locales
          // are introduced however, the flexiblity isn't really needed.
*** 169,178 ****
--- 172,183 ----
       * <li>Use the ResourceBundle.getLocale to determine the bundle's
       *      locale, then return the orientation for that locale.
       * <li>Return the default locale's orientation.
       * </ol>
       *
+      * @param bdl  the bundle to use
+      * @return  the orientation
       * @deprecated As of J2SE 1.4, use {@link #getOrientation(java.util.Locale)}.
       */
      @Deprecated
      public static ComponentOrientation getOrientation(ResourceBundle bdl)
      {