Merge "API docs clarification for placing calls." am: 57954552ad

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1853624

Change-Id: If54588ceebba9282a374ad55242a26a53dbb224d