J'ai utilisé 'package.skeleton()' pour générer des fichiers d'aide .Rd il y a quelques mois. J'ai édité ces fichiers, et j'ai également changé les fonctions, supprimé certaines fonctions, ajouté d'autres. Y at-il une fonction qui automatise la mise à jour des fichiers Rd?Existe-t-il un moyen de mettre à jour automatiquement la documentation dans un paquet R?
mise à jour
Un joli paquet vient de sortir appelé Rd2roxygen, il est décrit par l'auteur Yihui Xie sur son blog.
Comme son nom l'indique, ce package permet d'insérer rétroactivement la documentation actuellement contenue dans .RD dans des fichiers .R. Cela semble être une approche prometteuse pour l'apprentissage de roxygen et pour la conversion de paquets en cours de développement en paquets R. Woo hoo. Merci Yihui!
Sur la base des réponses de Joshua et Yihui, la réponse semble être: roxygen permet la mise à jour automatique des fichiers Rd etc en fonction des changements dans la source code .R, et si je ne l'utilise roxygen actuellement, Rd2roxygen peut aider moi migrer.
Quels sont les avantages de roxygen par rapport aux outils décrits dans "writing R extensions"? –
Principalement qu'il crée les fichiers .Rd pour vous en fonction des informations supplémentaires que vous ajoutez aux fichiers source .R. –
@David Un avantage très important est qu'il facilite l'écriture de la documentation immédiatement après l'écriture du code --- vous n'avez même pas besoin de changer de fichier. Ensuite, non seulement les détails importants sont frais dans votre tête, mais vous pouvez écrire les docs pendant le "woohoo! étape au lieu de la "pouah ... devoir revenir en arrière et documenter tout" étape de la production. – Sharpie