Documentation du code :

- objet_associer (par pierretux) : Rajout d'accent
- translitteration_complexe (par Ybbet) : Correction de l'accent du a` confondu avec un code markdown
- ecrire_meta (par Ybbet) : Faute de frappe
- verifier_session (par pierretux) : Lien vers la doc inutile
- nettoyer_uri (par Ybbet) : L'url vers code.spip.net cassait la mise en page sur le site.


Relecteur : Matthieu Marcillaud

ecrire/action/editer_liens.php

@@ -62,19 +62,19 @@ function objet_associable($objet){
 /**
  * Associer un ou des objets à des objets listés
  * 
- * $objets_source et $objets_lies 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
- * ou de la forme array("NOT",$id_objets) pour une selection par exclusion
+ * `$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
+ * ou de la forme `array("NOT", $id_objets)` pour une sélection par exclusion
  *
  * Les objets sources sont les pivots qui portent les liens
  * et pour lesquels une table spip_xxx_liens existe
  * (auteurs, documents, mots)
  *
- * on peut passer optionnellement une qualification du (des) lien(s) qui sera
- * alors appliquee dans la foulee.
- * En cas de lot de liens, c'est la meme qualification qui est appliquee a tous
- *
+ * On peut passer optionnellement une qualification du (des) lien(s) qui sera
+ * alors appliquée dans la foulée.
+ * En cas de lot de liens, c'est la même qualification qui est appliquée a tous
+ * 
  * @api
  * @param array $objets_source
  * @param array|string $objets_lies

ecrire/inc/charsets.php

@@ -809,8 +809,8 @@ function translitteration($texte, $charset='AUTO', $complexe='') {
 /**
  * Translittération complexe
  *
- * `à` est retourné sous la forme "a`" et pas "a"
- * mais si `$chiffre=true`, on retourne "a8" (vietnamien)
+ * `à` est retourné sous la forme ``a` `` et pas `à`
+ * mais si `$chiffre=true`, on retourne `a8` (vietnamien)
  * 
  * @uses translitteration()
  * @param string $texte

ecrire/inc/meta.php

@@ -148,7 +148,7 @@ function effacer_meta($nom, $table='meta') {
 }
 
 /**
- * Met à jour où crée une meta avec la clé et valeur indiquée
+ * Met à jour ou crée une meta avec la clé et la valeur indiquée
  *
  * @see ecrire_config()
  * @see effacer_config()

ecrire/inc/session.php

@@ -190,8 +190,6 @@ function ajouter_session($auteur) {
  *
  * Retourne false en cas d'echec, l'id_auteur de la session si defini, null sinon
  *
- * http://code.spip.net/@verifier_session
- *
  * @param bool $change
  * @return bool|int|null
  */

ecrire/inc/utils.php

@@ -505,8 +505,7 @@ function ancre_url($url, $ancre) {
 }
 
 /**
- * pour le nom du cache, les types_urls et self
- * http://code.spip.net/@nettoyer_uri
+ * Pour le nom du cache, les `types_urls` et `self`
  *
  * @param string|null $reset
  * @return string