Add dicache meaning: decompressed image cache

From Livio Baldini Soares:

> Let me clarify a little bit about what the dicache is.
>
> This is how Dillo works. When you ask for a URL (be it a root URL,
> like a HTML, or an image embedded in a page), it looks it up in a
> _memory_ cache. If it's already there it returns the content of the
> cache, and if not it makes a connection to retrieve that URL.
>
> But there is a complication with respect to images. The images which
> are downloaded need to be decompressed to be displayed (that is,
> transformed from their original format, jpeg, gif, etc, to a bitmap
> format). So for images, first the dicache (_d_ecompressed _i_mage
> cache) is checked, then the cache, then finally it is retrieved from
> the site. The problem with dicache is that it eats up a *LOT* of
> memory, and the only benefit is the processing time of transforming
> from the original format to the bitmap. That's why the default is NO.

See: https://dillo-dev.auriga.wearlab.narkive.com/TYZWEMgE/how-to-use-dicache#post3
See: https://github.com/dillo-browser/dillo/issues/249#issuecomment-2295040723

1 files changed, 6 insertions, 0 deletions

diff --git a/src/dicache.c b/src/dicache.c
index e83d2d72..36a2cafb 100644
--- a/src/dicache.c
+++ b/src/dicache.c
@@ -10,6 +10,12 @@
  * (at your option) any later version.
  */
 
+/** @file
+ * DICache stands for Decompressed Image Cache. It holds the raw buffers (RGB)
+ * of images after they are decompressed of their respective formats (png, jpeg,
+ * gif, ...).
+ */
+
 #include <string.h>         /* for memset */
 #include <stdlib.h>