summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPindi Albert <pindi.albert@gmail.com>2012-12-14 16:18:08 -0800
committerJohannes Linke <johannes.linke@posteo.de>2015-09-06 09:30:25 +0200
commitcf297668d1e36d31abc1ece6c3f385eb1a8346f9 (patch)
tree153148ccaf60ffd3821a68cac4dba127415489ca
parent3bfed737341e87d9f1edd1beac3e7d0eebed3aeb (diff)
downloaddjango-compressor-cf297668d1e36d31abc1ece6c3f385eb1a8346f9.tar.gz
Document COMPRESS_CACHEABLE_PRECOMPILERS setting
-rw-r--r--docs/settings.txt13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/settings.txt b/docs/settings.txt
index 7d25e51..4acf418 100644
--- a/docs/settings.txt
+++ b/docs/settings.txt
@@ -418,6 +418,19 @@ Caching settings
:attr:`~django.conf.settings.COMPRESS_REBUILD_TIMEOUT` and
:attr:`~django.conf.settings.COMPRESS_MINT_DELAY`.
+.. attribute:: COMPRESS_CACHEABLE_PRECOMPILERS
+
+ :Default: ``()``
+
+ An iterable of precompiler mimetypes as defined in :attr:`~django.conf.settings.COMPRESS_PRECOMPILERS`
+ for which the compiler output can be cached based solely on the contents
+ of the input file. This lets Django Compressor avoid recompiling unchanged
+ files. Caching is appropriate for compilers such as CoffeeScript where files
+ are compiled one-to-one, but not for compilers such as SASS that have an
+ ``import`` mechanism for including one file from another. If caching is enabled
+ for such a compiler, Django Compressor will not know to recompile files when a file
+ they import is modified.
+
.. attribute:: COMPRESS_DEBUG_TOGGLE
:Default: None