Merge "Update documentation for SubscriptionManager listener" am: 75a00668 am: 0d95ed6e

 * Override the methods for the state that you wish to receive updates for, and

 * pass your PhoneStateListener object, along with bitwise-or of the LISTEN_

 * flags to {@link TelephonyManager#listen TelephonyManager.listen()}. Methods are

 * called when the state changes, os well as once on initial registration.

 * called when the state changes, as well as once on initial registration.

 * <p>

 * Note that access to some telephony information is

 * permission-protected. Your application won't receive updates for protected

        }

        /**

         * Callback invoked when there is any change to any SubscriptionInfo. Typically

         * Callback invoked when there is any change to any SubscriptionInfo, as well as once on

         * registering for changes with {@link #addOnSubscriptionsChangedListener}. Typically

         * this method would invoke {@link #getActiveSubscriptionInfoList}

         */

        public void onSubscriptionsChanged() {

    /**

     * Register for changes to the list of active {@link SubscriptionInfo} records or to the

     * individual records themselves. When a change occurs the onSubscriptionsChanged method of

     * the listener will be invoked immediately if there has been a notification.

     * the listener will be invoked immediately if there has been a notification. The

     * onSubscriptionChanged method will also be triggered once initially when calling this

     * function.

     *

     * @param listener an instance of {@link OnSubscriptionsChangedListener} with

     *                 onSubscriptionsChanged overridden.