From ab882b7428f46a3b0fd402de2fc86a3bb58bf514 Mon Sep 17 00:00:00 2001
From: Christian Lefebvre <christian_lefebvre@laposte.net>
Date: Wed, 1 Nov 2006 15:26:26 +0000
Subject: [PATCH] recup des echecs sur les commits automatiques du batch
 d'autodoc

---
 ecrire/action/editer_signatures.php     |  4 ++--
 ecrire/action/instituer_groupe_mots.php |  2 ++
 ecrire/action/instituer_mot.php         |  4 ++--
 ecrire/action/joindre.php               |  3 ++-
 ecrire/action/poster_forum_prive.php    |  4 ++--
 ecrire/exec/documents_colonne.php       |  1 +
 ecrire/exec/export_all.php              | 16 ++++++++--------
 ecrire/exec/forum_envoi.php             |  3 +++
 ecrire/exec/informer_auteur.php         |  1 +
 ecrire/exec/rechercher.php              |  1 +
 ecrire/exec/rechercher_auteur.php       |  2 +-
 ecrire/exec/selectionner_auteur.php     |  2 +-
 ecrire/inc/actions.php                  |  1 +
 ecrire/inc/chercher_rubrique.php        |  1 +
 ecrire/inc/drapeau_edition.php          |  1 +
 ecrire/inc/editer_auteurs.php           |  2 ++
 ecrire/inc/extra.php                    |  1 +
 ecrire/inc/formater_article.php         |  1 +
 ecrire/inc/formater_auteur.php          |  2 ++
 ecrire/inc/getdocument.php              |  2 ++
 ecrire/inc/iconifier.php                |  1 +
 ecrire/inc/informer_auteur.php          |  2 +-
 ecrire/inc/minipres.php                 |  3 +++
 ecrire/inc/notifications.php            |  1 +
 ecrire/inc/presentation.php             |  2 ++
 ecrire/inc/selectionner.php             |  1 +
 ecrire/inc/selectionner_auteur.php      |  2 ++
 ecrire/inc/signatures.php               |  3 ++-
 ecrire/inc/traduire.php                 |  2 +-
 ecrire/inc/utils.php                    |  2 ++
 ecrire/inc/vieilles_defs.php            |  2 ++
 ecrire/inc/xml.php                      |  3 +++
 ecrire/public/balises.php               |  2 +-
 33 files changed, 59 insertions(+), 21 deletions(-)

diff --git a/ecrire/action/editer_signatures.php b/ecrire/action/editer_signatures.php
index 9cbcc8d930..fc77601ec4 100644
--- a/ecrire/action/editer_signatures.php
+++ b/ecrire/action/editer_signatures.php
@@ -15,7 +15,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 include_spip('inc/actions');
 
 // Modifier le reglage des forums publics de l'article x
-// http://doc.spip.org/@action_poster_dist
+// http://doc.spip.org/@action_editer_signatures_dist
 function action_editer_signatures_dist()
 {
 	$var_f = charger_fonction('controler_action_auteur', 'inc');
@@ -28,7 +28,7 @@ function action_editer_signatures_dist()
 	} else action_editer_signatures_post($r);
 }
 
