Merge "Improve formatting of doc comments and add more details." into main am: bcd6336d7f

Original change: https://android-review.googlesource.com/c/platform/frameworks/native/+/3315653

Change-Id: I798c16aa6f675018e700aca2c93ae499e9f74a35
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>