example - ¿Roxygen2 automáticamente escribe las directivas NAMESPACE para los paquetes de "Imports:"?

roxygen2 documentation data

Question

tl; dr versión de mi pregunta

Si deseo importar paquetes, ¿tengo que escribir manualmente las directivas de import() en mi archivo NAMESPACE? Parece que roxygen2 no hará mágicamente eso por mí, incluso si los tengo listados como "Importaciones:" en mi descripción.

Versión más completa

Esta es una pregunta bastante tonta, pero pregunto porque la respuesta no es obvia para mí.

Uso roxygen2 para manejar la documentación de mi paquete R. Cuando quiero asegurarme de que se exporta una función, agrego una etiqueta @export a su bloque roxygen. Las ejecuciones posteriores de roxygenize() escribirán la directiva NAMESPACE en consecuencia.

Pero, mi paquete actualmente importa varios otros:

Depends:
    R (>= 2.13.0),
    ggplot2 (>= 0.8.9)
Imports:
    RColorBrewer,
    plyr,
    gridExtra

Parece que mientras roxygen2 reescribirá la directiva NAMESPACE para las funciones exportadas , no reescribirá automáticamente NAMESPACE para reflejar los paquetes que he designado que deberían importarse en mi DESCRIPCIÓN.

Answer 1

Ampliando mi comentario, si quiere agregar automáticamente directivas de namespace para paquetes / funciones que import , puede hacerlo agregando el @imports package @importFrom package function o la línea de @importFrom package function roxygen2 encabezado de documentación de roxygen2 de su función.

Sin embargo, como @hadley señaló, solo modificará el NAMESPACE , pero no afectará el paquete.