## ----setup, echo=FALSE------------------------------------
knitr::opts_chunk$set(comment = NA, message = FALSE)
options(formatR.blank = FALSE, width = 60)

## ----roxygen-ex-------------------------------------------
## the source code of the function `parse_and_save`
ex.file = system.file('examples', 'parse_and_save.R', package = 'Rd2roxygen')
cat(readLines(ex.file), sep = '\n')

## ----rd-ex------------------------------------------------
rd.file = system.file('examples', 'parse_and_save.Rd', package = 'Rd2roxygen')
cat(readLines(rd.file), sep = '\n')

## ----Rd2roxygen, eval=FALSE-------------------------------
#  Rd2roxygen::Rd2roxygen('path/to/source/pkg')
#  ## there must be 'man' and 'R' directories under this path

## ----parse-file-------------------------------------------
library(Rd2roxygen)
## we can specify the roxygen comments prefix (#' by default)
options(roxygen.comment = "##' ")
str(info <- parse_file(rd.file))
# parse_and_save() combines these two steps
cat(create_roxygen(info), sep = '\n')

## ----rab, eval=FALSE, code=formatR::usage(rab)------------
#  rab(pkg, build = TRUE, build.opts = "--no-manual",
#      install = FALSE,
#      install.opts = if (build) "" else "--with-keep.source",
#      check = FALSE, check.opts = "--as-cran --no-manual",
#      remove.check = TRUE, reformat = TRUE, before = NULL,
#      ...)

## ----reformat-ex1, eval=FALSE, tidy=FALSE-----------------
#  ## original code
#  rab=function(pkg,build=TRUE,install=FALSE,
#  check=FALSE,check.opts='',remove.check=TRUE,reformat=TRUE,...){}

## ----reformat-ex2, eval=FALSE, tidy=TRUE------------------
#  ## the reformatted code; note the spaces and indent
#  rab=function(pkg,build=TRUE,install=FALSE,
#  check=FALSE,check.opts='',remove.check=TRUE,reformat=TRUE,...){}

## ----lyx-doc, eval=FALSE----------------------------------
#  system.file('doc', 'Rd2roxygen.Rmd', package='Rd2roxygen')