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

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

Change-Id: I979f732e3fcecb1bba3b2384a0f46906751705af