-// Utilisee pour vider le cache depuis l'espace prive
-// (ou juste les squelettes si un changement de config le necessite)
-// si $atime est passee en argument, ne pas supprimer ce qui a servi
-// plus recemment que cette date (via fileatime)
-// retourne le nombre de fichiers supprimes
-// http://doc.spip.org/@purger_repertoire
+/**
+ * Purge un répertoire de ses fichiers
+ *
+ * Utilisée entre autres pour vider le cache depuis l'espace privé
+ *
+ * @uses supprimer_fichier()
+ *
+ * @param string $dir
+ * Chemin du répertoire à purger
+ * @param array $options
+ * Tableau des options. Peut être :
+ *
+ * - atime : timestamp pour ne supprimer que les fichiers antérieurs
+ * à cette date (via fileatime)
+ * - mtime : timestamp pour ne supprimer que les fichiers antérieurs
+ * à cette date (via filemtime)
+ * - limit : nombre maximum de suppressions
+ * @return int
+ * Nombre de fichiers supprimés
+**/