Generate a Shell for Documentation of a Package
Generates a shell of documentation for an installed or source package.
promptPackage(package, lib.loc = NULL, filename = NULL, name = NULL, final = FALSE)
characterstring with the name of an installed or source package to be documented.
- a character vector describing the location of Rlibrary trees to search through, or
NULL. The default value of
NULLcorresponds to all libraries currently known. For a source package this should specify the parent directory of the package's sources.
- usually, a connection or a character string giving the
name of the file to which the documentation shell should be written.
The default corresponds to a file whose name is
".Rd". Can also be
- a character string specifying the name of the help topic,
typically of the form
- a logical value indicating whether to attempt to create a usable version of the help topic, rather than just a shell.
NA, a documentation shell for
package is written to the file specified by
a message about this is given.
NA, a list-style representation of the
documentation shell is created and returned. Writing the shell to a
file amounts to
cat(unlist(x), file = filename, sep = "\n"),
x is the list-style representation.
TRUE, the generated documentation will not
include the place-holder slots for manual editing, it will be usable
as-is. In most cases a manually edited file is preferable (but
final = TRUE is certainly less work).
NA, a list-style representation of the documentation shell. Otherwise, the name of the file written to is returned invisibly.
filename <- tempfile() promptPackage("utils", filename = filename) file.show(filename) unlink(filename)