Path to this page:
Subject: CVS commit: pkgsrc/devel/R-roxygen2
From: Makoto Fujiwara
Date: 2022-12-18 05:51:33
Message id: 20221218045133.D7791FA90@cvs.NetBSD.org
Log Message:
(devel/R-roxygen2) Updated 7.1.2 to 7.2.3
# roxygen2 7.2.3
* roxygen2 now supports HTML blocks in markdown. They are only included
in the HTML manual. They can also be produced as the output of code
chunks.
* Improved support for RStudio IDE.
# roxygen2 7.2.2
* `@includeRmd` calls `local_reproducible_output()` to make code run in
included `.Rmd`s more consistent with other sources (#1431).
* Fix duplicated argument in `roxy_block()` to avoid CRAN removal.
# roxygen2 7.2.1
## Tags
* All built-in tags are now documented so that you can do (e.g.) \
`?"@param"`
to get a basic description of `@param` and a pointer where to learn more
(#1165). This is powered by a new `tags_list()` lists all tags defined by
roxygen2 and `tags_metadata()` provides some useful information about them
for use by (e.g.) IDEs (#1375).
* `@describeIn` can now be used to combine more types of functions
(generics, methods and other functions) into a single topic.
The resulting section organises the functions by type (#1181)
and displays methods like function calls. Methods are recognized only if
they extend the generic in the destination,or if the destination can
heuristically be identified as a constructor.
* Code evaluated in inline markdown code chunks and `@eval`/`@evalRd`/
`@evalNamespace` is now evaluated in an environment designed to be more
reproducible and to suppress output that won't work in Rd (e.g. turning
off colour and unicode support in cli) (#1351). They now also set
knitr options `comment = #>` (#1380) and `collapse = TRUE` (#1376).
* `@export` will now export both the class and constructor function when
applied to expressions like `foo <- setClass("foo")` (#1216).
* `@includeRmd` now gives better feedback when it fails (#1089).
## (R)markdown
* New `knitr_chunk_options` option (in the `Roxygen` entry of
`DESCRIPTION` or in `man/roxygen/meta.R`) is added to the knitr chunk
options that roxygen2 uses for markdown code blocks and inline
code (#1390).
* PDF figures are only included the PDF manual, and SVG figures are only
included in the HTML manual (#1399).
* You can now use alternative knitr engines in markdown code blocks (#1149).
* Generated HTML for code blocks never includes "NA" for language (#1251).
* Using a level 1 heading in the wrong tag now gives a more useful warning
(#1374).
* Fix bug interpolating the results of indented inline RMarkdown (#1353).
## Other
* If you have a daily build of RStudio, the lists of changed Rd files are
now clickable so you can immediately see the rendered development
documentation (#1354).
* R6 documentation no longer shows inherited methods if there aren't any
(#1371), and only links to superclass docs if they're actually available
(#1236).
* Automated usage no longer mangles nbsp in default arguments (#1342).
# roxygen2 7.2.0
## New features
* The NAMESPACE roclet now preserves all existing non-import directives during
it's first pre-processing pass. This eliminates the "NAMESPACE has \
changed"
messages and reduces the incidence of namespace borking (#1254).
* `@inheritParams` now only inherits exact multiparameter matches, so if you're
inheriting from a function with `@param x,y` you'll only get the parameter
documentation if your function needs docs for both x and y (#950).
* All warning messages have been reviewed to be more informative and
actionable (#1317). `@title` now checks for multiple paragraphs.
`@export` gives a more informative warning if it contains too many lines.
(#1074). All tags warn now if only provide whitespace (#1228), and
problems with the first tag in each block are reported with the correct line
number (#1235).
* If you have a daily build of RStudio, roxygen2 warnings will now include a
clickable hyperlink that will take you directly to the problem (#1323).
This technology is under active development across the IDE and the cli
package but is extremely exciting.
## Minor improvements and bug fixes
* roxygen2 can once again read UTF-8 paths on windows (#1277).
* `@author`s are de-duplicated in merged documentation (@DanChaltiel, #1333).
* `@exportS3method pkg::generic` now works when `pkg::generic` isn't
imported by your package (#1085).
* `@includeRmd` is now adapted to change in rmarkdown 2.12 regarding math
support in `github_document()` (#1304).
* `@inherit` and friends perform less aggressive link tweaking, eliminating
many spurious warnings. Additionally, when you do get a warning, you'll
now always learn which topic it's coming from (#1135). Inherited
`\ifelse{}{}{}` tags are now inserted correctly (without additional `{}`)
(#1062).
* `@inherit` now supports inheriting "Notes" with `@inherit pkg::fun note`
(@pat-s, #1218)
* Automatic `@usage` now correctly wraps arguments containing syntactically
significant whitespace (e.g anonymous functions) (#1281) and non-syntactic
values surrounded by backticks (#1257).
* Markdown:
* Code blocks are always wrapped in `<div class="sourceCode">`
even if the language is unknown (#1234).
* Links with markup (e.g. ``[foo `bar`][target]``) now cause an informative
warning instead of generating invalid Rd.
* Curly braces in links are now escaped (#1259).
* Inline R code is now powered by knitr. Where available, (knit) print
methods are applied (#1179). This change alters outputs and brings roxygen
in line with console and R markdown behavior. `x <- "foo"` no \
longer
inserts anything into the resulting documentation, but `x <- \
"foo"; x`
will. This also means that returning a character vector will insert
commas between components, not newlines.
* roxygen2 no longer generates invalid HTML (#1290).
* DOIs, arXiv links, and urls in the `Description` field of the `DESCRIPTION`
are now converted to the appropriate Rd markup (@dieghernan, #1265, #1164).
DOIs in the `URL` field of the `DESCRIPTION` are now converted to Rd's
special `\doi{}` tag (@ThierryO, #1296).
Files: