writeManPage {AnnBuilder}R Documentation

Functions that write supporting files needed by a data package

Description

The functions are mainly used to write man pages and supporting functions that are needed for a data package

Usage

writeManPage(pkgName, pkgPath, manName, organism = "human", src, isEnv =
TURE)
writeMan4Fun(pkgName, pkgPath, organism, QCList)
formatName(toFormat)
writeREADME(pkgPath, pkgName, urls)
writeDescription(pkgName, pkgPath, version, author)
getDSrc(organism)
getSrcNBuilt(dSrc, organism)
getUrlNBuilt(src, organism)
getDSrc{organism}
writeAccessory(pkgName, pkgPath, organism, version, author = c(name =
"who", address = "who@email.net"))
writeFun(pkgPath, pkgName, organism = "human")
writeZZZ(pkgPath, pkgName)
getAllRdaName(pkgName, pkgPath)
escapeLatexChr(item)
writeMan4QC(pkgName, pkgPath)
getExample(pkgName, manName, isEnv = TRUE)
getSrcBuiltNRef(src, organism)
getBuild4Yeast(src, manName)

Arguments

pkgname A character string for the name of a data package or R library
pkgName Same as pkgname
path A character string for the path where pkgname resides
pkgPath Same as path
elenames A vector of character strings for the name of rda files to be produced. The names should be in the first column of AnnInfo.rda in the data subdirectory of AnnBuilder
organism A character string for the name of the organism of interests
short A boolean that is set to TRUE when the man page is for rda files produced by the three functions aforementioned in which case package name will be part of the name of the Rd files to be produced. Otherwise, package name will not be part of the name of the Rd files produced
fName A character string for the name of the Rd file to be produced
tagName A character string for a Latex tag to be written to the Rd file. Valid tags can be found in "Writing R Extensions"
tagCont A character string for the content to be written to a Latex tag
toFormat A character string form whom any underscore will be removed
urls A vector of character of string for the urls of the data source used to create the rda files
header A character string for a short description of an annotation element
isXML A boolean indicating whether header is an XML header (TRUE) or a string (FALSE)
title A character string for the title of an Rd file that is going to be created
desc A character string for the description of the Rd file that is going to be created
keyword A character string for the keyword of the Rd file to be created. The key word must be a standard R keyword
name A character string to be put in a Latex format "
xxx
" where xxx = name
content A character string to be put between the "{}" following "
"
dSrc A vector of character strings containing the short names of public data sources (e. g. LL for LocusLink)
src A character string for the short name of a public data source
filename A character string for the name of the to write to
version A character string for the version number
author A named vector of strings with two elements named name and address, respectively. Name is a character string for the name of the person who maintains the data package and address is the email address of the person
item A character string to be escaped by if it is a latex character
QCList A list with statistical data derived from getDPStats
manName manName a character string for the name of the man page to be created
isEnv isEnv a boolean to indicate whether the object a man page concerns is an R environment or not

Details

If pkgname = "XX" and elenames = "yy", the Rd file will be "XXyy.Rd" appended to the path if short is FALSE. Otherwise, the Rd file will be "yy.Rd" appended to the path.

writeManPage writes a man page for a given object that is stored in the data directory.

getExample creates a set of example code that is going to be used in a man page depending on whether the man page is for an environment object or not.

getSrcBuiltNRef creates the text that is going to be used for built and reference information in a man page.

getBuild4Yeast creates the text that is going to be used for built and reference information for the man page for yeast.

Value

All functions return a character string.

Note

The functions are part of the Bioconductor project at Dana-Farber Cancer Institute to provide BioInformatics functionalities through R

Author(s)

Jianhua Zhang

References

An Introduction to R - Writing R Extensions

Examples

makeSrcInfo()
dir.create(file.path(".", "pkg"))
dir.create(file.path(".", "pkg", "data"))
dir.create(file.path(".", "pkg", "man"))
writeManPage("pkg", getwd(), "CHR")
list.files(file.path(getwd(), "pkg", "data"))
unlink("pkg", TRUE)

[Package Contents]