parse_file() error that can occur when
\keywords{} is empty in .Rd (thanks, @byandell, #29).@examplesIf.@examplesIf.\link[pkg:name]{name} to
\link[pkg:topic]{name}, due to the recent requirement of
CRAN that links should point to the topic instead of nameroxygen_and_build() now calls
roxygen2::roxygenize() in a new R session.rab() no longer reformats code in the usage sections of
Rd files.rab()rab(install = TRUE) can automatically generate an Rd
file for objects that are imported from other packages and later
re-exported in the current package; this is done through the internal
function importRd()
when build = FALSE and install = TRUE
in rab(), the package directory instead of the built tar
ball is installed
added an argument install.opts to rab()
to specify options for R CMD INSTALL (default:
--with-keep.source if build = FALSE, otherwise
empty)
added an argument before to rab() so we
can evaluate an R expression before the package is roxygenized and
built
if the Examples section starts with a special token
# !formatR, the example code will not be
reformatted
spaces will be added after commas in \item{},
e.g. \item{x,y,z}{} will be converted to
\item{x, y, z}{}
added NULL to create_roxygen() when docType is data or package (#9)
Rd2roxygen() tries to add the @export tags according to the exported names in the NAMESPACE (#10, #11 and #12)
when reformatting usage and example sections, rab() tries to make code width smaller than 90, as required by R CMD check
\item{} in the \value{} section will be
formatted as the @returnItem tag, which is a new tag in
roxygen2 (> 2.2.2) (#8) (thanks, Andreas Alfons)
R code in \dontrun{}, \dontshow{} and
\donttest{} can be reformatted by formatR now
the vignette is built with knitr via the Makefile; in previous versions, it was a fake Rnw document (essentially a weaved tex file)
dependency on roxygen2 and formatR was changed to Imports
default value for ‘check.opts’ in rab() is ‘–as-cran’ now
\section{title}{content} will be converted
to ##' @section title: content (thanks, Brian G.
Peterson)\dontrun{} can be correctly reformatted now; there was
a bug in the previous version when options(replace.assign = TRUE)\method{generic}{class}(param = value) can be correctly
reformatted now; in previous versions rab() will ignore such usage
sectionsRd files that have \docType{data} or
\docType{package} (for datasets and package documentation)
are written into xxx-package.R directly; these names are not looked up
in R scripts under the R directory of the source package
Rd comments (following %) will be ignored when generating roxygen comments for arguments
a complete example of running Rd2roxygen() on a real package was added to ?Rd2roxygen
re-run Rd2roxygen() on a package will remove the roxygen comments in R scripts before adding new roxygen comments parsed from Rd files; in old versions of this package, the old roxygen comments were not removed, hence the comments were added incrementally above the function objects, which was certainly not desirable
foo <-, ‘foo’ <-, “foo” <-, and =
can be used as the assigning operator as well\% becomes %) before the code is
reformatted, then escaped again; this can avoid errors when reformatting
the code, since \% is an illegal character in Rthe escape and use.Rd2 arguments are removed in rab() since roxygen2 can handle these cases elegantly
roxygen.dir is the same as the package directory by default, so rab() will write all the documentations in the original package directory
the usage section is no longer reformatted by formatR; roxygen2 formats it nicely
the function rm_undocumented() is no longer needed, so it was removed from this package; use @noRd if you do not want the documentation of a certain object to be generated by roxygen2