write_the_docs: Write Documentation to Disk

View source: R/document.R

write_the_docsR Documentation

Write Documentation to Disk

Description

Read R documentation files from a package's source, convert and write them to disk.

Usage

write_the_docs(
  package_directory,
  file_name = package_directory,
  output_directory = tempdir(),
  dependencies = NULL,
  sanitize_Rd = TRUE,
  runit = FALSE
)

Arguments

package_directory

The directory containing the package's source.

file_name

The name of the file where to write the documentation into. See Details.

output_directory

The directory to put the documentation into. You might want to use dirname(file_name).

dependencies

A character vector of package names the functions depend on.

sanitize_Rd

Remove strange characters from Rdconv?

runit

Convert the text received from the help files if running RUnit? Do not bother, this is for Unit testing only.

Details

file_name will usually be provided by document as the R code file's name. This may, differing from a (temporary) package's name, contain underscores. If you use the functions directly: stick with the default, in which case internally the basename of your package_directory will be used. This should be a good guess.

Value

A list containing

pdf_path

The path to the pdf file produced.

txt_path

The path to the text file produced.

html_path

The path to the html file produced.


document documentation built on July 9, 2023, 5:22 p.m.