diff --git a/ecrire/exec/upgrade.php b/ecrire/exec/upgrade.php
index 5a7aebd9490a98eededa37e4f21113d8a3df4b62..dee01bdf8dcb204e5c7bc59cb646ed2bc461d56a 100644
--- a/ecrire/exec/upgrade.php
+++ b/ecrire/exec/upgrade.php
@@ -15,7 +15,11 @@ if (!defined('_ECRIRE_INC_VERSION')) return;
 include_spip('inc/actions');
 include_spip('inc/headers');
 
-// http://doc.spip.org/@exec_upgrade_dist
+/**
+ * Fonction d'installation et de mise à jour du core de SPIP
+ * 
+ * @return void
+**/
 function exec_upgrade_dist()
 {
 
diff --git a/ecrire/inc/utils.php b/ecrire/inc/utils.php
index de309ec3b75fb944dfb10eff451ea999b254f87e..6032354d0b4d2bdcdbd45cd79600a312d21e6253 100644
--- a/ecrire/inc/utils.php
+++ b/ecrire/inc/utils.php
@@ -938,13 +938,13 @@ function texte_script($texte) {
 /**
  * Gestion des chemins (ou path) de recherche de fichiers par SPIP
  *
- * Empile de nouveaux chemins (à la suite de ceux déjà présent, mais avant
- * le répertoire squelettes ou les dossiers squelettes), si un reéertoire
+ * Empile de nouveaux chemins (à la suite de ceux déjà présents, mais avant
+ * le répertoire `squelettes` ou les dossiers squelettes), si un répertoire
  * (ou liste de répertoires séparés par `:`) lui est passé en paramètre.
  *
  * Ainsi, si l'argument est de la forme `dir1:dir2:dir3`, ces 3 chemins sont placés
- * en tete du path, dans cet ordre (hormis squelettes & la globale
- * $dossier_squelette si definie qui resteront devant)
+ * en tête du path, dans cet ordre (hormis `squelettes` & la globale
+ * `$dossier_squelette` si définie qui resteront devant)
  * 
  * Retourne dans tous les cas la liste des chemins.
  *