-
Notifications
You must be signed in to change notification settings - Fork 0
/
HowToRoxygen2
72 lines (68 loc) · 1.99 KB
/
HowToRoxygen2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
## FUNCTIONS
#' A title
#'
#' A description
#'
#' @param param1 A \code{class}. A description of the parameter,
#' its use, the values it can take.
#' @param param2 ...
#' @param param3 ...
#'
#' @details
#' Details regarding the arguments of the function, the requirements
#' for this function to work (required columns in input files,
#' architecture offile tree..).
#'
#' @return A \code{class} with a descritpion of what it contains
#' depending on the input parameters.
#'
#' @author Author One, Author Two
#'
#' @seealso \code{\link{anotherFunction}}, \code{\link{aClass}},
#' \code{link{aMethod}}
#'
#' @examples
#' #A first example
#' res <- thefunction(param1 = 12, param2 = NULL, param3 = "FDR")
#'
#' #A second example
#' res2 <- thefunction(param1 = 12, param2 = NULL, param3 = "absolute")
#'
#' @export
#' @importFrom package1 function1 function2
#' @importClassesFrom package1 class1
To have multiple functions in the same file:
Document the first function as described above + add @param for the parameters
of the second function + specify @rdname filename.
In the second function:
#' @rdname filename
#' @export
usage section gets created autiomatically for both functions in the same file.
## CLASSES
#' classname class
#'
#' Description of the class, its purpose
#'
#' @section Slots:
#' \describe{
#' \item{featureRange}{A \code{RangedData object}. The ranges and sequences of
#' the peptides and their associated annotation.}
#' \item{phenoData}{An \code{AnnotatedDataFrame}. Annotation for the samples.}
#' \item{assayData}{}
#' \item{featureData}{}
#' \item{annotation}{}
#' \item{protocolData}{Slots inherited from \code{ExpressionSet}.}
#' }
#'
#' @details
#' See \code{?`peptideSet-methods`} for a list of accessors and method associated
#' with the class.
#'
#' @seealso \code{\link{ExpressionSet}}, \code{\link{peptideSet-methods}}
#'
#' @importClassesFrom Biobase ExpressionSet
#' @importClassesFrom IRanges RangedData
#' @aliases -class
#' @exportClass peptideSet
#' @author First Last
#'