/*
 * Copyright 2011, Mahmood Ali.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *   * Redistributions in binary form must reproduce the above
 *     copyright notice, this list of conditions and the following disclaimer
 *     in the documentation and/or other materials provided with the
 *     distribution.
 *   * Neither the name of Mahmood Ali. nor the names of its
 *     contributors may be used to endorse or promote products derived from
 *     this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
package com.notnoop.c2dm;

public interface C2DMDelegate {
    public void messageSent(C2DMNotification message, C2DMResponse response, String id);
    public void messageFailed(C2DMNotification message, C2DMResponse response);

    public void authTokenUpdated(String newAuthToken);
}

@@ -1643,173 +1643,1764 @@
     
-public void messageSent(C2DMNotification message, C2DMResponse response, String id);%0A    public void messageFailed(C2DMNotification message, C2DMResponse response);%0A
+/**%0A     * Delegate called when a notification is sent successfully to the Google%0A     * C2DM servers.%0A     *%0A     * @param message   the sent message (null if client didn't create a%0A     *              %7B@link C2DMNotification%7D object)%0A     * @param response  the response Google sent%0A     * @param id    the id assigned to the message by Google servers%0A     */%0A    public void messageSent(C2DMNotification message, C2DMResponse response, String id);%0A%0A    /**%0A     * Delegate method called when the C2DM server rejects or drops a message.%0A     *%0A     * The server may drop the message for various reasons.  Some may require%0A     * the application to retry (e.g. when servers are down or over quota),%0A     * and some require more work (e.g. invalid authentication, missing values).%0A     *%0A     * @param message   the sent message (null if client didn't create a%0A     *              %7B@link C2DMNotification%7D object)%0A     * @param response  the response Google sent%0A     */%0A    public void messageFailed(C2DMNotification message, C2DMResponse response);%0A%0A    /**%0A     * Delegate method called when Google servers update the Auth Token.%0A     *%0A     * Google servers update the authentication code, and indicates the new%0A     * value in special HTTP header %22Update-Client-Auth%22.  Google C2DM servers%0A     * may accept the stale value for a unspecified period of time allowing all%0A     * clients to be update.%0A     *%0A     * This library maintains the authentication token automatically, so%0A     * subclasses should only use this method for record keeping.  Subclasses%0A     * should not override this method to update any %7B@link C2DMService%7D or%0A     * recreate %7B@link C2DMService%7D instances.%0A     *%0A     * @param newAuthToken  the new authentication token%0A     */
 %0A   

update delegate documentation