Que signifie «ne pas fonctionner» dans les pages d'aide R?

Parfois, sur une page d'aide R, la phrase «not run» apparaît dans les commentaires. Vérifiez ceci sur la page d'aide pour "avec ()":

Examples
require(stats); require(graphics)
#examples from glm:
**## Not run:** 
library(MASS)
with(anorexia, {
    anorex.1 <- glm(Postwt ~ Prewt + Treat + offset(Prewt),
                    family = gaussian)
    summary(anorex.1)
})
## End(**Not run**)

Que signifie «ne pas exécuter» dans l'exemple de code?

"not run" renferme du code qui ne doit pas être exécuté dans la examplefonction (par exemple, des parties de code chronophages, une interaction avec l'utilisateur, ...).

voir par exemple ?example:

Comme détaillé dans le manuel Writing R Extensions , l'auteur de la page d'aide peut baliser des parties des exemples pour deux règles d'exception

• 'dontrun' renferme du code qui ne doit pas être exécuté.

• 'dontshow' renferme du code qui est invisible sur les pages d'aide, mais qui sera exécuté à la fois par les outils de vérification des packages et par la fonction 'example ()'. C'était auparavant «testonly», et ce formulaire est toujours accepté.

Dans le manuel "Writing R Extensions" , dans la section about \ examples {...} il est dit que

Vous pouvez utiliser \ dontrun {} pour le texte qui ne doit être affiché, mais pas exécuté, et \ dontshow {} pour des commandes supplémentaires pour les tests qui ne doivent pas être montrées aux utilisateurs, mais qui seront exécutées par example ()

Lorsque vous créez un package, tout le code de la fermeture \ dontrun {} est visible dans l'aide comme

## Not run:
...
## End(**Not run**)

edit: Cette réponse était plus tôt.

Ceci ajoute \donttest{}et est repris (textuellement) des packages R de @ hadley .

Cependant, à des fins d'illustration, il est souvent utile d'inclure du code qui provoque une erreur. \dontrun{}vous permet d'inclure du code dans l'exemple qui n'est jamais utilisé. Il existe deux autres commandes spéciales. \dontshow{}est exécuté, mais n'apparaît pas dans la page d'aide: cela peut être utile pour des tests informels. \donttest{}est exécuté dans les exemples, mais pas automatiquement dans le contrôle R CMD. Ceci est utile si vous avez des exemples qui prennent beaucoup de temps à s'exécuter. Les options sont résumées ci-dessous.

Command      example    help       R CMD check
\dontrun{}                 x
\dontshow{}       x                          x
\donttest{}       x        x

C & p du chapitre 5.4 (Fichiers de documentation R) du MUST-TO-READ Création de packages R: un tutoriel de Friedrich Leisch:

La section des exemples doit contenir du code R exécutable, et l'exécution automatique du code fait partie de la vérification d'un package. Il existe deux commandes de balisage spéciales pour les exemples:

dontrun : Tout ce qui se trouve à l'intérieur de \ dontrun {} n'est pas exécuté par les tests ou example (). Ceci est utile, par exemple, pour les fonctions interactives, les fonctions accédant à Internet, etc. Ne pas en abuser pour vous faciliter la vie en donnant des exemples qui ne peuvent pas être exécutés.

L'exemple canonique ici pourrait être dans la page d'aide pour rm:

## Not run: 
## remove (almost) everything in the working environment.
## You will get no warning, so don't do this unless you are really sure.
rm(list = ls())

## End(Not run)

Si cela fonctionnait, cela aurait bien sûr des effets indésirables.