changeset 10901:b942977b44eb

8200587: Fix mistakes in FX API docs Reviewed-by: kcr
author nlisker
date Fri, 13 Apr 2018 07:34:46 -0700
parents f7643f961ac6
children f7e879441509
files modules/javafx.base/src/main/java/javafx/beans/InvalidationListener.java modules/javafx.base/src/main/java/javafx/beans/value/ChangeListener.java modules/javafx.controls/src/main/java/javafx/scene/control/Dialog.java modules/javafx.graphics/src/main/java/javafx/scene/Node.java modules/javafx.graphics/src/main/java/javafx/scene/input/MouseEvent.java modules/javafx.graphics/src/main/java/javafx/scene/layout/AnchorPane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/BorderPane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/FlowPane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/GridPane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java modules/javafx.graphics/src/main/java/javafx/scene/layout/Pane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/StackPane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/TilePane.java modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java modules/javafx.graphics/src/main/java/javafx/scene/layout/package.html modules/javafx.graphics/src/main/java/javafx/scene/shape/Box.java modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java
diffstat 17 files changed, 91 insertions(+), 74 deletions(-) [+]
line wrap: on
line diff
--- a/modules/javafx.base/src/main/java/javafx/beans/InvalidationListener.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.base/src/main/java/javafx/beans/InvalidationListener.java	Fri Apr 13 07:34:46 2018 -0700
@@ -53,7 +53,7 @@
      * {@code InvalidationListener}. It is called if an {@link Observable}
      * becomes invalid.
      * <p>
-     * In general is is considered bad practice to modify the observed value in
+     * In general, it is considered bad practice to modify the observed value in
      * this method.
      *
      * @param observable
--- a/modules/javafx.base/src/main/java/javafx/beans/value/ChangeListener.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.base/src/main/java/javafx/beans/value/ChangeListener.java	Fri Apr 13 07:34:46 2018 -0700
@@ -50,7 +50,7 @@
      * {@code ChangeListener}. It is called if the value of an
      * {@link ObservableValue} changes.
      * <p>
-     * In general is is considered bad practice to modify the observed value in
+     * In general, it is considered bad practice to modify the observed value in
      * this method.
      *
      * @param observable
