diff --git a/core/java/android/widget/Toolbar.java b/core/java/android/widget/Toolbar.java
index 1ce19ce050664..d8e39e3788c6b 100644
--- a/core/java/android/widget/Toolbar.java
+++ b/core/java/android/widget/Toolbar.java
@@ -66,7 +66,9 @@ import java.util.List;
*
A navigation button. This may be an Up arrow, navigation menu toggle, close,
* collapse, done or another glyph of the app's choosing. This button should always be used
* to access other navigational destinations within the container of the Toolbar and
- * its signified content or otherwise leave the current context signified by the Toolbar.
+ * its signified content or otherwise leave the current context signified by the Toolbar.
+ * The navigation button is vertically aligned within the Toolbar's
+ * {@link android.R.styleable#View_minHeight minimum height}, if set.
* A branded logo image. This may extend to the height of the bar and can be
* arbitrarily wide.
* A title and subtitle. The title should be a signpost for the Toolbar's current
@@ -82,8 +84,9 @@ import java.util.List;
* An {@link ActionMenuView action menu}. The menu of actions will pin to the
* end of the Toolbar offering a few
*
- * frequent, important or typical actions along with an optional overflow menu for
- * additional actions.
+ * frequent, important or typical actions along with an optional overflow menu for
+ * additional actions. Action buttons are vertically aligned within the Toolbar's
+ * {@link android.R.styleable#View_minHeight minimum height}, if set.
*
*
*