-if (!defined('_ECRIRE_INC_VERSION')) return;
-
-// --------------------------
-// Gestion des taches de fond
-// --------------------------
-
-// Deux difficultes:
-// - la plupart des hebergeurs ne fournissent pas le Cron d'Unix
-// - les scripts usuels standard sont limites a 30 secondes
-
-// Solution:
-// Toute connexion a SPIP s'acheve par un appel a la fonction cron()
-// qui appelle la fonction surchargeable genie dans inc/
-// Sa definition standard ci-dessous prend dans une liste de taches
-// la plus prioritaire, leurs dates etant donnees par leur fichier-verrou.
-// Une fonction executant une tache doit retourner un nombre:
-// - nul, si la tache n'a pas a etre effecutee
-// - positif, si la tache a ete effectuee
-// - negatif, si la tache doit etre poursuivie ou recommencee
-// Elle recoit en argument la date de la derniere execution de la tache.
-
-// On peut appeler cette fonction avec d'autres taches (pour etendre Spip)
-// specifiee par des fonctions respectant le protocole ci-dessus
-// On peut modifier la frequence de chaque tache et leur ordre d'analyse
-// en modifiant les variables ci-dessous.
-
-//----------
-
-// Les taches sont dans un tableau ('nom de la tache' => periodicite)
-// Cette fonction execute la tache la plus urgente
-// (celle dont la date de derniere execution + la periodicite est minimale)
-// La date de la derniere intervention est donnee par un fichier homonyme,
-// de suffixe ".lock", modifie a chaque intervention et des le debut
-// de celle-ci afin qu'un processus concurrent ne la demarre pas aussi.
-// Les taches les plus longues sont tronconnees, ce qui impose d'antidater
-// le fichier de verrouillage (avec la valeur absolue du code de retour).
-// La fonction executant la tache est un homonyme de prefixe "genie_".
-// Le fichier homonyme du repertoire "genie/" est automatiquement lu
-// et il est suppose definir cette fonction.
-
-// http://doc.spip.org/@inc_genie_dist
+if (!defined('_ECRIRE_INC_VERSION')) {
+ return;
+}
+
+/**
+ * Gestion des tâches de fond
+ *
+ * Deux difficultés :
+ * - la plupart des hebergeurs ne fournissent pas le Cron d'Unix
+ * - les scripts usuels standard sont limites à 30 secondes
+ *
+ * Solution
+ * --------
+ * Toute connexion à SPIP s'achève par un appel (asynchrone si possible)
+ * à la fonction `cron()` qui appelle la fonction surchargeable `inc_genie_dist()`
+ *
+ * Sa définition standard ci-dessous prend dans une liste de tâches
+ * la plus prioritaire.
+ *
+ * Une fonction exécutant une tâche doit retourner un nombre :
+ * - nul, si la tache n'a pas à être effecutée
+ * - positif, si la tache a été effectuée
+ * - négatif, si la tache doit être poursuivie ou recommencée
+ *
+ * Elle recoit en argument la date de la dernière exécution de la tâche.
+ *
+ * On peut appeler cette fonction avec d'autres tâches (pour étendre SPIP)
+ * spécifiée par des fonctions respectant le protocole ci-dessus.
+ *
+ * On peut ajouter des tâches périodiques ou modifier la fréquence
+ * de chaque tâche et leur priorité en utilisant le pipeline
+ * `taches_generales_cron`.
+ *
+ * On peut également directement en déclarer avec la balise `genie` d'un paquet.xml
+ * de plugin, tel que `<genie nom="nom_de_la_tache" periode="86400" />`
+ *
+ * @package SPIP\Core\Genie
+ **/
+
+
+/**
+ * Prévoit l'exécution de la tâche cron la plus urgente
+ *
+ * Les tâches sont dans un tableau `'nom de la tâche' => périodicité`
+ *
+ * Cette fonction exécute la tache la plus urgente, c'est à dire
+ * celle dont la date de dernière exécution + la périodicité est minimale.
+ *
+ * La date de la prochaîne exécution de chaque tâche est indiquée dans la
+ * table SQL `spip_jobs`
+ *
+ * La fonction exécutant la tâche est (généralement) un homonyme de préfixe "genie_".
+ * Le fichier homonyme du repertoire "genie/" est automatiquement lu
+ * et il est supposé définir cette fonction.
+ *
+ * @uses queue_add_job() Lorsqu'une tâche est à forcer
+ * @uses queue_schedule()
+ * @see taches_generales() Liste des tâches déclarées
+ *
+ * @param array $taches
+ * Tâches dont on force maintenant l'exécution le plus tôt possible.
+ * Sinon, prendra la tâche la plus prioritaire.
+ * @return
+ **/