diff --git a/ecrire/action/editer_liens.php b/ecrire/action/editer_liens.php
index 16d168557ec4fbe6e1cbfeee2fc590a97a63af83..be2b2cea824b92ab6fa669a98c2591570e3ac83a 100644
--- a/ecrire/action/editer_liens.php
+++ b/ecrire/action/editer_liens.php
@@ -94,15 +94,15 @@ function objet_associer($objets_source, $objets_lies, $qualif = null){
 /**
  * Dissocier un (ou des) objet(s)  des objets listés
  * 
- * $objets_source et $objets sont de la forme
- * array($objet=>$id_objets,...)
- * $id_objets peut lui meme etre un scalaire ou un tableau pour une liste d'objets du meme type
+ * `$objets_source` et `$objets_lies` sont de la forme
+ * `array($objet=>$id_objets,...)`
+ * `$id_objets` peut lui-même être un scalaire ou un tableau pour une liste d'objets du même type
  *
  * Les objets sources sont les pivots qui portent les liens
  * et pour lesquels une table spip_xxx_liens existe
  * (auteurs, documents, mots)
  *
- * un * pour $objet,$id_objet permet de traiter par lot
+ * un * pour $objet, $id_objet permet de traiter par lot
  * seul le type de l'objet source ne peut pas accepter de joker et doit etre explicite
  *
  * S'il y a des rôles possibles entre les 2 objets, et qu'aucune condition
diff --git a/ecrire/inc/utils.php b/ecrire/inc/utils.php
index b4734478eb85859c95393d71a679937fa050490d..e05d95a51268a1d5a9e1cb66c5ddbd7ed3884c3a 100644
--- a/ecrire/inc/utils.php
+++ b/ecrire/inc/utils.php
@@ -1513,19 +1513,22 @@ function test_valeur_serveur($truc) {
 // Fonctions de fabrication des URL des scripts de Spip
 //
 /**
- * l'URL de base du site, sans se fier a meta(adresse_site) qui
- * peut etre fausse (sites a plusieurs noms d'hotes, deplacements, erreurs)
- * Note : la globale $profondeur_url doit etre initialisee de maniere a
- * indiquer le nombre de sous-repertoires de l'url courante par rapport a la
- * racine de SPIP : par exemple, sur ecrire/ elle vaut 1, sur sedna/ 1, et a
- * la racine 0. Sur url/perso/ elle vaut 2
- * http://code.spip.net/@url_de_base
+ * Calcule l'url de base du site
+ *
+ * Calcule l'URL de base du site, sans se fier à la méta (adresse_site) qui
+ * peut être fausse (sites avec plusieurs noms d’hôtes, déplacements, erreurs)
+ * 
+ * @note
+ *     La globale `$profondeur_url` doit être initialisée de manière à
+ *     indiquer le nombre de sous-répertoires de l'url courante par rapport à la
+ *     racine de SPIP : par exemple, sur ecrire/ elle vaut 1, sur sedna/ 1, et à
+ *     la racine 0. Sur url/perso/ elle vaut 2
  *
  * @param int|boo|array $profondeur
- *    si non renseignee : retourne l'url pour la profondeur $GLOBALS['profondeur_url']
- *    si int : indique que l'on veut l'url pour la prondeur indiquee
- *    si bool : retourne le tableau static complet
- *    si array : reinitialise le tableau static complet avec la valeur fournie
+ *    - si non renseignée : retourne l'url pour la profondeur $GLOBALS['profondeur_url']
+ *    - si int : indique que l'on veut l'url pour la profondeur indiquée
+ *    - si bool : retourne le tableau static complet
+ *    - si array : réinitialise le tableau static complet avec la valeur fournie
  * @return string|array
  */
 function url_de_base($profondeur=null) {