Displaying 20 results from an estimated 2000 matches similar to: "function help?"
2009 Jun 21
5
Roxygen vs Sweave for S4 documentation
Hi,
I have been using R for a while. Recently, I have begun converting my
package into S4 classes. I was previously using Rdoc for documentation.
Now, I am looking to use the best tool for S4 documentation. It seems that
the best choices for me are Roxygen and Sweave (I am fine with tex).
Are there any users of Roxygen or Sweave who can comment on the strengths or
weaknesses of one or othe
2018 Jan 30
7
Best practices in developing package: From a single file
On 30/01/2018 11:29 AM, Brian G. Peterson wrote:
> On Tue, 2018-01-30 at 17:00 +0100, Suzen, Mehmet wrote:
>> Dear R developers,
>>
>> I am wondering what are the best practices for developing an R
>> package. I am aware of Hadley Wickham's best practice
>> documentation/book (http://r-pkgs.had.co.nz/).??I recall a couple of
>> years ago there were some
2015 Oct 04
2
Conditional importFrom (roxygen?)
Duncan Murdoch <murdoch.duncan <at> gmail.com> writes:
>
> On 04/10/2015 10:10 AM, Jonathan Greenberg wrote:
> > Folks:
> >
[snip snip snip]
> >
> > Is there a way to do a conditional importFrom based on the OS? Or can I
> > safely ignore this (I'm trying to submit to CRAN).
> >
>
> Yes, you can put conditionals into the
2009 Sep 01
2
List of tags in roxygen and use for S4 classes?
Hi
is there a list of all roxygen tags which are available? I couldn't find them.
I am asking specifically towards the use of roxygen in documenting S4
classes - is that implemented yet (i am using roxygen 0.1 from CRAN at
the moment)?
Thanks
Rainer
--
Rainer M. Krug, Centre of Excellence for Invasion Biology,
Stellenbosch University, South Africa
2009 Jun 21
2
Roxygen to ignore a block of code?
Any way to tell Roxygen to ignore a block of code? It is generating an
unwanted .Rd file.
I've been searching for hours for an example, scouring documentation, but no
luck...
Thanks.
- Ken
--
View this message in context: http://www.nabble.com/Roxygen-to-ignore-a-block-of-code--tp24133293p24133293.html
Sent from the R help mailing list archive at Nabble.com.
2018 Jan 30
3
Best practices in developing package: From a single file
Dear R developers,
I am wondering what are the best practices for developing an R
package. I am aware of Hadley Wickham's best practice
documentation/book (http://r-pkgs.had.co.nz/). I recall a couple of
years ago there were some tools for generating a package out of a
single file, such as using package.skeleton, but no auto-generated
documentation. Do you know a way to generate
2011 Apr 07
1
R 2.13.0-beta for Windows, file.copy() throws suspicious errors due to default value of copy.mode
While checking packages against R 2.13.0-beta on Windows, I have run into a
few strange error messages related to copying files. The errors all relate
to file.copy() and have the form of:
Error in Sys.chmod(to[okay], file.info(from[okay])$mode, TRUE) :
'mode' must be of length at least one
After half a day of tinkering, the best reproducible example I can come up
with involves using
2009 Jan 30
2
error message with roxygen
Hello useRs,
I'm trying to use the Roxygen package.
Here my code file :
#' A packge to check Roxygen's sanity
#' @name helloRoxygen-package
#' @docType package
NA
And my R code to generate the package :
library(roxygen)
package.skeleton("helloRoxygen", code_files = "roxy.r", force = T)
roxygenize("helloRoxygen", "helloRoxygen",
2010 Nov 25
3
Go (back) from Rd to roxygen
Hi all,
Since roxygen is a great help to document R packages, I am wondering
if there exists an approach to go back from the raw Rd files to
roxygen-documentation? E.g. turn "\author{Somebody}" into "@author
Somebody". This sounds ridiculous, but I believe it helps in the long
term for me to maintain R packages.
Thanks!
Regards,
Yihui
--
Yihui Xie <xieyihui at
2010 Nov 04
2
Roxygen: @example tag does not work for me
Dear list,
somehow I can't get the Roxygen tag "@example" to work for me.
My "Roxygen-Header" of a script containing, say, a function looks like this:
#' My header
#'
#' My description
#'
#' @param a Blabla.
#' @param b Blabla.
#' @return \code{TRUE}.
#' @callGraphPrimitives
#' @references
#'
2009 Sep 03
1
Problem accessing functions in package 'roxygen'
I have Vista Home with R-2.9.0, and installed and tried to test the
package 'roxygen':
> utils:::menuInstallPkgs()
trying URL
'http://lib.stat.cmu.edu/R/CRAN/bin/windows/contrib/2.9/roxygen_0.1.zip'
Content type 'application/zip' length 699474 bytes (683 Kb)
opened URL
downloaded 683 Kb
package 'roxygen' successfully unpacked and MD5 sums checked
The
2018 Jan 31
3
Best practices in developing package: From a single file
On 31/01/2018 6:33 AM, Joris Meys wrote:
> 3. given your criticism, I'd like your opinion on where I can improve
> the documentation of https://github.com/CenterForStatistics-UGent/pim.
> I'm currently busy updating the help files for a next release on CRAN,
> so your input is more than welcome.
After this invitation I sent some private comments to Joris. I would
say his
2012 Jun 15
2
Build fails with sysdata.rda in R dir
Hi,
I am getting a strange error with 15.0 which I've not seen with previous
versions of R.
If sysdata.rda is included in R directory of the package I am getting:
R CMD build betfairly.roxygen/
* checking for file ?betfairly.roxygen/DESCRIPTION? ... OK
* preparing ?betfairly?:
* checking DESCRIPTION meta-information ... OK
* excluding invalid files
Subdirectory 'R' contains invalid
2018 Feb 01
3
Best practices in developing package: From a single file
On Thu, Feb 1, 2018 at 5:24 AM, Lionel Henry <lionel at rstudio.com> wrote:
> On 31 janv. 2018, at 09:08, Gabriel Becker <gmbecker at ucdavis.edu> wrote:
>
> > it *actively discourages* the bits it doesn't directly support.
>
> It may be discouraging to include Rd syntax in roxygen docs but only
> because the LaTeX-like syntax of Rd is burdensome, not because
2018 Jan 31
3
Best practices in developing package: From a single file
Dear All:
stepping in late, but @Joris, if you would like to take 'from a single file' literally,
have a look at:
https://github.com/bpfaff/lp4rp
(lp4rp: literate programming for R packages);
Cheers,
Bernhard
ps: incidentally, within the noweb-file roxygen is employed.
-----Urspr?ngliche Nachricht-----
Von: R-devel [mailto:r-devel-bounces at r-project.org] Im Auftrag von Joris
2018 Jan 31
2
Best practices in developing package: From a single file
Joris,
With the large caveat that I am not Duncan, and thus am not speaking for
him, I can see an argument for his claim that I think is, more or less,
true.
roxygen2 (as far as I know as someone who uses it at least some of the
time) maps to only a subset of Rd. It is the most commonly used subset, and
so you can do most common things with it, but I think a pretty good case
can be made for the
2009 Jul 08
2
"Roxygenating" packages
Is there any interest in a method of taking a package with
documentation in Rd files and attaching it to package R files in
Roxygen format? I can see a few problems with a totally general
solution but it might be possible to make a script that provides a
kickstart to converting a package to Roxygen.
Or is it trickier than it seems?
Barry
2018 Jan 31
1
Best practices in developing package: From a single file
I fully agree with Joris and Hadley on roxygen2.
Additionally:
I wrote and published my first package before roxygen (or roxygen2) was
available. I found editing .Rd extremely terse (especially when code is
updated). For example, the fact that there are no spaces allowed between }
and { in \param{}{} has hurt my brain quite a few times, especially since R
CMD check did not give any useful error
2013 Jul 20
1
roxygen
I am modifying a package that appears to have been made with roxygen. I'm
currently running Debian stable (wheezy) amd64 with the stock R 2.15.1. I
have some other, mostly older, flavors as well.
roxygen doesn't seem to be in the Debian repositories or (if I wanted to
switch to R v3) http://cran.r-project.org/bin/linux/debian/wheezy-cran3/.
Any tips? Just install from source and
2011 Aug 23
5
Easier ways to create .Rd files?
R-helpers:
Are there any ways to auto-generate R-friendly (e.g. will pass a
compilation check) .Rd files given a set of .R code? How about GUIs
that help properly format the .Rd files? Thanks! I want a basic set
of .Rd files that I can update as I go, but as with most things my
documentation typically lags behind my coding by a few days.
--j
--
Jonathan A. Greenberg, PhD
Assistant Project