diff --git a/man/blessCacheAs.Rd b/man/blessCacheAs.Rd
index 3cecdde..3eec16b 100644
--- a/man/blessCacheAs.Rd
+++ b/man/blessCacheAs.Rd
@@ -39,6 +39,7 @@
 }
 \seealso{
 Other cacheAs:
-\code{\link[=cacheAsInfo]{cacheAsInfo()}}
+\code{\link[=cacheAsInfo]{cacheAsInfo()}},
+\code{\link[=withCachedResults]{withCachedResults()}}
 }
 \concept{cacheAs}
diff --git a/man/cacheAsInfo.Rd b/man/cacheAsInfo.Rd
index 73324b3..1ed3b0b 100644
--- a/man/cacheAsInfo.Rd
+++ b/man/cacheAsInfo.Rd
@@ -31,6 +31,7 @@
 }
 \seealso{
 Other cacheAs:
-\code{\link[=blessCacheAs]{blessCacheAs()}}
+\code{\link[=blessCacheAs]{blessCacheAs()}},
+\code{\link[=withCachedResults]{withCachedResults()}}
 }
 \concept{cacheAs}
diff --git a/man/withCachedResults.Rd b/man/withCachedResults.Rd
new file mode 100644
index 0000000..03e4223
--- /dev/null
+++ b/man/withCachedResults.Rd
@@ -0,0 +1,37 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/cacheAs.R
+\name{withCachedResults}
+\alias{withCachedResults}
+\title{Take cached results as they are for the duration of an expression}
+\usage{
+withCachedResults(expr, mode = c("reuse", "offline"))
+}
+\arguments{
+\item{expr}{the code to evaluate}
+
+\item{mode}{\code{"reuse"} to take what the files hold, \code{"offline"} to refuse
+computing anything that is not in one already}
+}
+\value{
+the value of \code{expr}
+}
+\description{
+Sets the cacheAs mode (see \link{cacheAs}) while \code{expr} is evaluated and puts it
+back afterwards, so that a whole document can be knitted from the files that
+are there, without a stray \code{options()} call outliving it.
+}
+\examples{
+\dontrun{
+withCachedResults({
+  ca <- KorAPConnection() |> collocationAnalysis("Klima", cacheAs = "klima.rds")
+  freq <- KorAPConnection() |> frequencyQuery("Klima", cacheAs = "klima-freq.rds")
+})
+}
+
+}
+\seealso{
+Other cacheAs:
+\code{\link[=blessCacheAs]{blessCacheAs()}},
+\code{\link[=cacheAsInfo]{cacheAsInfo()}}
+}
+\concept{cacheAs}