Prepare release 1.3.0
Bump the version out of its development suffix, turn the dev NEWS
heading into the 1.3.0 release heading and record the new
imputation-flag, verbose-reporting and duplicate-warning entries, and
add cran-comments for the release. Label the previously unlabelled
cran-comments section 1.2.1.
Also record the KorAPConnection() documentation fix of the preceding
commit in NEWS.md and explain it in cran-comments.md: the first 1.3.0
submission was rejected by the incoming pretest with the "Rd files
without \usage" NOTE on r-devel-linux-x86_64-debian-gcc and -clang.
R CMD check --as-cran Status OK (0 errors, 0 warnings, 0 notes) locally
on Fedora 44 with R 4.6.1, including the Rd fix. The macOS builder and
win-builder runs listed in cran-comments.md were made for the first
1.3.0 submission and are to be repeated before resubmitting.
The last state without the Rd fix was confirmed green on GitHub Actions
(https://github.com/KorAP/RKorAPClient/actions/runs/33394690107):
R-CMD-check passing on ubuntu-latest (devel, release, oldrel-1),
macOS-latest (release) and windows-latest (release), plus test-coverage
passing.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Change-Id: I87fb5ec5c587fa5d947a0d2d3b3c9af1a4c221cb
diff --git a/DESCRIPTION b/DESCRIPTION
index 1f64959..839de68 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
Package: RKorAPClient
Type: Package
Title: 'KorAP' Web Service Client Package
-Version: 1.2.1.9000
+Version: 1.3.0
Authors@R:
c(person(given = "Marc",
family = "Kupietz",
diff --git a/NEWS.md b/NEWS.md
index c8e0006..6d84c25 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,11 +1,14 @@
-# unpublished dev version 1.2.1.9000
+# RKorAPClient 1.3.0
- added `cacheAs` parameter to `collocationAnalysis()` for transparent result caching: if the specified RDS file exists, the cached result is returned immediately; otherwise the analysis runs and the result is saved to the file (`.rds` extension is added automatically if omitted)
- fixed score threshold in recursive CA
- focus is now injected into webUIRequestUrls in collocationAnalysis results, when possible
-- added support for comparing collocation analyses across multiple vcs (`max_delta_<score>`, `winner<score>`, `loser_score<score>` columns etc.), including explicit winner/loser `webUIRequestUrl` columns for association scores, ranks, and percentile ranks. Missing per-label concordance URLs are now derived by replacing the `cq` parameter of an available row URL with the target label's vc, and unsuffixed consensus `winner_webUIRequestUrl` / `loser_webUIRequestUrl` columns are populated when score-based URL choices agree
+- added *experimental* support for comparing collocation analyses across multiple vcs (`max_delta_<score>`, `winner<score>`, `loser_score<score>` columns etc.), including explicit winner/loser `webUIRequestUrl` columns for association scores, ranks, and percentile ranks. Missing per-label concordance URLs are now derived by replacing the `cq` parameter of an available row URL with the target label's vc, and unsuffixed consensus `winner_webUIRequestUrl` / `loser_webUIRequestUrl` columns are populated when score-based URL choices agree. The names and semantics of these columns may still change without a deprecation cycle
+- collocates that are not attested in every compared vc get their missing scores imputed. Such rows are now marked by the new `imputed`, `n_imputed` and `imputed_<label>` columns, and reported in verbose mode, so that presence/absence artifacts can be told apart from measured contrasts (`filter(!imputed)`). See the new "Interpreting multi-VC comparisons" section in `?collocationAnalysis` for how to read the comparison columns
+- `collocationAnalysis()` now warns when repeated node/collocate/label rows are reduced to their first occurrence for the comparison columns, instead of dropping them silently
- added support for passing condition labels when comparing multiple vcs by allowing for named vc lists
- `collocationScoreQuery()` now accepts a vector of collocates and queries every combination of collocate and virtual corpus
+- `KorAPConnection()` is now a regular constructor function instead of the S4 class generator, so that its manual page documents how it is actually called. `new("KorAPConnection", ...)` and all existing calls keep working unchanged
# RKorAPClient 1.2.1
diff --git a/cran-comments.md b/cran-comments.md
index 2707174..42b160b 100644
--- a/cran-comments.md
+++ b/cran-comments.md
@@ -1,5 +1,41 @@
## Notes
+* resubmission of 1.3.0, fixing the NOTE reported by the incoming pretest on
+ r-devel-linux-x86_64-debian-gcc and -clang:
+ ```
+ Rd files without \usage:
+ 'KorAPConnection-class.Rd'
+ \arguments should not be documented without \usage.
+ ```
+ `KorAPConnection()` is now documented as the constructor function it is,
+ instead of as the S4 class generator (whose formals are just `...`), so that
+ its Rd file has a \usage section derived from the actual formals.
+ No Rd file documents \arguments without \usage any more.
+* feature release
+* new result caching option for collocation analyses
+* new, experimental support for comparing collocation analyses across several
+ virtual corpora
+* no new dependencies
+
+```
+0 errors ✔ | 0 warnings ✔ | 0 notes ✔
+
+R CMD check succeeded
+```
+
+## Test environments
+
+* local Fedora 44 with R version 4.6.1
+* win-builder with R 4.6.1
+* win-builder with R Under development (unstable) (2026-08-27 r90452 ucrt)
+* github workflow on Ubuntu with R Under development (unstable) (2026-06-21 r90185)
+* github workflow on Ubuntu with R 4.6.1
+* github workflow on Ubuntu with R 4.5.3
+* github workflow on macOS 26 (ARM64) with R 4.6.1
+* github workflow on Windows with R 4.6.1
+
+## Notes on 1.2.1
+
* bug fix and rpy2 compatibility release
* xml2 dependency added