Followup to Bug 396316, update IDL comments to reflect new hostname format. r=gavin, a=blocking-ff3+

toolkit/components/passwordmgr/public/nsILoginInfo.idl

@@ -47,13 +47,8 @@ interface nsILoginInfo : nsISupports {
     /**
      * The hostname the login applies to.
      *
-     * For logins obtained from HTML forms, the login is formatted like
-     * a URL. For example: "http://www.site.com" A port number (":123")
-     * may be appended in some cases.
-     *
-     * For logins obtained from a HTTP or FTP protocol authentication, 
-     * the hostname is not a URL format, but does always have the port
-     * number appended. For example "www.site.com:80".
+     * The hostname should be formatted as an URL. For example,
+     * "https://site.com", "http://site.com:1234", "ftp://ftp.site.com".
      */
     attribute AString hostname;
 
@@ -75,7 +70,8 @@ interface nsILoginInfo : nsISupports {
      *
      * When an HTTP server sends a 401 result, the WWW-Authenticate
      * header includes a realm to identify the "protection space." See
-     * RFC2617.
+     * RFC2617. If the response sent has a missing or blank realm, the
+     * hostname is used instead.
      *
      * For logins obtained from HTML forms, this field is NULL.
      */

toolkit/components/passwordmgr/public/nsILoginManager.idl

@@ -155,11 +155,8 @@ interface nsILoginManager : nsISupports {
      *        the array's .length property, and supply an dummy object for
      *        this out param. For example: |findLogins({}, hostname, ...)|
      * @param aHostname
-     *        The hostname to restrict searches to. When looking for form
-     *        logins, this argument should be in origin URL format, without
-     *        a pathname. For example: "http://www.site.com". For protocol
-     *        logins (http//ftp), it should be the hostname with a port
-     *        appended. For example: "www.bar.com:443".
+     *        The hostname to restrict searches to, in URL format. For
+     *        example: "http://www.site.com".
      * @param aActionURL
      *        For form logins, this argument should be the URL to which the
      *        form will be submitted. For protocol logins, specify null.

toolkit/components/passwordmgr/public/nsILoginManagerStorage.idl

@@ -179,11 +179,8 @@ interface nsILoginManagerStorage : nsISupports {
      *        the array's .length property, and supply an dummy object for
      *        this out param. For example: |findLogins({}, hostname, ...)|
      * @param aHostname
-     *        The hostname to restrict searches to. When looking for form
-     *        logins, this argument should be in origin URL format, without
-     *        a pathname. For example: "http://www.site.com". For protocol
-     *        logins (http//ftp), it should be the hostname with a port
-     *        appended. For example: "www.bar.com:443".
+     *        The hostname to restrict searches to, in URL format. For
+     *        example: "http://www.site.com".
      * @param aActionURL
      *        For form logins, this argument should be the URL to which the
      *        form will be submitted. For protocol logins, specify null.