Bug 469528: add comments specifying units used for various cache capacities, r+sr=biesi

netwerk/cache/src/nsCacheService.cpp

@@ -155,15 +155,15 @@ private:
     PRBool                  mHaveProfile;
     
     PRBool                  mDiskCacheEnabled;
-    PRInt32                 mDiskCacheCapacity;
+    PRInt32                 mDiskCacheCapacity; // in kilobytes
     nsCOMPtr<nsILocalFile>  mDiskCacheParentDirectory;
 
     PRBool                  mOfflineCacheEnabled;
-    PRInt32                 mOfflineCacheCapacity;
+    PRInt32                 mOfflineCacheCapacity; // in kilobytes
     nsCOMPtr<nsILocalFile>  mOfflineCacheParentDirectory;
     
     PRBool                  mMemoryCacheEnabled;
-    PRInt32                 mMemoryCacheCapacity;
+    PRInt32                 mMemoryCacheCapacity; // in kilobytes
 
     PRBool                  mInPrivateBrowsing;
 };

netwerk/cache/src/nsCacheService.h

@@ -150,9 +150,11 @@ public:
     static void      OnProfileChanged();
 
     static void      SetDiskCacheEnabled(PRBool  enabled);
+    // Sets the disk cache capacity (in kilobytes)
     static void      SetDiskCacheCapacity(PRInt32  capacity);
 
     static void      SetOfflineCacheEnabled(PRBool  enabled);
+    // Sets the offline cache capacity (in kilobytes)
     static void      SetOfflineCacheCapacity(PRInt32  capacity);
 
     static void      SetMemoryCache();

netwerk/cache/src/nsDiskCacheDeviceSQL.h

@@ -266,7 +266,7 @@ private:
   nsCOMPtr<mozIStorageStatement>  mStatement_FindClientByNamespace;
 
   nsCOMPtr<nsILocalFile>          mCacheDirectory;
-  PRUint32                        mCacheCapacity;
+  PRUint32                        mCacheCapacity; // in bytes
   PRInt32                         mDeltaCounter;
 
   nsInterfaceHashtable<nsCStringHashKey, nsIWeakReference> mCaches;