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

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

Change-Id: Ic1ee436a347d04febbb49ceaff9e0f203f6d89be