On 06/09/2017 11:08 AM, Aimin Yan wrote:
I have a question about making R package documentation.

I use rstudio to make this package. In my test.R file, I have code like the
following:

...

#' @return Returns a dataframe with several following variables (columns)
#'   \itemize{
#'      \item geneID: Gene ID
#'      \item geneWisePvalue: each gene is represented by the smallest
p-value among its features
#'      \item sig.gene: a gene is significant (1) or not (0)
#'      \item mostSigDeFeature: the most significant gene feature
#'      \item numFeature: number of gene features within the gene
#' }

...

After rebuild, I get help documentation like the following:
Value

Returns a dataframe with several following variables (columns)

    -

    geneID: Gene ID
    -

    geneWisePvalue: each gene is represented by the smallest p-value among
    its features
    -

    sig.gene: a gene is significant (1) or not (0)
    -

    mostSigDeFeature: the most significant gene feature
    -

    numFeature: number of gene features within the gene


    Now, I want to get the following:
    Value

    Returns a dataframe with several following variables (columns)

              geneID: Gene ID

              geneWisePvalue: each gene is represented by the smallest
    p-value among its features

              sig.gene: a gene is significant (1) or not (0)

              mostSigDeFeature: the most significant gene feature

              numFeature: number of gene features within the gene

    That is to say, to create a a bulleted list without bullets.

    Does anyone has idea on how to change settings in test.R file?

I looked at

https://github.com/wch/r-source/blob/trunk/src/library/stats/man/lm.Rd#L122

which leads me to

 #' @return
 #' \item{foo}{bar}

works.

Also, from RShowDoc("R-exts")

  \describe{
    \item{foo}{bar}
  }

might also be relevant in non-\value sections.

Martin



    Thank you,

    Aimin

        [[alternative HTML version deleted]]

_______________________________________________
Bioc-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/bioc-devel



This email message may contain legally privileged and/or...{{dropped:2}}

_______________________________________________
Bioc-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/bioc-devel

Reply via email to