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

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

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