问题
I am trying to make a package but when I run document()
it prints NAMESPACE not generated by roxygen2. Skipped.
I am trying to use ggplot2,XML, R6
packages in my functions. I am importing them in the following way:
#' @rdname visualization
#' @param hist_data A table of weather variables with PWS created by hist_data function
#' @param variable A character string of variable name
#' @examples
#' table <- getWeather(city = "San Francisco", state="CA")
#' please <- getConditionsTable(table, "2015-03-09")
#' tab <- hist_data(table, please)
#' head(tab)
#' plot_variable_across_all_pws(hist_data=tab, variable="tempi")
#' @import ggplot2
#' @import XML
#' @import R6
I am wondering what might be causing this error and there is nothing in my Namespace
except for exportPattern("^[^\\.]")
Also, I was going over R packages book by Hadley http://r-pkgs.had.co.nz/namespace.html And confused by the line :
"Note that you can choose to use roxygen2 to generate just NAMESPACE, just man/*.Rd, or both. If you don’t use any namespace related tags, roxygen2 won’t touch NAMESPACE. If you don’t use any documentation related tags, roxygen2 won’t touch man/."
Is this what I'm doing wrong? or missing?
回答1:
- Backup NAMESPACE file, if you need it for future use
- Delete the NAMESPACE file
- Run
devtools::document()
, so that roxygen2 will generate new NAMESPACE file in the package source directory
*** make sure you have @export
tag in the roxygen2 doc section of the R source file.
回答2:
I think that devtools
tries to avoid overwriting DESCRIPTION and NAMESPACE files that it didn't generate itself (to avoid angst if you have meticulously typed them in yourself, instead of using embedded roxygen comments in your r code). It isn't always possible but it tries.
The main mechanism, as I understand it, is to post a comment at the top of the file when it generates the file, and then later on, look for that comment (there are tricky bits round the edge, for example if you use @include
s to create the Collate order in the DESCRIPTION file, but I don't think that is your problem here.)
An example of such a comment is
# Generated by roxygen2 (4.1.0.9001): do not edit by hand
The not generated by ...
message is alerting you to this, and letting you know devtools
is not going to use roxygen2
to make a NAMESPACE file for you. You possibly have the one you mention without the comment because you used RStudio to start your package, rather than devtools::create()
?
If you just delete the NAMESPACE file, I think devtools::document()
would then work for you.
BTW You have a typo in the example code above (you have#' @import ggplo2
instead of #' @import ggplot2
)
回答3:
Also one may simply delete everything from NAMESPACE and add leave one line: exportPattern("^[[:alpha:]]+")
If the file NAMESPACE is changed manually, devtools::document()
fails to overwrite this file, that is why it leaves as before. When you delete the text from the NAMESPACE file and insert this line, devtools::document()
thinks that the file is new and overwrites it.
回答4:
None of the preceding examples worked for me. If I deleted the NAMESPACE
file then roxygen
complained there was no NAMESPACE
. If I deleted and re-created a NAMESPACE
file (with `touch, e.g. RStudio: Building package with roxygen2. Not producing NAMESPACE file) then roxygen complained that the file was not created with roxygen.
The solution was to copy a NAMESPACE
file from another project that was created with roxygen.
来源:https://stackoverflow.com/questions/29135971/namespace-not-generated-by-roxygen2-skipped-confusion-with-hadley-book