-// http://doc.spip.org/@action_poster_post
+// http://doc.spip.org/@action_editer_signatures_post
 function action_editer_signatures_post($r)
 {
 	$id = intval($r[1]);
diff --git a/ecrire/action/instituer_groupe_mots.php b/ecrire/action/instituer_groupe_mots.php
index 74345b9cc0..685aa5f803 100644
--- a/ecrire/action/instituer_groupe_mots.php
+++ b/ecrire/action/instituer_groupe_mots.php
@@ -16,6 +16,7 @@ include_spip('inc/actions');
 include_spip('inc/filtres');
 include_spip('base/abstract_sql');
 
+// http://doc.spip.org/@action_instituer_groupe_mots_dist
 function action_instituer_groupe_mots_dist()
 {
 	$var_f = charger_fonction('controler_action_auteur', 'inc');
@@ -29,6 +30,7 @@ function action_instituer_groupe_mots_dist()
 }
 
 
+// http://doc.spip.org/@action_instituer_groupe_mots_post
 function action_instituer_groupe_mots_post($r)
 {
 	global $acces_comite, $acces_forum, $acces_minirezo, $new, $articles, $breves, $change_type, $descriptif, $id_groupe, $obligatoire, $rubriques, $syndic, $texte, $unseul;
diff --git a/ecrire/action/instituer_mot.php b/ecrire/action/instituer_mot.php
index bae0ad3080..47642858c3 100644
--- a/ecrire/action/instituer_mot.php
+++ b/ecrire/action/instituer_mot.php
@@ -17,7 +17,7 @@ include_spip('inc/filtres');
 include_spip('base/abstract_sql');
 
 // Modifier le reglage des forums publics de l'article x
-// http://doc.spip.org/@action_poster_dist
+// http://doc.spip.org/@action_instituer_mot_dist
 function action_instituer_mot_dist()
 {
 	$var_f = charger_fonction('controler_action_auteur', 'inc');
@@ -30,7 +30,7 @@ function action_instituer_mot_dist()
 	} else action_instituer_mot_post($r);
 }
 
-// http://doc.spip.org/@action_poster_post
+// http://doc.spip.org/@action_instituer_mot_post
 function action_instituer_mot_post($r)
 {
 	$id_mot = $r[1];
diff --git a/ecrire/action/joindre.php b/ecrire/action/joindre.php
index eb90cf451e..b2e4d9568f 100644
--- a/ecrire/action/joindre.php
+++ b/ecrire/action/joindre.php
@@ -171,13 +171,14 @@ function spip_action_joindre6($path, $mode, $type, $id, $id_document,$hash, $red
 
 // Zip avec les 2 options a la fois
 
+// http://doc.spip.org/@spip_action_joindre4
 function spip_action_joindre4($path, $mode, $type, $id, $id_document,$hash, $redirect, &$actifs, $iframe_redirect)
 {
 	joindre_deballes($path, $mode, $type, $id, $id_document,$hash, $redirect, $actifs);
 	return spip_action_joindre5($path, $mode, $type, $id, $id_document,$hash, $redirect, $actifs);
 }
 
-// http://doc.spip.org/@spip_action_joindre6
+// http://doc.spip.org/@joindre_deballes
 function joindre_deballes($path, $mode, $type, $id, $id_document,$hash, $redirect, &$actifs)
 {
 	    define('_tmp_dir', creer_repertoire_documents($hash));
diff --git a/ecrire/action/poster_forum_prive.php b/ecrire/action/poster_forum_prive.php
index 1cb173b0a5..616e3d3903 100644
--- a/ecrire/action/poster_forum_prive.php
+++ b/ecrire/action/poster_forum_prive.php
@@ -12,7 +12,7 @@
 
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
-// http://doc.spip.org/@action_editer_mot_dist
+// http://doc.spip.org/@action_poster_forum_prive_dist
 function action_poster_forum_prive_dist() {
 
 	include_spip('inc/actions');
@@ -26,7 +26,7 @@ function action_poster_forum_prive_dist() {
 	else action_poster_forum_prive_post($r);
 }
 
-// http://doc.spip.org/@action_editer_mot_post
+// http://doc.spip.org/@action_poster_forum_prive_post
 function action_poster_forum_prive_post($r)
 {
 	global $redirect, $nom_site, $texte, $titre_message, $url_site,  $modif_forum,  $valider_forum;
diff --git a/ecrire/exec/documents_colonne.php b/ecrire/exec/documents_colonne.php
index 83170223e0..3e213fd2be 100644
--- a/ecrire/exec/documents_colonne.php
+++ b/ecrire/exec/documents_colonne.php
@@ -12,6 +12,7 @@
 
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
+// http://doc.spip.org/@exec_documents_colonne_dist
 function exec_documents_colonne_dist()
 {
 	global $id, $type, $show_docs;
diff --git a/ecrire/exec/export_all.php b/ecrire/exec/export_all.php
index 532d2ab3cf..bb81a6d0cc 100644
--- a/ecrire/exec/export_all.php
+++ b/ecrire/exec/export_all.php
@@ -56,7 +56,7 @@ if (!isset($EXPORT_tables_noexport)){
 }
 $GLOBALS['flag_ob_flush'] = function_exists('ob_flush');
 
-// http://doc.spip.org/@export_nom_fichier_dump
+// http://doc.spip.org/@export_nom_fichier_dump
 function export_nom_fichier_dump($dir,$gz=true){
 	$archive = _SPIP_DUMP;
 	if ($gz) $archive .= '.gz';
@@ -67,7 +67,7 @@ function export_nom_fichier_dump($dir,$gz=true){
 	return $nom;
 }
 
-// http://doc.spip.org/@exec_export_all_dist
+// http://doc.spip.org/@exec_export_all_dist
 function exec_export_all_dist()
 {
   global $archive, $debut_limit, $etape, $gz, $spip_version, $spip_version_affichee, $version_archive, $connect_login, $connect_toutes_rubriques;
@@ -261,7 +261,7 @@ function exec_export_all_dist()
 
 }
 
-// http://doc.spip.org/@ramasse_parties
+// http://doc.spip.org/@ramasse_parties
 function ramasse_parties($archive, $gz, $partfile){
 	// a ameliorer par un preg_file
 	// si le rammassage est interrompu par un timeout, on perd des morceaux
@@ -282,7 +282,7 @@ function ramasse_parties($archive, $gz, $partfile){
 //
 // Exportation generique d'objets (fichier ou retour de fonction)
 //
-// http://doc.spip.org/@export_objets
+// http://doc.spip.org/@export_objets
 function export_objets($table, $primary, $liens, $file = 0, $gz = false, $etape_actuelle="", $nom_etape="",$limit=0) {
 	static $etape_affichee=array();
 	static $table_fields=array();
@@ -355,7 +355,7 @@ function export_objets($table, $primary, $liens, $file = 0, $gz = false, $etape_
 
 // Exporter les champs de la table
 
-// http://doc.spip.org/@build_while
+// http://doc.spip.org/@build_while
 function build_while($file,$gz, $nfields, &$pos_in_table, $result, &$status_dump, $table, $fields) {
 	global $connect_toutes_rubriques ;
 	$string = '';
@@ -385,18 +385,18 @@ function build_while($file,$gz, $nfields, &$pos_in_table, $result, &$status_dump
 	return $string;
 }
 
-// http://doc.spip.org/@build_begin_tag
+// http://doc.spip.org/@build_begin_tag
 function build_begin_tag($tag) {
 	return "<$tag>\n";
 }
 
-// http://doc.spip.org/@build_end_tag
+// http://doc.spip.org/@build_end_tag
 function build_end_tag($tag) {
 	return "</$tag>\n\n";
 }
 
 // Conversion texte -> xml (ajout d'entites)
-// http://doc.spip.org/@text_to_xml
+// http://doc.spip.org/@text_to_xml
 function text_to_xml($string) {
 	return str_replace('<', '&lt;', str_replace('&', '&amp;', $string));
 }
diff --git a/ecrire/exec/forum_envoi.php b/ecrire/exec/forum_envoi.php
index 7ee511bc2f..9c1cb5151d 100644
--- a/ecrire/exec/forum_envoi.php
+++ b/ecrire/exec/forum_envoi.php
@@ -31,6 +31,7 @@ function exec_forum_envoi_dist()
 		    _request('valider_forum'));
 }
 
+// http://doc.spip.org/@forum_envoi
 function forum_envoi(  
 		     $id,
 		     $id_parent,
@@ -165,6 +166,7 @@ function forum_envoi(
 	  . fin_page();
 }
 
+// http://doc.spip.org/@forum_envoi_formulaire
 function forum_envoi_formulaire($id, $objet, $script, $statut, $texte, $titre_page, $nom_site, $url_site)
 {
 	global $options;
@@ -217,6 +219,7 @@ function forum_envoi_formulaire($id, $objet, $script, $statut, $texte, $titre_pa
 		. "\" size='40' />"	      ));
 }
 
+// http://doc.spip.org/@forum_envoi_entete
 function forum_envoi_entete($parent, $titre_parent, $texte, $titre_texte, $nom_site, $url_site)
 {
 	global $spip_lang_rtl;
diff --git a/ecrire/exec/informer_auteur.php b/ecrire/exec/informer_auteur.php
index 6f0f5073c2..c3e009ae79 100644
--- a/ecrire/exec/informer_auteur.php
+++ b/ecrire/exec/informer_auteur.php
@@ -14,6 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 # Les informations d'une rubrique selectionnee dans le mini navigateur
 
+// http://doc.spip.org/@exec_informer_auteur_dist
 function exec_informer_auteur_dist()
 {
 	$id = intval(_request('id'));
diff --git a/ecrire/exec/rechercher.php b/ecrire/exec/rechercher.php
index 5e0a38615a..2886fff9c7 100644
--- a/ecrire/exec/rechercher.php
+++ b/ecrire/exec/rechercher.php
@@ -85,6 +85,7 @@ function exec_rechercher_dist()
 // car cela qui indique qu'un seul resultat a ete trouve.
 // ==> attention a composer le message d'erreur avec au moins 2 balises
 
+// http://doc.spip.org/@proposer_item
 function proposer_item ($ids, $titles, $rac)
 {
 
diff --git a/ecrire/exec/rechercher_auteur.php b/ecrire/exec/rechercher_auteur.php
index 1485429a6f..5965ea1a0e 100644
--- a/ecrire/exec/rechercher_auteur.php
+++ b/ecrire/exec/rechercher_auteur.php
@@ -14,7 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 # gerer un charset minimaliste en convertissant tout en unicode &#xxx;
 
-// http://doc.spip.org/@exec_rechercher_dist
+// http://doc.spip.org/@exec_rechercher_auteur_dist
 function exec_rechercher_auteur_dist()
 {
 	$idom = _request('idom');
diff --git a/ecrire/exec/selectionner_auteur.php b/ecrire/exec/selectionner_auteur.php
index 8258bd8db7..bfe6531a61 100644
--- a/ecrire/exec/selectionner_auteur.php
+++ b/ecrire/exec/selectionner_auteur.php
@@ -14,7 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 # afficher un mini-navigateur de rubriques
 
-// http://doc.spip.org/@exec_selectionner_dist
+// http://doc.spip.org/@exec_selectionner_auteur_dist
 function exec_selectionner_auteur_dist()
 {
   	$id = intval(_request('id_article'));
diff --git a/ecrire/inc/actions.php b/ecrire/inc/actions.php
index 618da3f911..8092cd5420 100644
--- a/ecrire/inc/actions.php
+++ b/ecrire/inc/actions.php
@@ -223,6 +223,7 @@ function ajax_retour($corps)
 	exit;
 }
 
+// http://doc.spip.org/@ajax_debug_retour
 function ajax_debug_retour($c, $corps)
 {
 	$f = charger_fonction('sax', 'inc');
diff --git a/ecrire/inc/chercher_rubrique.php b/ecrire/inc/chercher_rubrique.php
index e14fedd8d8..7ffe713427 100644
--- a/ecrire/inc/chercher_rubrique.php
+++ b/ecrire/inc/chercher_rubrique.php
@@ -218,6 +218,7 @@ function selecteur_rubrique_ajax($id_rubrique, $type, $restreint, $idem=0) {
 // (la fonction JS charger_node ignore l'attribut id qui ne sert en fait pas;
 // getElement en mode Ajax est trop couteux).
 
+// http://doc.spip.org/@construire_selecteur
 function construire_selecteur($url, $js, $idom, $name, $init='', $id=0)
 {
 	$icone = ($idom == 'selection_auteur') ? 'message.gif' : 'loupe.png';
diff --git a/ecrire/inc/drapeau_edition.php b/ecrire/inc/drapeau_edition.php
index 1ca6718401..e0e6a1030c 100644
--- a/ecrire/inc/drapeau_edition.php
+++ b/ecrire/inc/drapeau_edition.php
@@ -90,6 +90,7 @@ function qui_edite ($id, $type='article') {
 	return $edition[$type][$id];
 }
 
+// http://doc.spip.org/@mention_qui_edite
 function mention_qui_edite ($id, $type='article') {
 	$modif = qui_edite($id, $type);
 	unset($modif[$GLOBALS['auteur_session']['id_auteur']]);
diff --git a/ecrire/inc/editer_auteurs.php b/ecrire/inc/editer_auteurs.php
index a095b4e5c9..bfd9156776 100644
--- a/ecrire/inc/editer_auteurs.php
+++ b/ecrire/inc/editer_auteurs.php
@@ -225,6 +225,7 @@ function ajouter_auteurs_articles($id_article, $les_auteurs)
 	return ajax_action_auteur('editer_auteurs', $id_article,'articles', "id_article=$id_article", $sel);
 }
 
+// http://doc.spip.org/@determiner_non_auteurs
 function determiner_non_auteurs($les_auteurs, $order)
 {
 	if (!$les_auteurs)
@@ -275,6 +276,7 @@ function articles_auteur_select($result)
 	return $res;
 }
 
+// http://doc.spip.org/@selecteur_auteur_ajax
 function selecteur_auteur_ajax($id_article, $js, $text)
 {
 	include_spip('inc/chercher_rubrique');
diff --git a/ecrire/inc/extra.php b/ecrire/inc/extra.php
index 4fcc71fe60..fafd2f71d1 100644
--- a/ecrire/inc/extra.php
+++ b/ecrire/inc/extra.php
@@ -373,6 +373,7 @@ function extra_affichage($extra, $type) {
 
 // s'il y a mise a jour des extras, mixer les champs modifies
 // avec les champs existants (car la mise a jour peut etre partielle)
+// http://doc.spip.org/@extra_update
 function extra_update($type, $id, $c = false) {
 	$extra = @unserialize(extra_recup_saisie($type, $c));
 
diff --git a/ecrire/inc/formater_article.php b/ecrire/inc/formater_article.php
index 0fc3861328..5ecb99b4f8 100644
--- a/ecrire/inc/formater_article.php
+++ b/ecrire/inc/formater_article.php
@@ -14,6 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 // Fonction appelee dans une boucle, calculer les invariants au premier appel.
 
+// http://doc.spip.org/@inc_formater_article_dist
 function inc_formater_article_dist($row)
 {
 	global $dir_lang, $options, $spip_lang_right, $spip_display;
diff --git a/ecrire/inc/formater_auteur.php b/ecrire/inc/formater_auteur.php
index 3c8af9efea..2a0967c853 100644
--- a/ecrire/inc/formater_auteur.php
+++ b/ecrire/inc/formater_auteur.php
@@ -23,6 +23,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 // 5. le nombre d'articles publies
 //
 
+// http://doc.spip.org/@inc_formater_auteur_dist
 function inc_formater_auteur_dist($id_auteur) {
 
 	global $connect_id_auteur, $spip_lang_rtl;
@@ -64,6 +65,7 @@ function inc_formater_auteur_dist($id_auteur) {
 	return $vals;
 }
 
+// http://doc.spip.org/@formater_auteur_mail
 function formater_auteur_mail($email)
 {
 	global $spip_lang_rtl;
diff --git a/ecrire/inc/getdocument.php b/ecrire/inc/getdocument.php
index dfb04793f2..a6086324a3 100644
--- a/ecrire/inc/getdocument.php
+++ b/ecrire/inc/getdocument.php
@@ -148,6 +148,7 @@ function check_upload_error($error, $msg='') {
 
 // Erreur appelee depuis public.php (la precedente ne fonctionne plus
 // depuis qu'on est sortis de spip_image.php, apparemment).
+// http://doc.spip.org/@erreur_upload_trop_gros
 function erreur_upload_trop_gros() {
 	include_spip('inc/filtres');
 	
@@ -536,6 +537,7 @@ function examiner_les_fichiers($files, $mode, $type, $id, $id_document, $hash, $
 // Afficher un formulaire de choix: decompacter et/ou garder tel quel.
 // Passer ca en squelette un de ces jours.
 
+// http://doc.spip.org/@liste_archive_jointe
 function liste_archive_jointe($valables, $mode, $type, $id, $id_document, $hash, $redirect, $zip, $iframe_redirect)
 {
 	$arg = (intval($id) .'/' .intval($id_document) . "/$mode/$type");
diff --git a/ecrire/inc/iconifier.php b/ecrire/inc/iconifier.php
index e3a18f83df..0f12b8ddfb 100644
--- a/ecrire/inc/iconifier.php
+++ b/ecrire/inc/iconifier.php
@@ -65,6 +65,7 @@ function inc_iconifier_dist($id_objet, $id,  $script, $iframe_script='') {
   		$js .= <<<EOF
       <script type='text/javascript'>
       $(".form_upload_icon").async_upload(upload_complete);
+// http://doc.spip.org/@upload_complete
       function upload_complete(res) {
         res.find(">div").each(function(){
           var cont = $("#"+this.id);
diff --git a/ecrire/inc/informer_auteur.php b/ecrire/inc/informer_auteur.php
index 28fb913bc0..0cab311b90 100644
--- a/ecrire/inc/informer_auteur.php
+++ b/ecrire/inc/informer_auteur.php
@@ -14,7 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 # Les information d'une rubrique selectionnee dans le mini navigateur
 
-// http://doc.spip.org/@inc_informer_dist
+// http://doc.spip.org/@inc_informer_auteur_dist
 function inc_informer_auteur_dist($id)
 {
 	global $couleur_foncee,$spip_display,$spip_lang_right ;
diff --git a/ecrire/inc/minipres.php b/ecrire/inc/minipres.php
index f1a1d25b05..ae1da13306 100644
--- a/ecrire/inc/minipres.php
+++ b/ecrire/inc/minipres.php
@@ -86,11 +86,13 @@ function install_fin_html() {
 	echo "\n\t</div>\n\t</div>\n</body>\n</html>";
 }
 
+// http://doc.spip.org/@info_etape
 function info_etape($titre, $complement = ''){
 	return "\n<h2>".$titre."</h2>\n" .
 	($complement ? "<p>".$complement."</p>\n":'');
 }
 
+// http://doc.spip.org/@fieldset
 function fieldset($legend, $champs = array()) {
 	$fieldset = "<fieldset>\n" .
 	($legend ? "<legend>".$legend."</legend>\n" : '');
@@ -104,6 +106,7 @@ function fieldset($legend, $champs = array()) {
 	return $fieldset;
 }
 
+// http://doc.spip.org/@bouton_suivant
 function bouton_suivant($code = 'bouton_suivant') {
 	return "\n<span class='suivant'><input type='submit' class='fondl' value=\"" .
 		_T($code) .
diff --git a/ecrire/inc/notifications.php b/ecrire/inc/notifications.php
index 14ff9b270c..4b7ea9c675 100644
--- a/ecrire/inc/notifications.php
+++ b/ecrire/inc/notifications.php
@@ -14,6 +14,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 
 // Fonctione appelee par divers pipelines
+// http://doc.spip.org/@notifications
 function notifications($pipeline, $x) {
 
 	// En cas de changement de statut d'article vers 'publie' ou 'prop',
diff --git a/ecrire/inc/presentation.php b/ecrire/inc/presentation.php
index 2cbfd59a56..3d10bf9ffc 100644
--- a/ecrire/inc/presentation.php
+++ b/ecrire/inc/presentation.php
@@ -380,6 +380,7 @@ function afficher_liste($largeurs, $table, $styles = '') {
 	return $res;
 }
 
+// http://doc.spip.org/@afficher_liste_display_neq4
 function afficher_liste_display_neq4($largeurs, $t, $styles = '') {
 
 	global $spip_lang_left;
@@ -403,6 +404,7 @@ function afficher_liste_display_neq4($largeurs, $t, $styles = '') {
 	return $res;
 }
 
+// http://doc.spip.org/@afficher_liste_display_eq4
 function afficher_liste_display_eq4($largeurs, $t, $styles = '') {
 	global $spip_lang_left;
 
diff --git a/ecrire/inc/selectionner.php b/ecrire/inc/selectionner.php
index 920b616a1a..8d34fe8b55 100644
--- a/ecrire/inc/selectionner.php
+++ b/ecrire/inc/selectionner.php
@@ -57,6 +57,7 @@ function inc_selectionner_dist ($sel, $idom="",$fonction="", $exclus=0, $aff_rac
 	return construire_selectionner_hierarchie($idom, $plonger, $aff_racine, $url, 'id_parent', $url_init);
 }
 
+// http://doc.spip.org/@construire_selectionner_hierarchie
 function construire_selectionner_hierarchie($idom, $liste, $racine, $url, $name, $url_init='')
 {
 	global $couleur_foncee, $spip_lang_right;
diff --git a/ecrire/inc/selectionner_auteur.php b/ecrire/inc/selectionner_auteur.php
index 9bdce9bbeb..32c16ded97 100644
--- a/ecrire/inc/selectionner_auteur.php
+++ b/ecrire/inc/selectionner_auteur.php
@@ -19,6 +19,7 @@ include_spip('inc/selectionner');
 // Affiche un mini-navigateur ajax sur les auteurs
 //
 
+// http://doc.spip.org/@inc_selectionner_auteur_dist
 function inc_selectionner_auteur_dist($id_article)
 {
 	global $spip_lang_right, $couleur_foncee;
@@ -34,6 +35,7 @@ function inc_selectionner_auteur_dist($id_article)
 	return construire_selectionner_hierarchie($idom, $futurs, '', $url, 'nouv_auteur');
 }
 
+// http://doc.spip.org/@selectionner_auteur_boucle
 function selectionner_auteur_boucle($query, $idom)
 {
 	global  $spip_lang_left;
diff --git a/ecrire/inc/signatures.php b/ecrire/inc/signatures.php
index 4ff02fa27c..1c086159ba 100644
--- a/ecrire/inc/signatures.php
+++ b/ecrire/inc/signatures.php
@@ -21,7 +21,7 @@ function message_de_signature($row)
   return propre(echapper_tags($row['message']));
 }
 
-// http://doc.spip.org/@controle_signatures
+// http://doc.spip.org/@inc_signatures_dist
 function inc_signatures_dist($script, $id, $debut, $where, $order, $limit='') {
 
 	# filtre de duree (a remplacer par une vraie pagination)
@@ -65,6 +65,7 @@ function inc_signatures_dist($script, $id, $debut, $where, $order, $limit='') {
 	return $res;
 }
 
+// http://doc.spip.org/@signatures_edit
 function signatures_edit($script, $id, $debut, $row) {
 
 		global $couleur_foncee;
diff --git a/ecrire/inc/traduire.php b/ecrire/inc/traduire.php
index e705086ed4..be4c9d40c4 100644
--- a/ecrire/inc/traduire.php
+++ b/ecrire/inc/traduire.php
@@ -75,7 +75,7 @@ function surcharger_langue($fichier) {
 //
 // Traduire une chaine internationalisee
 //
-// http://doc.spip.org/@traduire_chaine
+// http://doc.spip.org/@inc_traduire_dist
 function inc_traduire_dist($ori, $lang) {
 
 	static $deja_vu = array();
diff --git a/ecrire/inc/utils.php b/ecrire/inc/utils.php
index 83d2ce71c5..0ed8ade3f8 100644
--- a/ecrire/inc/utils.php
+++ b/ecrire/inc/utils.php
@@ -222,6 +222,7 @@ function spip_query($query, $serveur='') {
 }
 
 // a demenager dans base/abstract_sql a terme
+// http://doc.spip.org/@_q
 function _q($arg_sql) {
 	return (is_int($arg_sql)) ? $arg_sql : ("'" . addslashes($arg_sql) . "'");
 }
@@ -1212,6 +1213,7 @@ function lang_dselect ($rien='') {
 
 // pipeline appelant la fonction de notification
 // avant chaque modification du contenu
+// http://doc.spip.org/@notif_pre_enregistre_contenu
 function notif_pre_enregistre_contenu($x) {
 	include_spip('inc/notifications');
 	return notifications('pre_enregistre_contenu', $x);
diff --git a/ecrire/inc/vieilles_defs.php b/ecrire/inc/vieilles_defs.php
index bfcfa5a000..43910acd26 100644
--- a/ecrire/inc/vieilles_defs.php
+++ b/ecrire/inc/vieilles_defs.php
@@ -94,10 +94,12 @@ function affiche_auteur_boucle($row, &$tous_id)
 	return $vals;
 }
 
+// http://doc.spip.org/@spip_abstract_quote
 function spip_abstract_quote($arg_sql) {
 	return _q($arg_sql);
 }
 
+// http://doc.spip.org/@creer_repertoire
 function creer_repertoire($base, $subdir) {
 	return sous_repertoire($base, $subdir, true);
 }
diff --git a/ecrire/inc/xml.php b/ecrire/inc/xml.php
index 43623023e4..5ea8a4ca71 100644
--- a/ecrire/inc/xml.php
+++ b/ecrire/inc/xml.php
@@ -12,6 +12,7 @@
 
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
+// http://doc.spip.org/@spip_xml_load
 function spip_xml_load($fichier, $clean=true){
 	$contenu = "";
 	if (preg_match(",^(http|ftp)://,",$fichier)){
@@ -26,6 +27,7 @@ function spip_xml_load($fichier, $clean=true){
 	return count($arbre)?$arbre:false;
 }
 
+// http://doc.spip.org/@spip_xml_parse
 function spip_xml_parse($texte, $clean=true){
 	$out = array();
   // enlever les commentaires
@@ -78,6 +80,7 @@ function spip_xml_parse($texte, $clean=true){
 		return $texte;
 }
 
+// http://doc.spip.org/@spip_xml_aplatit
 function spip_xml_aplatit($arbre,$separateur = " "){
 	$s = "";
 	if (is_array($arbre))
diff --git a/ecrire/public/balises.php b/ecrire/public/balises.php
index 8ee90dd29f..da85894b45 100644
--- a/ecrire/public/balises.php
+++ b/ecrire/public/balises.php
@@ -972,7 +972,7 @@ function balise_URL_ECRIRE_dist($p) {
 //
 // #URL_ACTION_AUTEUR{naviguer} -> ecrire/?exec=naviguer
 //
-// http://doc.spip.org/@balise_URL_ECRIRE_dist
+// http://doc.spip.org/@balise_URL_ACTION_AUTEUR_dist
 function balise_URL_ACTION_AUTEUR_dist($p) {
 
 	$p->code = interprete_argument_balise(1,$p);
-- 
GitLab