help2flatdoc {mvbutils} | R Documentation |
Converts a vanilla R help file (as shown in the internal pager) to plain-text format. The output conventions are those in doc2Rd
, so the output can be turned into Rd-format by running it through doc2Rd
. This function is useful if you have existing Rd-format documentation and want to try out the flatdoc
system of integrated code and documentation.
help2flatdoc( fun.name, pkg=NULL, text=NULL)
fun.name |
function name (a character string) |
pkg |
name of package |
text |
plain-text help |
The package containing fun.name
must be loaded first. If you write documentation using flatdoc
, prepare the package with pre.install
, build it with RCMD BUILD or INSTALL, and run help2flatdoc
on the result, you should largely recover your original flat-format documentation.
Aliasses are deduced from function calls in the USAGE section.
(Link-triggering phrases aren't explicitly created– could look thru lists of linkable things I guess.)
cd.doc <- help2flatdoc( "cd", "mvbutils") print( cd.doc) cd.Rd <- doc2Rd( cd.doc)