Add blessCacheAs() to vouch for a file an older version wrote
Files from the 1.3.0.9000 development cycle already hold correctly
computed scores - the corrections landed there, before the release was
cut - but they say nothing about what wrote them, so the check added for
1.4.0 recomputes them. That is right in general and wrong for exactly
the files whose owners know better, and a collocation analysis they would
have to sit through again runs for hours.
blessCacheAs() records that a file holds what this version would compute.
What actually produced it is left as it stands and the blessing noted
beside it, so cacheAsInfo() goes on saying where the numbers come from
rather than claiming a provenance the file does not have.
A file recording no parameters, as those written before 1.3.0.9000 do,
has nothing left to compare against a call once blessed, and is reused
for any call naming it. Blessing one says so.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Change-Id: I0c46322154441b11547da205b2aa0fb5cf98371d
diff --git a/man/blessCacheAs.Rd b/man/blessCacheAs.Rd
new file mode 100644
index 0000000..3cecdde
--- /dev/null
+++ b/man/blessCacheAs.Rd
@@ -0,0 +1,44 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/cacheAs.R
+\name{blessCacheAs}
+\alias{blessCacheAs}
+\title{Vouch for a cacheAs file that an older version wrote}
+\usage{
+blessCacheAs(cacheAs)
+}
+\arguments{
+\item{cacheAs}{paths of the files to vouch for, with or without their \code{.rds}
+extension}
+}
+\value{
+the paths, invisibly
+}
+\description{
+Association scores changed in 1.4.0, so files from before it are recomputed
+rather than used (see \link{cacheAs}). Where a file is known to hold what this
+version would compute - because it was written by a development version that
+already had the corrections, for instance - this records that, and the file is
+used again as it is.
+}
+\details{
+What actually wrote a file is left as it stands; the blessing is recorded
+beside it, so that \code{\link[=cacheAsInfo]{cacheAsInfo()}} keeps telling the truth about where the
+numbers come from.
+
+A file that records no parameters, as those written before 1.3.0.9000 do, has
+nothing left to be compared against a call once it is blessed, and is
+therefore reused for any call that names it. Bless such a file only if that
+is what you mean.
+}
+\examples{
+\dontrun{
+blessCacheAs("klima-ca.rds")
+blessCacheAs(list.files("data", pattern = "\\\\.rds$", full.names = TRUE))
+}
+
+}
+\seealso{
+Other cacheAs:
+\code{\link[=cacheAsInfo]{cacheAsInfo()}}
+}
+\concept{cacheAs}