--- a/modules/javafx.controls/src/main/java/javafx/scene/control/Dialog.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.controls/src/main/java/javafx/scene/control/Dialog.java	Fri Apr 13 07:34:46 2018 -0700
@@ -101,11 +101,12 @@
  * on if the {@link DialogPane#createButton(ButtonType)} method has been overridden. A
  * typical approach is therefore along the following lines:
  *
- * <pre>{@code ButtonType loginButtonType = new ButtonType("Login", ButtonData.OK_DONE);
- * Dialog<String> dialog = new Dialog<>();
- * dialog.getDialogPane().getButtonTypes().add(loginButtonType);
- * boolean disabled = false; // computed based on content of text fields, for example
- * dialog.getDialogPane().lookupButton(loginButtonType).setDisable(disabled);}</pre>
+ * <pre>{@code
+ *     ButtonType loginButtonType = new ButtonType("Login", ButtonData.OK_DONE);
+ *     Dialog<String> dialog = new Dialog<>();
+ *     dialog.getDialogPane().getButtonTypes().add(loginButtonType);
+ *     boolean disabled = false; // computed based on content of text fields, for example
+ *     dialog.getDialogPane().lookupButton(loginButtonType).setDisable(disabled);}</pre>
  *
  * <p>Once a Dialog is instantiated and fully configured, the next step is to
  * show it. More often than not, dialogs are shown in a modal and blocking
@@ -125,20 +126,23 @@
  * equally valid ways of showing a dialog:
  *
  * <p><strong>Option 1: The 'traditional' approach</strong>
- * <pre>{@code Optional<ButtonType> result = dialog.showAndWait();
+ * <pre>{@code
+ * Optional<ButtonType> result = dialog.showAndWait();
  * if (result.isPresent() && result.get() == ButtonType.OK) {
  *     formatSystem();
  * }}</pre>
  *
  * <p><strong>Option 2: The traditional + Optional approach</strong>
- * <pre>{@code dialog.showAndWait().ifPresent(response -> {
+ * <pre>{@code
+ * dialog.showAndWait().ifPresent(response -> {
  *     if (response == ButtonType.OK) {
  *         formatSystem();
  *     }
  * });}</pre>
  *
  * <p><strong>Option 3: The fully lambda approach</strong>
- * <pre>{@code dialog.showAndWait()
+ * <pre>{@code
+ * dialog.showAndWait()
  *      .filter(response -> response == ButtonType.OK)
  *      .ifPresent(response -> formatSystem());}</pre>
  *
@@ -1008,7 +1012,7 @@
 
     // This code is called both in the normal and in the abnormal case (i.e.
     // both when a button is clicked and when the user forces a window closed
-    // with keyboard OS-specific shortchuts or OS-native titlebar buttons).
+    // with keyboard OS-specific shortcuts or OS-native titlebar buttons).
     @SuppressWarnings("unchecked")
     void setResultAndClose(ButtonType cmd, boolean close) {
         Callback<ButtonType, R> resultConverter = getResultConverter();
--- a/modules/javafx.graphics/src/main/java/javafx/scene/Node.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/Node.java	Fri Apr 13 07:34:46 2018 -0700
@@ -307,7 +307,7 @@
  * A <b>scaling</b> transformation causes a node to either appear larger or
  * smaller depending on the scaling factor. Scaling alters the coordinate space
  * of the node such that each unit of distance along the axis in local
- * coordinates is multipled by the scale factor. As with rotation
+ * coordinates is multiplied by the scale factor. As with rotation
  * transformations, scaling transformations are applied about a "pivot" point.
  * You can think of this as the point in the Node around which you "zoom".  For
  * example, if you create a {@link javafx.scene.shape.Rectangle} with a
@@ -2071,7 +2071,7 @@
     private void doLayoutPass() {
         if (this instanceof Parent) {
             // TODO: As an optimization we only need to layout those dirty
-            // roots that are descendents of this node
+            // roots that are descendants of this node
             Parent p = (Parent)this;
             for (int i = 0; i < 3; i++) {
                 p.layout();
@@ -3245,7 +3245,7 @@
      *
      * For perspective camera, this method first exams node's bounds against
      * camera's clipping plane to cut off those out of viewing frustrum. After
-     * computing areaInScreen, it applys a tight viewing frustrum check using
+     * computing areaInScreen, it applies a tight viewing frustrum check using
      * canonical view volume.
      *
      * The result of areaInScreen comes from the product of
@@ -3332,7 +3332,7 @@
                     tempTx.preConcatenate(camera.getSceneToLocalTransform());
                     tempTx.transform(localBounds, nodeInCameraBounds);
 
-                    // Compare in camera coornidate
+                    // Compare in camera coordinate
                     if (nodeInCameraBounds.getMinZ() > camera.getFarClip()
                             || nodeInCameraBounds.getMaxZ() < camera.getNearClip()) {
                         return 0;
@@ -3768,7 +3768,7 @@
             return computeLocalBounds(bounds, tx);
         } else {
             // 3D transformations and
-            // selected 2D transformations (unifrom transform, flip, quadrant rotation).
+            // selected 2D transformations (uniform transform, flip, quadrant rotation).
             // These 2D transformation will yield tight bounds when applied on the pre-computed
             // geomBounds
             // Note: Transforming the local bounds into a 3D space will yield a bounds
@@ -4278,9 +4278,11 @@
     /**
      * Transforms a point from the coordinate space of the scene
      * into the local coordinate space of this {@code Node}.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the arguments are in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #sceneToLocal(double, double)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * arguments are in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #sceneToLocal(double, double)}.
+     *
      * @param x the x coordinate
      * @param y the y coordinate
      * @param rootScene whether Scene coordinates should be used even if the Node is in a SubScene
@@ -4317,9 +4319,11 @@
     /**
      * Transforms a point from the coordinate space of the scene
      * into the local coordinate space of this {@code Node}.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the arguments are in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #sceneToLocal(javafx.geometry.Point2D)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * arguments are in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #sceneToLocal(javafx.geometry.Point2D)}.
+     *
      * @param point the point
      * @param rootScene whether Scene coordinates should be used even if the Node is in a SubScene
      * @return local coordinates of the point
@@ -4332,8 +4336,9 @@
     /**
      * Transforms a bounds from the coordinate space of the scene
      * into the local coordinate space of this {@code Node}.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the arguments are in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * arguments are in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
      * {@link #sceneToLocal(javafx.geometry.Bounds)}.
      * <p>
      *     Since 3D bounds cannot be converted with {@code rootScene} set to {@code true}, trying to convert 3D bounds will yield {@code null}.
@@ -4632,9 +4637,10 @@
     /**
      * Transforms a point from the local coordinate space of this {@code Node}
      * into the coordinate space of its scene.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the result point is in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #localToScene(javafx.geometry.Point3D)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * result point is in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #localToScene(javafx.geometry.Point3D)}.
      *
      * @param localPoint the point in local coordinates
      * @param rootScene whether Scene coordinates should be used even if the Node is in a SubScene
@@ -4657,9 +4663,10 @@
     /**
      * Transforms a point from the local coordinate space of this {@code Node}
      * into the coordinate space of its scene.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the result point is in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #localToScene(double, double, double)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * result point is in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #localToScene(double, double, double)}.
      *
      * @param x the x coordinate of the point in local coordinates
      * @param y the y coordinate of the point in local coordinates
@@ -4677,9 +4684,10 @@
     /**
      * Transforms a point from the local coordinate space of this {@code Node}
      * into the coordinate space of its scene.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the result point is in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #localToScene(javafx.geometry.Point2D)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * result point is in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #localToScene(javafx.geometry.Point2D)}.
      *
      * @param localPoint the point in local coordinates
      * @param rootScene whether Scene coordinates should be used even if the Node is in a SubScene
@@ -4699,9 +4707,10 @@
     /**
      * Transforms a point from the local coordinate space of this {@code Node}
      * into the coordinate space of its scene.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the result point is in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #localToScene(double, double)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * result point is in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #localToScene(double, double)}.
      *
      * @param x the x coordinate of the point in local coordinates
      * @param y the y coordinate of the point in local coordinates
@@ -4718,9 +4727,10 @@
     /**
      * Transforms a bounds from the local coordinate space of this {@code Node}
      * into the coordinate space of its scene.
-     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the result bounds are in {@link Scene} coordinates
-     * of the Node returned by {@link #getScene()}. Othwerwise, the subscene coordinates are used, which is equivalent to calling
-     * {@link #localToScene(javafx.geometry.Bounds)}
+     * If the Node does not have any {@link SubScene} or {@code rootScene} is set to true, the
+     * result bounds are in {@link Scene} coordinates of the Node returned by {@link #getScene()}.
+     * Otherwise, the subscene coordinates are used, which is equivalent to calling
+     * {@link #localToScene(javafx.geometry.Bounds)}.
      *
      * @param localBounds the bounds in local coordinates
      * @param rootScene whether Scene coordinates should be used even if the Node is in a SubScene
@@ -7130,8 +7140,8 @@
                         }
 
                         NodeHelper.markDirty(Node.this, DirtyBits.NODE_EFFECT);
-                        // bounds may have changed regardeless whether
-                        // the dirty flag on efffect is set
+                        // bounds may have changed regardless whether
+                        // the dirty flag on effect is set
                         localBoundsChanged();
                     }
 
@@ -8472,8 +8482,8 @@
         if (isTreeVisible) {
             isTreeVisible = parentNode == null || parentNode.isTreeVisible();
         }
-        // When the parent has changed to visible and we have unsynchornized visibility,
-        // we have to synchronize, because the rendering will now pass throught the newly-visible parent
+        // When the parent has changed to visible and we have unsynchronized visibility,
+        // we have to synchronize, because the rendering will now pass through the newly-visible parent
         // Otherwise an invisible Node might get rendered
         if (parentChanged && parentNode != null && parentNode.isTreeVisible()
                 && isDirty(DirtyBits.NODE_VISIBLE)) {
@@ -9373,7 +9383,7 @@
                 // If the node is part of a subscene, then we must ensure that
                 // the we not only mark subScene.root dirty, but continue and
                 // call subScene.notifyParentsOfInvalidatedCSS() until
-                // Scene.root gets marked dirty, via the recurisve call:
+                // Scene.root gets marked dirty, via the recursive call:
                 subScene.cssFlag = CssFlags.UPDATE;
                 subScene.notifyParentsOfInvalidatedCSS();
             }
@@ -9809,9 +9819,9 @@
     /**
      * The role description of this {@code Node}.
      * <p>
-     * Noramlly, when a role is provided for a node, the screen reader
+     * Normally, when a role is provided for a node, the screen reader
      * speaks the role as well as the contents of the node.  When this
-     * value is set, it is possbile to override the default.  This is
+     * value is set, it is possible to override the default.  This is
      * useful because the set of roles is predefined.  For example,
      * it is possible to set the role of a node to be a button, but
      * have the role description be arbitrary text.
--- a/modules/javafx.graphics/src/main/java/javafx/scene/input/MouseEvent.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/input/MouseEvent.java	Fri Apr 13 07:34:46 2018 -0700
@@ -811,7 +811,7 @@
     private final boolean secondaryButtonDown;
 
     /**
-     * Returns {@code true} if secondary button (button 1, usually the right)
+     * Returns {@code true} if secondary button (button 3, usually the right)
      * is currently pressed. Note that this is different from the
      * {@code getButton()} method that indicates which button press was
      * responsible for this event while this method indicates whether the
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/AnchorPane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/AnchorPane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -107,7 +107,7 @@
  * Applications may restore the computed values by setting these properties back
  * to Region.USE_COMPUTED_SIZE.
  * <p>
- * AnchorPane does not clip its content by default, so it is possible that childrens'
+ * AnchorPane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if the anchor pane is resized smaller
  * than its preferred size.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/BorderPane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/BorderPane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -118,7 +118,7 @@
  * Applications may restore the computed values by setting these properties back
  * to Region.USE_COMPUTED_SIZE.
  * <p>
- * BorderPane does not clip its content by default, so it is possible that childrens'
+ * BorderPane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's min size prevents it from
  * being fit within it space.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/FlowPane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/FlowPane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -56,7 +56,7 @@
  * wrapping at the flowpane's height.  If the flowpane has a border and/or padding set,
  * the content will be flowed within those insets.
  * <p>
- * FlowPane's prefWrapLength property establishes it's preferred width
+ * FlowPane's prefWrapLength property establishes its preferred width
  * (for horizontal) or preferred height (for vertical). Applications should set
  * prefWrapLength if the default value (400) doesn't suffice.  Note that prefWrapLength
  * is used only for calculating the preferred size and may not reflect the actual
@@ -137,13 +137,13 @@
  * FlowPane provides properties for setting the size range directly.  These
  * properties default to the sentinel value Region.USE_COMPUTED_SIZE, however the
  * application may set them to other values as needed:
- * <pre>{@code
- *     <b>flowpane.setMaxWidth(500);</b>
- * }</pre>
+ * <pre><code>
+ *     <b>flowPane.setMaxWidth(500);</b>
+ * </code></pre>
  * Applications may restore the computed values by setting these properties back
  * to Region.USE_COMPUTED_SIZE.
  * <p>
- * FlowPane does not clip its content by default, so it is possible that childrens'
+ * FlowPane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's pref size is larger than
  * the space flowpane has to allocate for it.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/GridPane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/GridPane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -70,7 +70,7 @@
 
 /**
  * GridPane lays out its children within a flexible grid of rows and columns.
- * If a border and/or padding is set, then its content will be layed out within
+ * If a border and/or padding is set, then its content will be laid out within
  * those insets.
  * <p>
  * A child may be placed anywhere within the grid and may span multiple
@@ -223,7 +223,7 @@
  * Applications may restore the computed values by setting these properties back
  * to USE_COMPUTED_SIZE.
  * <p>
- * GridPane does not clip its content by default, so it is possible that childrens'
+ * GridPane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's min size prevents it from
  * being fit within it space.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/HBox.java	Fri Apr 13 07:34:46 2018 -0700
@@ -52,7 +52,7 @@
 
 /**
  * HBox lays out its children in a single horizontal row.
- * If the hbox has a border and/or padding set, then the contents will be layed
+ * If the hbox has a border and/or padding set, then the contents will be laid
  * out within those insets.
  * <p>
  * HBox example:
@@ -109,7 +109,7 @@
  * Applications may restore the computed values by setting these properties back
  * to USE_COMPUTED_SIZE.
  * <p>
- * HBox does not clip its content by default, so it is possible that childrens'
+ * HBox does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's min size prevents it from
  * being fit within the hbox.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/Pane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/Pane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -91,7 +91,7 @@
  * Applications may restore the computed values by setting these properties back
  * to Region.USE_COMPUTED_SIZE.
  * <p>
- * Pane does not clip its content by default, so it is possible that childrens'
+ * Pane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds, either if children are positioned
  * at negative coordinates or the pane is resized smaller than its preferred size.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/StackPane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/StackPane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -48,7 +48,7 @@
  * <p>
  * The z-order of the children is defined by the order of the children list
  * with the 0th child being the bottom and last child on top.  If a border and/or
- * padding have been set, the children will be layed out within those insets.
+ * padding have been set, the children will be laid out within those insets.
  * <p>
  * The stackpane will attempt to resize each child to fill its content area.
  * If the child could not be sized to fill the stackpane (either because it was
@@ -56,7 +56,8 @@
  * the area using the alignment property, which defaults to Pos.CENTER.
  * <p>
  * StackPane example:
- * <pre>{@code     StackPane stack = new StackPane();
+ * <pre>{@code
+ *     StackPane stack = new StackPane();
  *     stack.getChildren().addAll(new Rectangle(100,100,Color.BLUE), new Label("Go!));
  * }</pre>
  * <p>
@@ -101,7 +102,7 @@
  * to USE_COMPUTED_SIZE.
  *
  * <p>
- * StackPane does not clip its content by default, so it is possible that childrens'
+ * StackPane does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's min size prevents it from
  * being fit within the stackpane.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/TilePane.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/TilePane.java	Fri Apr 13 07:34:46 2018 -0700
@@ -143,11 +143,14 @@
  * <p>
  * TilePane provides properties for setting the size range directly.  These
  * properties default to the sentinel value Region.USE_COMPUTED_SIZE, however the
- * application may set them to other values as needed, e.g. {@code tilepane.setMaxWidth(500)}.
+ * application may set them to other values as needed:
+ * <pre><code>
+ *     <b>tilePane.setMaxWidth(500);</b>
+ * </code></pre>
  * Applications may restore the computed values by setting these properties back
  * to Region.USE_COMPUTED_SIZE.
  * <p>
- * TilePane does not clip its content by default, so it is possible that childrens'
+ * TilePane does not clip its content by default, so it is possible that children's'
  * bounds may extend outside the tiles (and possibly the tilepane bounds) if a
  * child's pref size prevents it from being fit within its tile. Also, if the tilepane
  * is resized smaller than its preferred size, it may not be able to fit all the
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/VBox.java	Fri Apr 13 07:34:46 2018 -0700
@@ -50,7 +50,7 @@
 
 /**
  * VBox lays out its children in a single vertical column.
- * If the vbox has a border and/or padding set, then the contents will be layed
+ * If the vbox has a border and/or padding set, then the contents will be laid
  * out within those insets.
  * <p>
  * VBox example:
@@ -109,7 +109,7 @@
  * Applications may restore the computed values by setting these properties back
  * to USE_COMPUTED_SIZE.
  * <p>
- * VBox does not clip its content by default, so it is possible that childrens'
+ * VBox does not clip its content by default, so it is possible that children's
  * bounds may extend outside its own bounds if a child's min size prevents it from
  * being fit within the vbox.</p>
  *
--- a/modules/javafx.graphics/src/main/java/javafx/scene/layout/package.html	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/layout/package.html	Fri Apr 13 07:34:46 2018 -0700
@@ -131,7 +131,7 @@
 Applications cannot reliably query the bounds of a resizable node until it has been
 added to a scene because the size of that node may be dependent on CSS.  This is
 because CSS is used to style many aspects of a node which affect it's preferred size
-(font, padding, borders, etc) and so the node cannot be layed out (resized) until
+(font, padding, borders, etc) and so the node cannot be laid out (resized) until
 CSS has been applied and the parent can access valid size range metrics.
 This is always true for Controls (and any panes that contain them), because they
 rely on CSS for their default style, even if no user-level style sheets have been set.
@@ -188,7 +188,7 @@
      </tr>
      <tr>
          <th scope="row">{@link javafx.scene.Group Group}</th>
-         <td>Union of all visible childrens' visual bounds ({@code boundsInParent})
+         <td>Union of all visible children's visual bounds ({@code boundsInParent})
              Does NOT include effect, clip, or transforms set directly on group,
              however DOES include effect, clip, transforms set on individual children since
              those are included in the child's {@code boundsInParent}.
--- a/modules/javafx.graphics/src/main/java/javafx/scene/shape/Box.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/scene/shape/Box.java	Fri Apr 13 07:34:46 2018 -0700
@@ -85,10 +85,6 @@
 
     private TriangleMesh mesh;
 
-    /**
-     * Creates a new instance of {@code Box} of dimension 2 by 2 by 2.
-     */
-
     public static final double DEFAULT_SIZE = 2;
 
     {
@@ -96,6 +92,9 @@
         BoxHelper.initHelper(this);
     }
 
+    /**
+     * Creates a new instance of {@code Box} of dimension 2 by 2 by 2.
+     */
     public Box() {
         this(DEFAULT_SIZE, DEFAULT_SIZE, DEFAULT_SIZE);
     }
--- a/modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java	Fri Apr 13 16:09:47 2018 +0530
+++ b/modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java	Fri Apr 13 07:34:46 2018 -0700
@@ -62,8 +62,8 @@
      * This is a conditional feature, to check if it is supported see
      * {@link javafx.application.Platform#isSupported(javafx.application.ConditionalFeature)}.
      * If the feature is not supported by the platform, this style downgrades to {@code StageStyle.DECORATED}
-     * <p>                                                   `
-     * NOTE: To see the effect the {@code Scene} covering the {@code Stage} should have {@code Color.TRANSPARENT}
+     * <p>
+     * NOTE: To see the effect, the {@code Scene} covering the {@code Stage} should have {@code Color.TRANSPARENT}
      * @since JavaFX 8.0
      */
     UNIFIED