example - roxygen2 documentation data
¿Roxygen2 6.0.0 ahora requiere "@export" en la última línea? (0)
Antes de actualizar a la versión 6.0.0 de roxygen2, parecía que el paquete era compatible con la etiqueta @export
no se encuentra en la parte inferior del encabezado de la función en un paquete. Por ejemplo:
#'' Title
#'' @param foo
#'' @return bar
#''
#'' @export
#''
#'' @seealso Other blah blah
El código anterior se compilaría correctamente con roxygen2
completando correctamente el espacio de nombres al usar mi instalación de la versión 5.0.1 de roxygen2
. Sin embargo, con la actualización, esta forma de documentación no funcionaría y roxygen2
elimina activamente de NAMESPACE.R .
Podría arreglar esto moviendo @export
al fondo
#'' Title
#'' @param foo
#'' @return bar
#''
#'' @seealso Other blah blah
#'' @export
Mi pregunta es si este problema ocurre por diseño? No puedo ver nada que especifique este cambio en @export en las notas de la versión: https://github.com/klutometis/roxygen/releases/tag/v6.0.0
¿Siempre fue así como se suponía que funcionaba roxygen2
y la operación hasta este punto no fue planeada? ¿O es esto un cambio deliberado?
NB Obviamente, hacer un mwe completo para diferentes versiones es difícil, cualquier sugerencia sobre cómo abordar esta bienvenida
EDITAR: Después de más pruebas, estoy empezando a sospechar que hay más que esto solo roxygen. Estoy utilizando los accesos directos de compilación y documento en rstudio, que también actualicé recientemente, e incluso retrocediendo a la versión 5.0.1 de roxygen2
me impide reconstruir la documentación de las funciones antiguas que solían funcionar.