Hi Iaw,
Hadley's book is generally a good starting point. For an overview of the
roxygen2, I have a summary on http://www.iysik.com/r/roxygen2, which is but
a small addition to the current sphere of knowledge.
Re. your questions:
> * is it possible to import a set of *.Rd man documentation files into my
R session?
It is not clear what you are trying here. Rd documentation is not code
(except the examples), so importing it into an R session seems to me
nonsense. If you want to import existing Rd documention into a roxygen2
documentation, you will have to copy-paste the text and give it the
necessary tags.
> * is it still good practice to place my functions into their own
environments
Yes, this complicates everything. Stop doing it.
I do not have answers to your other questions.
/Stefan
Den man. 18. feb. 2019 kl. 02.02 skrev ivo welch <ivo.we...@gmail.com>:
> Apologies for the Intrusion. I am trying to learn package development with
> roxygen. The ecosystem has been moving so fast that much of what I learned
> by googling and reading on the web (including old posts) seems to be at
> least mildly outdated.
>
> * does the r-package-devel mailing list have a search engine? (or generic
> google?) a FAQ?
>
> * could someone please point me to a good current example that follows
> appropriate style and other guidelines, using the '@' roxygen documentation
> format? (The '@' example In Hadley's book does not include a @name, which
> my `document()` does not like.)
>
> I also have a few specific questions, but I may be able to figure it out
> given the above.
>
> * is it possible to import a set of *.Rd man documentation files into my R
> session?
>
> * is it still good practice to place my functions into their own
> environments (aka `me$myfun <- cmpfun(function() message("my fun")`). I am
> thinking that this complicates matters unnecessarily in a package, given
> that packages have namespaces, and environment prefixes makes documentation
> access more complex (not ?me$myfun but ?'me$myfun' now). and should I lose
> the `cmpfun` in a package?
>
> basic pointers appreciated.
>
> /iaw
>
> [[alternative HTML version deleted]]
>
> ______________________________________________
> R-package-devel@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-package-devel
>
[[alternative HTML version deleted]]
______________________________________________
R-package-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-package-devel
