diff --git a/toolkit/components/places/public/nsIAnnotationService.idl b/toolkit/components/places/public/nsIAnnotationService.idl
index ea522e1e344..6462e3049c5 100644
--- a/toolkit/components/places/public/nsIAnnotationService.idl
+++ b/toolkit/components/places/public/nsIAnnotationService.idl
@@ -103,6 +103,10 @@ interface nsIAnnotationService : nsISupports
      *
      * aExpiration is one of EXPIRE_* above. aFlags should be 0 for now, some
      * flags will be defined in the future.
+     *
+     * The annotation "favicon" is special. favicons are stored in the favicon
+     * service, but are special cased in the protocol handler so they look like
+     * annotations. Do not set favicons using this service.
      */
     void setAnnotation(in nsIURI aURI, in AUTF8String aName, in nsIVariant aValue,
                        in PRInt32 aFlags, in PRInt32 aExpiration);
@@ -177,6 +181,13 @@ interface nsIAnnotationService : nsISupports
                            out PRInt32 aFlags, out PRInt32 aExpiration,
                            out AUTF8String aMimeType, out PRInt32 aStorageType);
 
+    /**
+     * Returns a list of all URIs having a given annotation.
+     */
+    void getPagesWithAnnotation(in AUTF8String name,
+      out PRUint32 resultCount,
+      [retval, array, size_is(resultCount)] out nsIURI results);
+
     /**
      * Get the names of all annotations for this URI.
      *