docs: Fix return info for support lib checkSelfPermission()

Docs incorrectly said the method returns a boolean. In fact,
it (like the framework version) returns an int constant.

See first comment for doc stage location.

bug: 23331110
Change-Id: I2b4ccdc56dc0cff414c4d21e3916e8e7a0b0e909