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

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

Change-Id: Iafe58e6bea313054a569f7db60daf8ea298c0f90