Bug 752675- Improve documentation of nsIRequest::LOAD_FROM_CACHE. r=michal

This commit is contained in:
Jason Duell 2012-05-08 18:01:57 -07:00
parent 1cebe57564
commit 093619a04b

View File

@ -192,10 +192,17 @@ interface nsIRequest : nsISupports
const unsigned long LOAD_BYPASS_CACHE = 1 << 9;
/**
* Load from the cache, bypassing protocol specific validation logic. This
* flag is used when browsing via history. It is not recommended for normal
* browsing as it may likely violate reasonable assumptions made by the
* server and confuse users.
* Attempt to force a load from the cache, bypassing ALL validation logic
* (note: this is stronger than VALIDATE_NEVER, which still validates for
* certain conditions).
*
* If the resource is not present in cache, it will be loaded from the
* network. Combine this flag with LOAD_ONLY_FROM_CACHE if you wish to
* perform cache-only loads without validation checks.
*
* This flag is used when browsing via history. It is not recommended for
* normal browsing as it may likely violate reasonable assumptions made by
* the server and confuse users.
*/
const unsigned long LOAD_FROM_CACHE = 1 << 10;
@ -207,7 +214,9 @@ interface nsIRequest : nsISupports
* VALIDATE_ALWAYS forces validation of any cached content independent of
* its expiration time.
*
* VALIDATE_NEVER disables validation of expired content.
* VALIDATE_NEVER disables validation of cached content, unless it arrived
* with the "Cache: no-store" header, or arrived via HTTPS with the
* "Cache: no-cache" header.
*
* VALIDATE_ONCE_PER_SESSION disables validation of expired content,
* provided it has already been validated (at least once) since the start