New Upstream Snapshot - r-cran-clipr
Ready changes
Summary
Merged new upstream version: 0.8.0+git20220224.1.d14fc11 (was: 0.8.0).
Resulting package
Built on 2023-01-19T20:18 (took 5m37s)
The resulting binary packages can be installed (if you have the apt repository enabled) by running one of:
apt install -t fresh-snapshots r-cran-clipr
Lintian Result
Diff
diff --git a/DESCRIPTION b/DESCRIPTION
index 80c6ee1..a2373dc 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
Type: Package
Package: clipr
Title: Read and Write from the System Clipboard
-Version: 0.8.0
+Version: 0.8.0.9000
Authors@R: c(
person("Matthew", "Lincoln", , "matthew.d.lincoln@gmail.com", role = c("aut", "cre"),
comment = c(ORCID = "0000-0002-4387-3384")),
@@ -21,6 +21,7 @@ Suggests: covr, knitr, rmarkdown, rstudioapi (>= 0.5), testthat (>=
VignetteBuilder: knitr
Encoding: UTF-8
Language: en-US
+Roxygen: list(markdown = TRUE)
RoxygenNote: 7.1.2
SystemRequirements: xclip (https://github.com/astrand/xclip) or xsel
(http://www.vergenet.net/~conrad/software/xsel/) for accessing
@@ -28,11 +29,9 @@ SystemRequirements: xclip (https://github.com/astrand/xclip) or xsel
(https://github.com/bugaevc/wl-clipboard) for systems using
Wayland.
NeedsCompilation: no
-Packaged: 2022-02-19 02:20:21 UTC; mlincoln
+Packaged: 2023-01-19 20:16:42 UTC; root
Author: Matthew Lincoln [aut, cre] (<https://orcid.org/0000-0002-4387-3384>),
Louis Maddox [ctb],
Steve Simpson [ctb],
Jennifer Bryan [ctb]
Maintainer: Matthew Lincoln <matthew.d.lincoln@gmail.com>
-Repository: CRAN
-Date/Publication: 2022-02-22 00:58:45 UTC
diff --git a/MD5 b/MD5
deleted file mode 100644
index a37733b..0000000
--- a/MD5
+++ /dev/null
@@ -1,31 +0,0 @@
-181aa9ef9ab3d47179ef0ac61f9487a8 *DESCRIPTION
-ac9216bb379e4dad41fcf47ac889c3d9 *NAMESPACE
-cf385d39494ed10dd9d878d04995bb04 *NEWS.md
-203d99a65e5a8f20a339cad36becb76c *R/clipboard.R
-9c75ab4e1359ffadc1c01d04b23b70e4 *R/clipr-package.R
-c3673645d26e307510e4b9092022ab7b *R/clipr_addin.R
-78462ea037dad6dc795301e220542f80 *R/flat_str.R
-51d1ae24d6964d1cad8299b7eba93360 *R/linux_clipboard.R
-127954870f38794f4b2671fc08623ac6 *R/osx_clipboard.R
-9f8d569f398395aafbe00886fca97306 *R/read_clip_tbl.R
-453049b87c715b158f0d4ed13721acc4 *R/utils.R
-5b9bbc21d44d557fedf004203fb90608 *R/win_clipboard.R
-905e922f73475fc62d4032d8724dabbe *README.md
-f89ddfb42b231d789c0eb0b9541b0342 *build/vignette.rds
-46750e778a5cdb4d65c347f8e43df623 *inst/doc/developing-with-clipr.R
-84e33d5522227cda21ffbb2c43045ee9 *inst/doc/developing-with-clipr.Rmd
-ba0558ec5bfe2072966f71f336630b4e *inst/doc/developing-with-clipr.html
-c5d91ccff2716bd64fd3dbf351507c07 *inst/rstudio/addins.dcf
-f8c1c7e8cb9612e9c3d58455491fba2b *man/clear_clip.Rd
-a34df8a952f7cd6f09dd6b8102e132dc *man/clipr.Rd
-9ff95009c8aa71675ae5d2e6513d0e64 *man/clipr_available.Rd
-0441a3c453b0e77192e8f1cd05283f3b *man/read_clip.Rd
-5b64a13295fa3c2125a2c1922e5648ae *man/read_clip_tbl.Rd
-a0b697c89ab1900ed68cf2a2bafe4912 *man/write_clip.Rd
-9ad848459b1749b5a5a26c74d9db944e *man/write_last_clip.Rd
-ec77100d776b5924e0da206268d2517d *tests/testthat.R
-51d8d49a44ccf1bc6771a64ecc6a4d22 *tests/testthat/setup.R
-7e6583d8339882002b75ffacb6b2abd0 *tests/testthat/test-diagnostics.R
-c84adc3c418b98dd0b8be2db8c798452 *tests/testthat/test-render.R
-9fb913b103141779463f88542abb69e1 *tests/testthat/test-systems.R
-84e33d5522227cda21ffbb2c43045ee9 *vignettes/developing-with-clipr.Rmd
diff --git a/README.md b/README.md
index 98de874..a79a630 100644
--- a/README.md
+++ b/README.md
@@ -8,8 +8,6 @@ status.](https://www.r-pkg.org/badges/version/clipr)](https://www.r-pkg.org/pkg/
[](https://github.com/mdlincoln/clipr/actions/workflows/R-CMD-check.yaml)
-[](https://codecov.io/github/mdlincoln/clipr?branch=master)
Simple utility functions to read and write from the system clipboards of
Windows, OS X, and Unix-like systems (which require either xclip or
@@ -31,20 +29,20 @@ remotes::install_github("mdlincoln/clipr")
## Usage
-``` r
-library("clipr")
-#> Welcome to clipr. See ?write_clip for advisories on writing to the clipboard in R.
-
-cb <- read_clip()
-```
-
clipr is pipe-friendly, and will default to returning the same object
that was passed in.
``` r
+library("clipr")
+#> Welcome to clipr. See ?write_clip for advisories on writing to the clipboard in R.
+
res <- write_clip(c("Text", "for", "clipboard"))
res
#> [1] "Text" "for" "clipboard"
+
+cb <- read_clip()
+cb
+#> [1] "Text" "for" "clipboard"
```
To capture the string that clipr writes to the clipboard, specify
diff --git a/build/vignette.rds b/build/vignette.rds
index 9b96d50..d6f4c41 100644
Binary files a/build/vignette.rds and b/build/vignette.rds differ
diff --git a/debian/changelog b/debian/changelog
index 0b08622..35de8ae 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+r-cran-clipr (0.8.0+git20220224.1.d14fc11-1) UNRELEASED; urgency=low
+
+ * New upstream snapshot.
+
+ -- Debian Janitor <janitor@jelmer.uk> Thu, 19 Jan 2023 20:16:45 -0000
+
r-cran-clipr (0.8.0-1) unstable; urgency=medium
* Team Upload.
diff --git a/inst/doc/developing-with-clipr.html b/inst/doc/developing-with-clipr.html
index 04d9fb3..11f4018 100644
--- a/inst/doc/developing-with-clipr.html
+++ b/inst/doc/developing-with-clipr.html
@@ -12,11 +12,23 @@
<meta name="author" content="Matthew Lincoln" />
-<meta name="date" content="2022-02-18" />
+<meta name="date" content="2023-01-19" />
<title>Developing with clipr</title>
-<script src="data:application/javascript;base64,Ly8gUGFuZG9jIDIuOSBhZGRzIGF0dHJpYnV0ZXMgb24gYm90aCBoZWFkZXIgYW5kIGRpdi4gV2UgcmVtb3ZlIHRoZSBmb3JtZXIgKHRvCi8vIGJlIGNvbXBhdGlibGUgd2l0aCB0aGUgYmVoYXZpb3Igb2YgUGFuZG9jIDwgMi44KS4KZG9jdW1lbnQuYWRkRXZlbnRMaXN0ZW5lcignRE9NQ29udGVudExvYWRlZCcsIGZ1bmN0aW9uKGUpIHsKICB2YXIgaHMgPSBkb2N1bWVudC5xdWVyeVNlbGVjdG9yQWxsKCJkaXYuc2VjdGlvbltjbGFzcyo9J2xldmVsJ10gPiA6Zmlyc3QtY2hpbGQiKTsKICB2YXIgaSwgaCwgYTsKICBmb3IgKGkgPSAwOyBpIDwgaHMubGVuZ3RoOyBpKyspIHsKICAgIGggPSBoc1tpXTsKICAgIGlmICghL15oWzEtNl0kL2kudGVzdChoLnRhZ05hbWUpKSBjb250aW51ZTsgIC8vIGl0IHNob3VsZCBiZSBhIGhlYWRlciBoMS1oNgogICAgYSA9IGguYXR0cmlidXRlczsKICAgIHdoaWxlIChhLmxlbmd0aCA+IDApIGgucmVtb3ZlQXR0cmlidXRlKGFbMF0ubmFtZSk7CiAgfQp9KTsK"></script>
+<script>// Pandoc 2.9 adds attributes on both header and div. We remove the former (to
+// be compatible with the behavior of Pandoc < 2.8).
+document.addEventListener('DOMContentLoaded', function(e) {
+ var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
+ var i, h, a;
+ for (i = 0; i < hs.length; i++) {
+ h = hs[i];
+ if (!/^h[1-6]$/i.test(h.tagName)) continue; // it should be a header h1-h6
+ a = h.attributes;
+ while (a.length > 0) h.removeAttribute(a[0].name);
+ }
+});
+</script>
<style type="text/css">
code{white-space: pre-wrap;}
@@ -32,7 +44,188 @@
-<link rel="stylesheet" href="data:text/css,body%20%7B%0Abackground%2Dcolor%3A%20%23fff%3B%0Amargin%3A%201em%20auto%3B%0Amax%2Dwidth%3A%20700px%3B%0Aoverflow%3A%20visible%3B%0Apadding%2Dleft%3A%202em%3B%0Apadding%2Dright%3A%202em%3B%0Afont%2Dfamily%3A%20%22Open%20Sans%22%2C%20%22Helvetica%20Neue%22%2C%20Helvetica%2C%20Arial%2C%20sans%2Dserif%3B%0Afont%2Dsize%3A%2014px%3B%0Aline%2Dheight%3A%201%2E35%3B%0A%7D%0A%23TOC%20%7B%0Aclear%3A%20both%3B%0Amargin%3A%200%200%2010px%2010px%3B%0Apadding%3A%204px%3B%0Awidth%3A%20400px%3B%0Aborder%3A%201px%20solid%20%23CCCCCC%3B%0Aborder%2Dradius%3A%205px%3B%0Abackground%2Dcolor%3A%20%23f6f6f6%3B%0Afont%2Dsize%3A%2013px%3B%0Aline%2Dheight%3A%201%2E3%3B%0A%7D%0A%23TOC%20%2Etoctitle%20%7B%0Afont%2Dweight%3A%20bold%3B%0Afont%2Dsize%3A%2015px%3B%0Amargin%2Dleft%3A%205px%3B%0A%7D%0A%23TOC%20ul%20%7B%0Apadding%2Dleft%3A%2040px%3B%0Amargin%2Dleft%3A%20%2D1%2E5em%3B%0Amargin%2Dtop%3A%205px%3B%0Amargin%2Dbottom%3A%205px%3B%0A%7D%0A%23TOC%20ul%20ul%20%7B%0Amargin%2Dleft%3A%20%2D2em%3B%0A%7D%0A%23TOC%20li%20%7B%0Aline%2Dheight%3A%2016px%3B%0A%7D%0Atable%20%7B%0Amargin%3A%201em%20auto%3B%0Aborder%2Dwidth%3A%201px%3B%0Aborder%2Dcolor%3A%20%23DDDDDD%3B%0Aborder%2Dstyle%3A%20outset%3B%0Aborder%2Dcollapse%3A%20collapse%3B%0A%7D%0Atable%20th%20%7B%0Aborder%2Dwidth%3A%202px%3B%0Apadding%3A%205px%3B%0Aborder%2Dstyle%3A%20inset%3B%0A%7D%0Atable%20td%20%7B%0Aborder%2Dwidth%3A%201px%3B%0Aborder%2Dstyle%3A%20inset%3B%0Aline%2Dheight%3A%2018px%3B%0Apadding%3A%205px%205px%3B%0A%7D%0Atable%2C%20table%20th%2C%20table%20td%20%7B%0Aborder%2Dleft%2Dstyle%3A%20none%3B%0Aborder%2Dright%2Dstyle%3A%20none%3B%0A%7D%0Atable%20thead%2C%20table%20tr%2Eeven%20%7B%0Abackground%2Dcolor%3A%20%23f7f7f7%3B%0A%7D%0Ap%20%7B%0Amargin%3A%200%2E5em%200%3B%0A%7D%0Ablockquote%20%7B%0Abackground%2Dcolor%3A%20%23f6f6f6%3B%0Apadding%3A%200%2E25em%200%2E75em%3B%0A%7D%0Ahr%20%7B%0Aborder%2Dstyle%3A%20solid%3B%0Aborder%3A%20none%3B%0Aborder%2Dtop%3A%201px%20solid%20%23777%3B%0Amargin%3A%2028px%200%3B%0A%7D%0Adl%20%7B%0Amargin%2Dleft%3A%200%3B%0A%7D%0Adl%20dd%20%7B%0Amargin%2Dbottom%3A%2013px%3B%0Amargin%2Dleft%3A%2013px%3B%0A%7D%0Adl%20dt%20%7B%0Afont%2Dweight%3A%20bold%3B%0A%7D%0Aul%20%7B%0Amargin%2Dtop%3A%200%3B%0A%7D%0Aul%20li%20%7B%0Alist%2Dstyle%3A%20circle%20outside%3B%0A%7D%0Aul%20ul%20%7B%0Amargin%2Dbottom%3A%200%3B%0A%7D%0Apre%2C%20code%20%7B%0Abackground%2Dcolor%3A%20%23f7f7f7%3B%0Aborder%2Dradius%3A%203px%3B%0Acolor%3A%20%23333%3B%0Awhite%2Dspace%3A%20pre%2Dwrap%3B%20%0A%7D%0Apre%20%7B%0Aborder%2Dradius%3A%203px%3B%0Amargin%3A%205px%200px%2010px%200px%3B%0Apadding%3A%2010px%3B%0A%7D%0Apre%3Anot%28%5Bclass%5D%29%20%7B%0Abackground%2Dcolor%3A%20%23f7f7f7%3B%0A%7D%0Acode%20%7B%0Afont%2Dfamily%3A%20Consolas%2C%20Monaco%2C%20%27Courier%20New%27%2C%20monospace%3B%0Afont%2Dsize%3A%2085%25%3B%0A%7D%0Ap%20%3E%20code%2C%20li%20%3E%20code%20%7B%0Apadding%3A%202px%200px%3B%0A%7D%0Adiv%2Efigure%20%7B%0Atext%2Dalign%3A%20center%3B%0A%7D%0Aimg%20%7B%0Abackground%2Dcolor%3A%20%23FFFFFF%3B%0Apadding%3A%202px%3B%0Aborder%3A%201px%20solid%20%23DDDDDD%3B%0Aborder%2Dradius%3A%203px%3B%0Aborder%3A%201px%20solid%20%23CCCCCC%3B%0Amargin%3A%200%205px%3B%0A%7D%0Ah1%20%7B%0Amargin%2Dtop%3A%200%3B%0Afont%2Dsize%3A%2035px%3B%0Aline%2Dheight%3A%2040px%3B%0A%7D%0Ah2%20%7B%0Aborder%2Dbottom%3A%204px%20solid%20%23f7f7f7%3B%0Apadding%2Dtop%3A%2010px%3B%0Apadding%2Dbottom%3A%202px%3B%0Afont%2Dsize%3A%20145%25%3B%0A%7D%0Ah3%20%7B%0Aborder%2Dbottom%3A%202px%20solid%20%23f7f7f7%3B%0Apadding%2Dtop%3A%2010px%3B%0Afont%2Dsize%3A%20120%25%3B%0A%7D%0Ah4%20%7B%0Aborder%2Dbottom%3A%201px%20solid%20%23f7f7f7%3B%0Amargin%2Dleft%3A%208px%3B%0Afont%2Dsize%3A%20105%25%3B%0A%7D%0Ah5%2C%20h6%20%7B%0Aborder%2Dbottom%3A%201px%20solid%20%23ccc%3B%0Afont%2Dsize%3A%20105%25%3B%0A%7D%0Aa%20%7B%0Acolor%3A%20%230033dd%3B%0Atext%2Ddecoration%3A%20none%3B%0A%7D%0Aa%3Ahover%20%7B%0Acolor%3A%20%236666ff%3B%20%7D%0Aa%3Avisited%20%7B%0Acolor%3A%20%23800080%3B%20%7D%0Aa%3Avisited%3Ahover%20%7B%0Acolor%3A%20%23BB00BB%3B%20%7D%0Aa%5Bhref%5E%3D%22http%3A%22%5D%20%7B%0Atext%2Ddecoration%3A%20underline%3B%20%7D%0Aa%5Bhref%5E%3D%22https%3A%22%5D%20%7B%0Atext%2Ddecoration%3A%20underline%3B%20%7D%0A%0Acode%20%3E%20span%2Ekw%20%7B%20color%3A%20%23555%3B%20font%2Dweight%3A%20bold%3B%20%7D%20%0Acode%20%3E%20span%2Edt%20%7B%20color%3A%20%23902000%3B%20%7D%20%0Acode%20%3E%20span%2Edv%20%7B%20color%3A%20%2340a070%3B%20%7D%20%0Acode%20%3E%20span%2Ebn%20%7B%20color%3A%20%23d14%3B%20%7D%20%0Acode%20%3E%20span%2Efl%20%7B%20color%3A%20%23d14%3B%20%7D%20%0Acode%20%3E%20span%2Ech%20%7B%20color%3A%20%23d14%3B%20%7D%20%0Acode%20%3E%20span%2Est%20%7B%20color%3A%20%23d14%3B%20%7D%20%0Acode%20%3E%20span%2Eco%20%7B%20color%3A%20%23888888%3B%20font%2Dstyle%3A%20italic%3B%20%7D%20%0Acode%20%3E%20span%2Eot%20%7B%20color%3A%20%23007020%3B%20%7D%20%0Acode%20%3E%20span%2Eal%20%7B%20color%3A%20%23ff0000%3B%20font%2Dweight%3A%20bold%3B%20%7D%20%0Acode%20%3E%20span%2Efu%20%7B%20color%3A%20%23900%3B%20font%2Dweight%3A%20bold%3B%20%7D%20%0Acode%20%3E%20span%2Eer%20%7B%20color%3A%20%23a61717%3B%20background%2Dcolor%3A%20%23e3d2d2%3B%20%7D%20%0A" type="text/css" />
+
+<style type="text/css">body {
+background-color: #fff;
+margin: 1em auto;
+max-width: 700px;
+overflow: visible;
+padding-left: 2em;
+padding-right: 2em;
+font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
+font-size: 14px;
+line-height: 1.35;
+}
+#TOC {
+clear: both;
+margin: 0 0 10px 10px;
+padding: 4px;
+width: 400px;
+border: 1px solid #CCCCCC;
+border-radius: 5px;
+background-color: #f6f6f6;
+font-size: 13px;
+line-height: 1.3;
+}
+#TOC .toctitle {
+font-weight: bold;
+font-size: 15px;
+margin-left: 5px;
+}
+#TOC ul {
+padding-left: 40px;
+margin-left: -1.5em;
+margin-top: 5px;
+margin-bottom: 5px;
+}
+#TOC ul ul {
+margin-left: -2em;
+}
+#TOC li {
+line-height: 16px;
+}
+table {
+margin: 1em auto;
+border-width: 1px;
+border-color: #DDDDDD;
+border-style: outset;
+border-collapse: collapse;
+}
+table th {
+border-width: 2px;
+padding: 5px;
+border-style: inset;
+}
+table td {
+border-width: 1px;
+border-style: inset;
+line-height: 18px;
+padding: 5px 5px;
+}
+table, table th, table td {
+border-left-style: none;
+border-right-style: none;
+}
+table thead, table tr.even {
+background-color: #f7f7f7;
+}
+p {
+margin: 0.5em 0;
+}
+blockquote {
+background-color: #f6f6f6;
+padding: 0.25em 0.75em;
+}
+hr {
+border-style: solid;
+border: none;
+border-top: 1px solid #777;
+margin: 28px 0;
+}
+dl {
+margin-left: 0;
+}
+dl dd {
+margin-bottom: 13px;
+margin-left: 13px;
+}
+dl dt {
+font-weight: bold;
+}
+ul {
+margin-top: 0;
+}
+ul li {
+list-style: circle outside;
+}
+ul ul {
+margin-bottom: 0;
+}
+pre, code {
+background-color: #f7f7f7;
+border-radius: 3px;
+color: #333;
+white-space: pre-wrap;
+}
+pre {
+border-radius: 3px;
+margin: 5px 0px 10px 0px;
+padding: 10px;
+}
+pre:not([class]) {
+background-color: #f7f7f7;
+}
+code {
+font-family: Consolas, Monaco, 'Courier New', monospace;
+font-size: 85%;
+}
+p > code, li > code {
+padding: 2px 0px;
+}
+div.figure {
+text-align: center;
+}
+img {
+background-color: #FFFFFF;
+padding: 2px;
+border: 1px solid #DDDDDD;
+border-radius: 3px;
+border: 1px solid #CCCCCC;
+margin: 0 5px;
+}
+h1 {
+margin-top: 0;
+font-size: 35px;
+line-height: 40px;
+}
+h2 {
+border-bottom: 4px solid #f7f7f7;
+padding-top: 10px;
+padding-bottom: 2px;
+font-size: 145%;
+}
+h3 {
+border-bottom: 2px solid #f7f7f7;
+padding-top: 10px;
+font-size: 120%;
+}
+h4 {
+border-bottom: 1px solid #f7f7f7;
+margin-left: 8px;
+font-size: 105%;
+}
+h5, h6 {
+border-bottom: 1px solid #ccc;
+font-size: 105%;
+}
+a {
+color: #0033dd;
+text-decoration: none;
+}
+a:hover {
+color: #6666ff; }
+a:visited {
+color: #800080; }
+a:visited:hover {
+color: #BB00BB; }
+a[href^="http:"] {
+text-decoration: underline; }
+a[href^="https:"] {
+text-decoration: underline; }
+
+code > span.kw { color: #555; font-weight: bold; }
+code > span.dt { color: #902000; }
+code > span.dv { color: #40a070; }
+code > span.bn { color: #d14; }
+code > span.fl { color: #d14; }
+code > span.ch { color: #d14; }
+code > span.st { color: #d14; }
+code > span.co { color: #888888; font-style: italic; }
+code > span.ot { color: #007020; }
+code > span.al { color: #ff0000; font-weight: bold; }
+code > span.fu { color: #900; font-weight: bold; }
+code > span.er { color: #a61717; background-color: #e3d2d2; }
+</style>
@@ -46,38 +239,73 @@
<h1 class="title toc-ignore">Developing with clipr</h1>
<h4 class="author">Matthew Lincoln</h4>
-<h4 class="date">2022-02-18</h4>
+<h4 class="date">2023-01-19</h4>
<div id="calling-clipr-safely" class="section level2">
<h2>Calling clipr safely</h2>
-<p>To check whether the system has been properly configured to allow access to the clipboard, you may run <code>clipr_available()</code> which will either return <code>TRUE</code> or <code>FALSE</code>. This will be particularly useful for Linux-based systems, where clipr’s functionality depends on the installation of additional software. If you wish to display system requirements and configuration messages to X11 and Wayland users, <code>dr_clipr()</code> will print these.</p>
+<p>To check whether the system has been properly configured to allow
+access to the clipboard, you may run <code>clipr_available()</code>
+which will either return <code>TRUE</code> or <code>FALSE</code>. This
+will be particularly useful for Linux-based systems, where clipr’s
+functionality depends on the installation of additional software. If you
+wish to display system requirements and configuration messages to X11
+and Wayland users, <code>dr_clipr()</code> will print these.</p>
</div>
<div id="interactive-non-interactive-use" class="section level2">
<h2>Interactive & non-interactive use</h2>
-<p>If you use clipr in your own package, <strong>you must not try to call it in non-interactive sessions</strong>, as this goes against <a href="https://cran.r-project.org/web/packages/policies.html">CRAN repository policy</a>:</p>
+<p>If you use clipr in your own package, <strong>you must not try to
+call it in non-interactive sessions</strong>, as this goes against <a href="https://cran.r-project.org/web/packages/policies.html">CRAN
+repository policy</a>:</p>
<blockquote>
-<p>Packages should not write in the user’s home filespace (including clipboards), nor anywhere else on the file system apart from the R session’s temporary directory (or during installation in the location pointed to by TMPDIR: and such usage should be cleaned up). Installing into the system’s R installation (e.g., scripts to its bin directory) is not allowed.</p>
-<p>Limited exceptions may be allowed in interactive sessions if the package obtains confirmation from the user.</p>
+<p>Packages should not write in the user’s home filespace (including
+clipboards), nor anywhere else on the file system apart from the R
+session’s temporary directory (or during installation in the location
+pointed to by TMPDIR: and such usage should be cleaned up). Installing
+into the system’s R installation (e.g., scripts to its bin directory) is
+not allowed.</p>
+<p>Limited exceptions may be allowed in interactive sessions if the
+package obtains confirmation from the user.</p>
</blockquote>
-<p>For this reason, <code>write_clip()</code> will error by default in non-interactive use, which includes CRAN tests.</p>
-<p>If you want to use <code>write_clip()</code> non-interactively, you may either set the environment variable <code>CLIPR_ALLOW=TRUE</code> or call <code>write_clip(..., allow_non_interactive = TRUE)</code>.</p>
+<p>For this reason, <code>write_clip()</code> will error by default in
+non-interactive use, which includes CRAN tests.</p>
+<p>If you want to use <code>write_clip()</code> non-interactively, you
+may either set the environment variable <code>CLIPR_ALLOW=TRUE</code> or
+call <code>write_clip(..., allow_non_interactive = TRUE)</code>.</p>
</div>
<div id="testing-on-cran-and-ci" class="section level2">
<h2>Testing on CRAN and CI</h2>
-<p>A few best practices will also help you responsibly test your clipr-using package on headless systems like CRAN or other testing infrastructure like Travis:</p>
+<p>A few best practices will also help you responsibly test your
+clipr-using package on headless systems like CRAN or other testing
+infrastructure like Travis:</p>
<ol style="list-style-type: decimal">
-<li>Examples that will try to use <code>read_clip()</code> or <code>write_clip()</code> ought to be wrapped in <code>\dontrun{}</code></li>
-<li>Tests calling clipr should be conditionally skipped, based on the output of <code>clipr_available()</code>. This is necessary to pass CRAN checks, as otherwise <code>write_clip</code> will error out.</li>
-<li>If you are using a headless system to check your package build on Linux, consult the <a href="https://github.com/mdlincoln/clipr/blob/main/.github/workflows/R-CMD-check.yaml">GitHub Actions workflow</a> for this package, which includes code for setting the <code>DISPLAY</code> and <code>CLIPR_ALLOW</code> environment variables, installing <code>xclip</code> and <code>xsel</code>, and running a pre-build script that will set up <code>xclip</code>/<code>xsel</code> to run headlessly under XVFB.</li>
+<li>Examples that will try to use <code>read_clip()</code> or
+<code>write_clip()</code> ought to be wrapped in
+<code>\dontrun{}</code></li>
+<li>Tests calling clipr should be conditionally skipped, based on the
+output of <code>clipr_available()</code>. This is necessary to pass CRAN
+checks, as otherwise <code>write_clip</code> will error out.</li>
+<li>If you are using a headless system to check your package build on
+Linux, consult the <a href="https://github.com/mdlincoln/clipr/blob/main/.github/workflows/R-CMD-check.yaml">GitHub
+Actions workflow</a> for this package, which includes code for setting
+the <code>DISPLAY</code> and <code>CLIPR_ALLOW</code> environment
+variables, installing <code>xclip</code> and <code>xsel</code>, and
+running a pre-build script that will set up
+<code>xclip</code>/<code>xsel</code> to run headlessly under XVFB.</li>
</ol>
</div>
<div id="using-clipr-with-shiny" class="section level2">
<h2>Using clipr with Shiny</h2>
<p>clipr won’t do what you expect when you call it with Shiny.</p>
-<p>clipr talks to the clipboard of the <em>system that is running R</em>. If you create a Shiny app and tell one of its functions to either read from or write to the clipboard, it can only access the clipboard of the server it is running on. R running on the <em>remote</em> server has no way to access the <em>local</em> clipboard belonging to your end user.</p>
-<p>However, you can instruct the user’s <em>internet browser</em> to write to the user’s clipboard by using <a href="https://cran.r-project.org/package=rclipboard">rclipboard</a>.</p>
+<p>clipr talks to the clipboard of the <em>system that is running
+R</em>. If you create a Shiny app and tell one of its functions to
+either read from or write to the clipboard, it can only access the
+clipboard of the server it is running on. R running on the
+<em>remote</em> server has no way to access the <em>local</em> clipboard
+belonging to your end user.</p>
+<p>However, you can instruct the user’s <em>internet browser</em> to
+write to the user’s clipboard by using <a href="https://cran.r-project.org/package=rclipboard">rclipboard</a>.</p>
</div>
Debdiff
File lists identical (after any substitutions)
Control files: lines which differ (wdiff format)
Depends: r-base-core (>= 4.2.1-1), 4.2.2.20221110-1), r-api-4.0