Expand comment

diff --git a/src/Buffer.cpp b/src/Buffer.cpp
index 50cc2f243fd25b8cdd3b43358b87c25357fcfedc..54a4dff5a7e8d6db223e4cd90b5d0e4980042434 100644 (file)
--- a/src/Buffer.cpp
+++ b/src/Buffer.cpp
@@ -2497,8 +2497,15 @@ void Buffer::checkIfBibInfoCacheIsValid() const
                return;
        }
 
-       // if we already know the cache is invalid, no need to check
-       // the timestamps
+       // If we already know the cache is invalid, stop here.
+       // This is important in the case when the bibliography
+       // environment (rather than Bib[la]TeX) is used.
+       // In that case, the timestamp check below gives no
+       // sensible result. Rather than that, the cache will
+       // be invalidated explicitly via invalidateBibInfoCache()
+       // by the Bibitem inset.
+       // Same applies for bib encoding changes, which trigger
+       // invalidateBibInfoCache() by InsetBibtex.
        if (!d->bibinfo_cache_valid_)
                return;