diff --git a/core/java/android/annotation/Px.java b/core/java/android/annotation/Px.java
index a0ef2244d5e40..ad99fdb7657e0 100644
--- a/core/java/android/annotation/Px.java
+++ b/core/java/android/annotation/Px.java
@@ -29,6 +29,8 @@ import static java.lang.annotation.RetentionPolicy.SOURCE;
  * Denotes that a numeric parameter, field or method return value is expected
  * to represent a pixel dimension.
  *
+ * @paramDoc This units of this value are pixels.
+ * @returnDoc This units of this value are pixels.
  * {@hide}
  */
 @Documented