From 7b66a3bf331b76089c348cb7a249af710084c856 Mon Sep 17 00:00:00 2001
From: Christian Lefebvre <christian_lefebvre@laposte.net>
Date: Sat, 4 Nov 2006 00:36:47 +0000
Subject: [PATCH] autodoc pas auto

---
 ecrire/action/legender_auteur.php          |  2 +-
 ecrire/balise/formulaire_admin.php         |  3 +++
 ecrire/balise/formulaire_ecrire_auteur.php |  3 +++
 ecrire/balise/formulaire_forum.php         |  6 ++++++
 ecrire/balise/formulaire_inscription.php   | 10 ++++++++++
 ecrire/balise/formulaire_recherche.php     |  3 +++
 ecrire/balise/formulaire_signature.php     |  6 ++++++
 ecrire/balise/formulaire_site.php          |  3 +++
 ecrire/balise/login_prive.php              |  3 +++
 ecrire/balise/login_public.php             |  6 ++++++
 ecrire/balise/menu_lang.php                |  3 +++
 ecrire/balise/menu_lang_ecrire.php         |  4 ++++
 ecrire/balise/url_logout.php               |  3 +++
 ecrire/inc/aider.php                       |  1 +
 ecrire/inc/autoriser.php                   | 11 +++++++++++
 ecrire/inc/commencer_page.php              |  2 +-
 ecrire/inc/filtres.php                     |  2 ++
 ecrire/inc/texte.php                       |  2 +-
 ecrire/inc/vieilles_defs.php               |  1 +
 19 files changed, 71 insertions(+), 3 deletions(-)

diff --git a/ecrire/action/legender_auteur.php b/ecrire/action/legender_auteur.php
index 11e5ee8c50..1d2b9ffb35 100644
--- a/ecrire/action/legender_auteur.php
+++ b/ecrire/action/legender_auteur.php
@@ -17,7 +17,7 @@ include_spip('inc/actions');
 include_spip('inc/acces');
 include_spip('base/abstract_sql');
 
-// http://doc.spip.org/@action_legender_auteur
+// http://doc.spip.org/@action_legender_auteur_dist
 function action_legender_auteur_dist()
 {
         $var_f = charger_fonction('controler_action_auteur', 'inc');
diff --git a/ecrire/balise/formulaire_admin.php b/ecrire/balise/formulaire_admin.php
index 1803546ab5..f994aa99ba 100644
--- a/ecrire/balise/formulaire_admin.php
+++ b/ecrire/balise/formulaire_admin.php
@@ -13,12 +13,14 @@
 if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 
 
+// http://doc.spip.org/@balise_FORMULAIRE_ADMIN
 function balise_FORMULAIRE_ADMIN ($p) {
 	return calculer_balise_dynamique($p,'FORMULAIRE_ADMIN', array());
 }
 
 # on ne peut rien dire au moment de l'execution du squelette
 
+// http://doc.spip.org/@balise_FORMULAIRE_ADMIN_stat
 function balise_FORMULAIRE_ADMIN_stat($args, $filtres) {
 	return $args;
 }
@@ -30,6 +32,7 @@ function balise_FORMULAIRE_ADMIN_stat($args, $filtres) {
 # Pas question de recompiler: ca fait boucler !
 # Le debuger transmet donc ses donnees, et cette balise y retrouve son petit.
 
+// http://doc.spip.org/@balise_FORMULAIRE_ADMIN_dyn
 function balise_FORMULAIRE_ADMIN_dyn($float='', $debug='') {
 
 	global $var_preview, $use_cache, $forcer_debug, $xhtml;
diff --git a/ecrire/balise/formulaire_ecrire_auteur.php b/ecrire/balise/formulaire_ecrire_auteur.php
index 410b238297..303710367d 100644
--- a/ecrire/balise/formulaire_ecrire_auteur.php
+++ b/ecrire/balise/formulaire_ecrire_auteur.php
@@ -18,10 +18,12 @@ include_spip('base/abstract_sql');
 // verifier dans la base ni a le devoiler au visiteur
 
 
+// http://doc.spip.org/@balise_FORMULAIRE_ECRIRE_AUTEUR
 function balise_FORMULAIRE_ECRIRE_AUTEUR ($p) {
 	return calculer_balise_dynamique($p,'FORMULAIRE_ECRIRE_AUTEUR', array('id_auteur', 'id_article', 'email'));
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_ECRIRE_AUTEUR_stat
 function balise_FORMULAIRE_ECRIRE_AUTEUR_stat($args, $filtres) {
 	include_spip('inc/filtres');
 
@@ -56,6 +58,7 @@ function balise_FORMULAIRE_ECRIRE_AUTEUR_stat($args, $filtres) {
 	return $args;
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_ECRIRE_AUTEUR_dyn
 function balise_FORMULAIRE_ECRIRE_AUTEUR_dyn($id_auteur, $id_article, $mail) {
 	include_spip('inc/texte');
 	$puce = definir_puce();
diff --git a/ecrire/balise/formulaire_forum.php b/ecrire/balise/formulaire_forum.php
index 886a97f7c9..63c340eb40 100644
--- a/ecrire/balise/formulaire_forum.php
+++ b/ecrire/balise/formulaire_forum.php
@@ -33,6 +33,7 @@ charger_generer_url();
 // dans le fichier d'appel, et si la table de reference est OK, proposer
 // la liste des mots-cles
 
+// http://doc.spip.org/@balise_FORMULAIRE_FORUM
 function balise_FORMULAIRE_FORUM ($p) {
 
 	$p = calculer_balise_dynamique($p,'FORMULAIRE_FORUM', array('id_rubrique', 'id_forum', 'id_article', 'id_breve', 'id_syndic', 'ajouter_mot', 'ajouter_groupe', 'afficher_texte'));
@@ -46,6 +47,7 @@ function balise_FORMULAIRE_FORUM ($p) {
 }
 
 // verification des droits a faire du forum
+// http://doc.spip.org/@balise_FORMULAIRE_FORUM_stat
 function balise_FORMULAIRE_FORUM_stat($args, $filtres) {
 
 	// Note : ceci n'est pas documente !!
@@ -83,6 +85,7 @@ function balise_FORMULAIRE_FORUM_stat($args, $filtres) {
 		$idr, $idf, $ida, $idb, $ids, $am, $ag, $af, $url);
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_FORUM_dyn
 function balise_FORMULAIRE_FORUM_dyn(
 $titre, $table, $type, $script,
 $id_rubrique, $id_forum, $id_article, $id_breve, $id_syndic,
@@ -200,6 +203,7 @@ $ajouter_mot, $ajouter_groupe, $afficher_texte, $url_param_retour)
 		));
 }
 
+// http://doc.spip.org/@inclure_previsu
 function inclure_previsu($texte,$titre, $email_auteur, $auteur, $url_site, $nom_site_forum, $ajouter_mot)
 {
 	$erreur = $bouton = '';
@@ -248,6 +252,7 @@ function inclure_previsu($texte,$titre, $email_auteur, $auteur, $url_site, $nom_
 // Ce systeme n'est pas fonctionnel pour les forums sans previsu (notamment
 // si $afficher_texte = 'non')
 
+// http://doc.spip.org/@forum_fichier_tmp
 function forum_fichier_tmp()
 {
 # astuce : mt_rand pour autoriser les hits simultanes
@@ -275,6 +280,7 @@ function forum_fichier_tmp()
 // Chercher le titre et la configuration du forum de l'element auquel on repond
 //
 
+// http://doc.spip.org/@sql_recherche_donnees_forum
 function sql_recherche_donnees_forum ($idr, $idf, $ida, $idb, $ids) {
 
 	// changer la table de reference s'il y a lieu (pour afficher_groupes[] !!)
diff --git a/ecrire/balise/formulaire_inscription.php b/ecrire/balise/formulaire_inscription.php
index 5320b87f1f..c73e51a105 100644
--- a/ecrire/balise/formulaire_inscription.php
+++ b/ecrire/balise/formulaire_inscription.php
@@ -16,6 +16,7 @@ include_spip('base/abstract_sql');
 
 // Balise independante du contexte
 
+// http://doc.spip.org/@balise_FORMULAIRE_INSCRIPTION
 function balise_FORMULAIRE_INSCRIPTION ($p) {
 
 	return calculer_balise_dynamique($p, 'FORMULAIRE_INSCRIPTION', array());
@@ -26,6 +27,7 @@ function balise_FORMULAIRE_INSCRIPTION ($p) {
 // args[2] indique le focus eventuel
 // [(#FORMULAIRE_INSCRIPTION{nom_inscription, #ID_RUBRIQUE})]
 
+// http://doc.spip.org/@balise_FORMULAIRE_INSCRIPTION_stat
 function balise_FORMULAIRE_INSCRIPTION_stat($args, $filtres) {
 	list($mode, $id, $focus) = $args;
 	//initialiser_mode_inscription
@@ -41,6 +43,7 @@ function balise_FORMULAIRE_INSCRIPTION_stat($args, $filtres) {
 // Autrement 2e appel, envoyer un mail et le squelette ne produira pas de
 // formulaire.
 
+// http://doc.spip.org/@balise_FORMULAIRE_INSCRIPTION_dyn
 function balise_FORMULAIRE_INSCRIPTION_dyn($mode, $focus, $id=0) {
 
 	if (!test_mode_inscription($mode)) return _T('pass_rien_a_faire_ici');
@@ -78,6 +81,7 @@ function balise_FORMULAIRE_INSCRIPTION_dyn($mode, $focus, $id=0) {
 				'self' => str_replace('&amp;','&',(self()))));
 }
 
+// http://doc.spip.org/@test_mode_inscription
 function test_mode_inscription($mode) {
 
 	return (($mode == 'redac' AND $GLOBALS['meta']['accepter_inscriptions'] == 'oui')
@@ -93,6 +97,7 @@ function test_mode_inscription($mode) {
 // Retour: une chaine message d'erreur 
 // ou un tableau avec au minimum email, nom, mode (redac / forum)
 
+// http://doc.spip.org/@test_inscription_dist
 function test_inscription_dist($mode, $mail, $nom, $id=0) {
 
 	include_spip('inc/filtres');
@@ -106,6 +111,7 @@ function test_inscription_dist($mode, $mail, $nom, $id=0) {
 // cree un nouvel utilisateur et renvoie un message d'impossibilite 
 // ou le tableau representant la ligne SQL le decrivant.
 
+// http://doc.spip.org/@message_inscription
 function message_inscription($mail, $nom, $mode, $id=0) {
 
 	if (function_exists('test_inscription'))
@@ -140,6 +146,7 @@ function message_inscription($mail, $nom, $mode, $id=0) {
 // provisoirement dans le champ Bio, afin de ne pas visualiser les inactifs
 // A sa premiere connexion il obtiendra son statut final (auth->activer())
 
+// http://doc.spip.org/@inscription_nouveau
 function inscription_nouveau($declaration)
 {
 	if (!isset($declaration['login']))
@@ -159,6 +166,7 @@ function inscription_nouveau($declaration)
 // fonction redefinissable qui doit retourner false si tout est ok
 // ou une chaine non vide expliquant pourquoi le mail n'a pas ete envoye
 
+// http://doc.spip.org/@envoyer_inscription_dist
 function envoyer_inscription_dist($ids, $nom, $mode, $id) {
 	include_spip('inc/mail');
 	$nom_site_spip = nettoyer_titre_email($GLOBALS['meta']["nom_site"]);
@@ -183,6 +191,7 @@ function envoyer_inscription_dist($ids, $nom, $mode, $id) {
 		return _T('form_forum_probleme_mail');
 }
 
+// http://doc.spip.org/@test_login
 function test_login($nom, $mail) {
 	include_spip('inc/charsets');
 	$nom = strtolower(translitteration($nom));
@@ -212,6 +221,7 @@ function test_login($nom, $mail) {
 	}
 }
 
+// http://doc.spip.org/@creer_pass_pour_auteur
 function creer_pass_pour_auteur($id_auteur) {
 	include_spip('inc/acces');
 	$pass = creer_pass_aleatoire(8, $id_auteur);
diff --git a/ecrire/balise/formulaire_recherche.php b/ecrire/balise/formulaire_recherche.php
index 15abf6922c..ebeefa70d8 100644
--- a/ecrire/balise/formulaire_recherche.php
+++ b/ecrire/balise/formulaire_recherche.php
@@ -15,11 +15,13 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 // Pas besoin de contexte de compilation
 
 
+// http://doc.spip.org/@balise_FORMULAIRE_RECHERCHE
 function balise_FORMULAIRE_RECHERCHE ($p) 
 {
 	return calculer_balise_dynamique($p, 'FORMULAIRE_RECHERCHE', array());
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_RECHERCHE_stat
 function balise_FORMULAIRE_RECHERCHE_stat($args, $filtres) {
 	// Si le moteur n'est pas active, pas de balise
 	if ($GLOBALS['meta']["activer_moteur"] != "oui")
@@ -30,6 +32,7 @@ function balise_FORMULAIRE_RECHERCHE_stat($args, $filtres) {
 	  return array($filtres[0], $args[0]);
 }
  
+// http://doc.spip.org/@balise_FORMULAIRE_RECHERCHE_dyn
 function balise_FORMULAIRE_RECHERCHE_dyn($lien, $rech) {
 
 	if ($GLOBALS['spip_lang'] != $GLOBALS['meta']['langue_site'])
diff --git a/ecrire/balise/formulaire_signature.php b/ecrire/balise/formulaire_signature.php
index a84efa2555..e0e44c6595 100644
--- a/ecrire/balise/formulaire_signature.php
+++ b/ecrire/balise/formulaire_signature.php
@@ -25,11 +25,13 @@ spip_connect();
 // car on doit obtenir la jointure avec sql_petitions pour verifier si
 // une petition est attachee a l'article
 
+// http://doc.spip.org/@balise_FORMULAIRE_SIGNATURE
 function balise_FORMULAIRE_SIGNATURE ($p) {
 	return calculer_balise_dynamique($p,'FORMULAIRE_SIGNATURE', array('id_article', 'petition'));
 }
 
 // Verification des arguments (contexte + filtres)
+// http://doc.spip.org/@balise_FORMULAIRE_SIGNATURE_stat
 function balise_FORMULAIRE_SIGNATURE_stat($args, $filtres) {
 
 	// pas d'id_article => erreur de squelette
@@ -57,6 +59,7 @@ function balise_FORMULAIRE_SIGNATURE_stat($args, $filtres) {
 }
 
 // Executer la balise
+// http://doc.spip.org/@balise_FORMULAIRE_SIGNATURE_dyn
 function balise_FORMULAIRE_SIGNATURE_dyn($id_article, $petition, $texte, $site_obli, $message) {
 
 	if (_request('var_confirm')) # _GET
@@ -88,6 +91,7 @@ function balise_FORMULAIRE_SIGNATURE_dyn($id_article, $petition, $texte, $site_o
 // Sinon, c'est l'execution du formulaire et on retourne le message 
 // de confirmation ou d'erreur construit lors de l'appel par assembler.php
 
+// http://doc.spip.org/@reponse_confirmation
 function reponse_confirmation($var_confirm = '') {
 
 	static $confirm = '';
@@ -174,6 +178,7 @@ function reponse_confirmation($var_confirm = '') {
 // Retour a l'ecran de la signature d'une petition
 //
 
+// http://doc.spip.org/@reponse_signature
 function reponse_signature($id_article, $nom_email, $adresse_email, $message, $nom_site, $url_site, $url_page) {
 
 	if (!spip_connect()) return _T('form_pet_probleme_technique');
@@ -246,6 +251,7 @@ function reponse_signature($id_article, $nom_email, $adresse_email, $message, $n
 }
 
 
+// http://doc.spip.org/@test_pass
 function test_pass() {
 	include_spip('inc/acces');
 	for (;;) {
diff --git a/ecrire/balise/formulaire_site.php b/ecrire/balise/formulaire_site.php
index 2808aa784a..b4ebf1d16c 100644
--- a/ecrire/balise/formulaire_site.php
+++ b/ecrire/balise/formulaire_site.php
@@ -15,10 +15,12 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 // Le contexte indique dans quelle rubrique le visiteur peut proposer le site
 
 
+// http://doc.spip.org/@balise_FORMULAIRE_SITE
 function balise_FORMULAIRE_SITE ($p) {
   return calculer_balise_dynamique($p,'FORMULAIRE_SITE', array('id_rubrique'));
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_SITE_stat
 function balise_FORMULAIRE_SITE_stat($args, $filtres) {
 
 	// Pas d'id_rubrique ? Erreur de squelette
@@ -33,6 +35,7 @@ function balise_FORMULAIRE_SITE_stat($args, $filtres) {
 	return (($GLOBALS['meta']["proposer_sites"] != 2) ? '' : $args);
 }
 
+// http://doc.spip.org/@balise_FORMULAIRE_SITE_dyn
 function balise_FORMULAIRE_SITE_dyn($id_rubrique) {
 
 	if ($nom = _request('nom_site')) {
diff --git a/ecrire/balise/login_prive.php b/ecrire/balise/login_prive.php
index cc2c36dee2..f2d9ff0fca 100644
--- a/ecrire/balise/login_prive.php
+++ b/ecrire/balise/login_prive.php
@@ -15,6 +15,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 include_spip('balise/login_public'); 
 
 
+// http://doc.spip.org/@balise_LOGIN_PRIVE
 function balise_LOGIN_PRIVE ($p) {
 
 	return balise_login_public($p,'LOGIN_PRIVE');
@@ -26,11 +27,13 @@ function balise_LOGIN_PRIVE ($p) {
 #    calculer_balise_dynamique, en l'occurrence le #LOGIN courant si l'on
 #    programme une <boucle(AUTEURS)>[(#LOGIN_PRIVE{#LOGIN})]
 
+// http://doc.spip.org/@balise_LOGIN_PRIVE_stat
 function balise_LOGIN_PRIVE_stat ($args, $filtres) {
 	 return array(isset($args[1]) ? $args[1] : '',
 		      ($filtres[0] ? $filtres[0] : $args[0]));
 }
 
+// http://doc.spip.org/@balise_LOGIN_PRIVE_dyn
 function balise_LOGIN_PRIVE_dyn($login, $cible) {
 	return login_explicite($login, $cible);
 }
diff --git a/ecrire/balise/login_public.php b/ecrire/balise/login_public.php
index 78d426888c..4746d2e7ce 100644
--- a/ecrire/balise/login_public.php
+++ b/ecrire/balise/login_public.php
@@ -15,6 +15,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 include_spip('base/abstract_sql');
 spip_connect();
 
+// http://doc.spip.org/@balise_LOGIN_PUBLIC
 function balise_LOGIN_PUBLIC ($p, $nom='LOGIN_PUBLIC') {
 	return calculer_balise_dynamique($p, $nom, array('url'));
 }
@@ -25,10 +26,12 @@ function balise_LOGIN_PUBLIC ($p, $nom='LOGIN_PUBLIC') {
 #    calculer_balise_dynamique, en l'occurence le #LOGIN courant si l'on
 #    programme une <boucle(AUTEURS)>[(#LOGIN_PUBLIC{#LOGIN})]
 
+// http://doc.spip.org/@balise_LOGIN_PUBLIC_stat
 function balise_LOGIN_PUBLIC_stat ($args, $filtres) {
 	return array($filtres[0] ? $filtres[0] : $args[0], $args[1], $args[2]);
 }
 
+// http://doc.spip.org/@balise_LOGIN_PUBLIC_dyn
 function balise_LOGIN_PUBLIC_dyn($url, $login) {
 
 	if (!$url 		# pas d'url passee en filtre ou dans le contexte
@@ -38,6 +41,7 @@ function balise_LOGIN_PUBLIC_dyn($url, $login) {
 	return login_explicite($login, $url);
 }
 
+// http://doc.spip.org/@login_explicite
 function login_explicite($login, $cible) {
 	global $auteur_session;
 
@@ -72,6 +76,7 @@ function login_explicite($login, $cible) {
 	return login_pour_tous($login ? $login : _request('var_login'), $cible, $action);
 }
 
+// http://doc.spip.org/@login_pour_tous
 function login_pour_tous($login, $cible, $action) {
 	global $ignore_auth_http, $_SERVER, $_COOKIE;
 
@@ -158,6 +163,7 @@ function login_pour_tous($login, $cible, $action) {
 
 // Bouton duree de connexion
 
+// http://doc.spip.org/@filtre_rester_connecte
 function filtre_rester_connecte($prefs) {
 	$prefs = unserialize(stripslashes($prefs));
 	return $prefs['cnx'] == 'perma' ? ' ' : '';
diff --git a/ecrire/balise/menu_lang.php b/ecrire/balise/menu_lang.php
index 8de91a0f45..fb84955906 100644
--- a/ecrire/balise/menu_lang.php
+++ b/ecrire/balise/menu_lang.php
@@ -17,17 +17,20 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 // ou de l'argument fourni: #MENU_LANG{#ENV{malangue}} 
 
 
+// http://doc.spip.org/@balise_MENU_LANG
 function balise_MENU_LANG ($p) {
 	return calculer_balise_dynamique($p,'MENU_LANG', array('lang'));
 }
 
 // s'il n'y a qu'une langue eviter definitivement la balise ?php 
+// http://doc.spip.org/@balise_MENU_LANG_stat
 function balise_MENU_LANG_stat ($args, $filtres) {
 	if (strpos($GLOBALS['meta']['langues_multilingue'],',') === false) return '';
 	return $filtres ? $filtres : $args;
 }
 
 // normalement $opt sera toujours non vide suite au test ci-dessus
+// http://doc.spip.org/@balise_MENU_LANG_dyn
 function balise_MENU_LANG_dyn($opt) {
 	include_spip('balise/menu_lang_ecrire');
 	return menu_lang_pour_tous('var_lang', $opt);
diff --git a/ecrire/balise/menu_lang_ecrire.php b/ecrire/balise/menu_lang_ecrire.php
index 38e73a5a79..50d3d3adfa 100644
--- a/ecrire/balise/menu_lang_ecrire.php
+++ b/ecrire/balise/menu_lang_ecrire.php
@@ -16,12 +16,14 @@ if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 // et preselectionne celle la globale $lang
 // ou de l'arguemnt fourni: #MENU_LANG_ECRIRE{#ENV{malangue}} 
 
+// http://doc.spip.org/@balise_MENU_LANG_ECRIRE
 function balise_MENU_LANG_ECRIRE ($p) {
 
 	return calculer_balise_dynamique($p,'MENU_LANG_ECRIRE', array('lang'));
 }
 
 // s'il n'y a qu'une langue proposee eviter definitivement la balise ?php 
+// http://doc.spip.org/@balise_MENU_LANG_ECRIRE_stat
 function balise_MENU_LANG_ECRIRE_stat ($args, $filtres) {
 	global $all_langs;
 	include_spip('inc/lang');
@@ -30,10 +32,12 @@ function balise_MENU_LANG_ECRIRE_stat ($args, $filtres) {
 }
 
 // normalement $opt sera toujours non vide suite au test ci-dessus
+// http://doc.spip.org/@balise_MENU_LANG_ECRIRE_dyn
 function balise_MENU_LANG_ECRIRE_dyn($opt) {
 	return menu_lang_pour_tous('var_lang_ecrire', $opt);
 }
 
+// http://doc.spip.org/@menu_lang_pour_tous
 function menu_lang_pour_tous($nom, $default) {
 	include_spip('inc/lang');
 
diff --git a/ecrire/balise/url_logout.php b/ecrire/balise/url_logout.php
index 39d2163d12..772f2f391f 100644
--- a/ecrire/balise/url_logout.php
+++ b/ecrire/balise/url_logout.php
@@ -12,14 +12,17 @@
 
 if (!defined("_ECRIRE_INC_VERSION")) return;	#securite
 
+// http://doc.spip.org/@balise_URL_LOGOUT
 function balise_URL_LOGOUT ($p) {return calculer_balise_dynamique($p,'URL_LOGOUT', array());
 }
 
 // $args[0] = url destination apres logout [(#URL_LOGOUT{url})]
+// http://doc.spip.org/@balise_URL_LOGOUT_stat
 function balise_URL_LOGOUT_stat ($args, $filtres) {
 	return array($args[0]);
 }
 
+// http://doc.spip.org/@balise_URL_LOGOUT_dyn
 function balise_URL_LOGOUT_dyn($cible) {
 
 	if (!$GLOBALS['auteur_session']['login']) return '';
diff --git a/ecrire/inc/aider.php b/ecrire/inc/aider.php
index 6ca4aa3684..c752f12277 100644
--- a/ecrire/inc/aider.php
+++ b/ecrire/inc/aider.php
@@ -12,6 +12,7 @@
 
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
+// http://doc.spip.org/@inc_aider_dist
 function inc_aider_dist($aide='') {
 	global $spip_lang, $spip_lang_rtl, $spip_display;
 
diff --git a/ecrire/inc/autoriser.php b/ecrire/inc/autoriser.php
index c157bff13b..9ccee86648 100644
--- a/ecrire/inc/autoriser.php
+++ b/ecrire/inc/autoriser.php
@@ -25,6 +25,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 //
 // Seul le premier argument est obligatoire
 define ('_DEBUG_AUTORISER', false);
+// http://doc.spip.org/@autoriser
 function autoriser($faire, $type='', $id=0, $qui = NULL, $opt = NULL) {
 	static $restreint = array();
 
@@ -78,6 +79,7 @@ function autoriser($faire, $type='', $id=0, $qui = NULL, $opt = NULL) {
 }
 
 // Autorisation par defaut : les admins complets OK, les autres non
+// http://doc.spip.org/@autoriser_defaut_dist
 function autoriser_defaut_dist($faire, $type, $id, $qui, $opt) {
 	return
 		$qui['statut'] == '0minirezo'
@@ -85,6 +87,7 @@ function autoriser_defaut_dist($faire, $type, $id, $qui, $opt) {
 }
 
 // Autoriser a publier dans la rubrique $id
+// http://doc.spip.org/@autoriser_rubrique_publier_dans_dist
 function autoriser_rubrique_publier_dans_dist($faire, $type, $id, $qui, $opt) {
 	return
 		($qui['statut'] == '0minirezo')
@@ -96,6 +99,7 @@ function autoriser_rubrique_publier_dans_dist($faire, $type, $id, $qui, $opt) {
 
 // Autoriser a modifier la rubrique $id
 // = publier_dans rubrique $id
+// http://doc.spip.org/@autoriser_rubrique_modifier_dist
 function autoriser_rubrique_modifier_dist($faire, $type, $id, $qui, $opt) {
 	return
 		autoriser('publier_dans', 'rubrique', $id, $qui, $opt);
@@ -104,6 +108,7 @@ function autoriser_rubrique_modifier_dist($faire, $type, $id, $qui, $opt) {
 // Autoriser a modifier la breve $id
 // = admins & redac si la breve n'est pas publiee
 // = admins de rubrique parente si publiee
+// http://doc.spip.org/@autoriser_breve_modifier_dist
 function autoriser_breve_modifier_dist($faire, $type, $id, $qui, $opt) {
 	$s = spip_query(
 	"SELECT id_rubrique,statut FROM spip_breves WHERE id_breve="._q($id));
@@ -117,6 +122,7 @@ function autoriser_breve_modifier_dist($faire, $type, $id, $qui, $opt) {
 // Autoriser a modifier l'article $id
 // = publier_dans rubrique parente
 // = ou statut 'prop,prepa' et $qui est auteur
+// http://doc.spip.org/@autoriser_article_modifier_dist
 function autoriser_article_modifier_dist($faire, $type, $id, $qui, $opt) {
 	$s = spip_query(
 	"SELECT id_rubrique,statut FROM spip_articles WHERE id_article="._q($id));
@@ -132,6 +138,7 @@ function autoriser_article_modifier_dist($faire, $type, $id, $qui, $opt) {
 
 // Lire les stats ?
 // = tous les admins
+// http://doc.spip.org/@autoriser_stats_voir_dist
 function autoriser_stats_voir_dist($faire, $type, $id, $qui, $opt) {
 	return
 		$qui['statut'] == '0minirezo';
@@ -139,6 +146,7 @@ function autoriser_stats_voir_dist($faire, $type, $id, $qui, $opt) {
 
 
 // Voir un objet
+// http://doc.spip.org/@autoriser_voir_dist
 function autoriser_voir_dist($faire, $type, $id, $qui, $opt) {
 	if (
 		($qui['statut'] == '0minirezo')
@@ -157,6 +165,7 @@ function autoriser_voir_dist($faire, $type, $id, $qui, $opt) {
 
 // Voir les revisions ?
 // = voir l'objet
+// http://doc.spip.org/@autoriser_revisions_voir_dist
 function autoriser_revisions_voir_dist($faire, $type, $id, $qui, $opt) {
 	return
 		autoriser('voir', $type, $id, $qui, $opt);
@@ -165,6 +174,7 @@ function autoriser_revisions_voir_dist($faire, $type, $id, $qui, $opt) {
 // Moderer le forum ?
 // = modifier l'objet correspondant (si forum attache a un objet)
 // = droits par defaut sinon (admin complet pour moderation complete)
+// http://doc.spip.org/@autoriser_forum_moderer_dist
 function autoriser_forum_moderer_dist($faire, $type, $id, $qui, $opt) {
 	return
 		autoriser('modifier', $type, $id, $qui, $opt);
@@ -173,6 +183,7 @@ function autoriser_forum_moderer_dist($faire, $type, $id, $qui, $opt) {
 // Moderer la petition ?
 // = modifier l'article correspondant
 // = droits par defaut sinon (admin complet pour moderation de tout)
+// http://doc.spip.org/@autoriser_petition_moderer_dist
 function autoriser_petition_moderer_dist($faire, $type, $id, $qui, $opt) {
 	return
 		autoriser('modifier', $type, $id, $qui, $opt);
diff --git a/ecrire/inc/commencer_page.php b/ecrire/inc/commencer_page.php
index 400b09a8fd..95e9dedcbe 100644
--- a/ecrire/inc/commencer_page.php
+++ b/ecrire/inc/commencer_page.php
@@ -16,7 +16,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 // Presentation de l'interface privee, debut du HTML
 //
 
-// http://doc.spip.org/@debut_page
+// http://doc.spip.org/@inc_commencer_page_dist
 function inc_commencer_page_dist($titre = "", $rubrique = "accueil", $sous_rubrique = "accueil", $onLoad = "", $id_rubrique = "") {
 
 	include_spip('inc/headers');
diff --git a/ecrire/inc/filtres.php b/ecrire/inc/filtres.php
index aee9dbfffb..7348989fa4 100644
--- a/ecrire/inc/filtres.php
+++ b/ecrire/inc/filtres.php
@@ -1613,6 +1613,7 @@ function direction_css ($css, $voulue='') {
 
 // recuperere le chemin d'une css existante et :
 // cree (ou recree) dans _DIR_VAR/cache_css/ une css dont les url relatives sont passees en url absolues
+// http://doc.spip.org/@url_absolue_css
 function url_absolue_css ($css) {
 	if (!preg_match(',\.css$,i', $css, $r)) return $css;
 
@@ -1641,6 +1642,7 @@ function url_absolue_css ($css) {
 
 // recuperere le chemin d'une css existante et :
 // cree (ou recree) dans _DIR_VAR/cache_css/ une css compactee en nettoyant tout ce qui n'est pas significatif
+// http://doc.spip.org/@compacte_css
 function compacte_css ($css) {
 	if (!preg_match(',\.css$,i', $css, $r)) return $css;
 	
diff --git a/ecrire/inc/texte.php b/ecrire/inc/texte.php
index f12fa068a9..fd9e6fba8e 100644
--- a/ecrire/inc/texte.php
+++ b/ecrire/inc/texte.php
@@ -810,7 +810,7 @@ function calculer_url_site($id, $texte='')
 	return array($lien, 'spip_out', $texte, $row['lang']);
 }
 
-// http://doc.spip.org/@calculer_url_site
+// http://doc.spip.org/@calculer_url_forum
 function calculer_url_forum($id, $texte='')
 {
 	$lien = generer_url_forum($id);
diff --git a/ecrire/inc/vieilles_defs.php b/ecrire/inc/vieilles_defs.php
index 9a5ee70766..2b55b3dd45 100644
--- a/ecrire/inc/vieilles_defs.php
+++ b/ecrire/inc/vieilles_defs.php
@@ -144,6 +144,7 @@ function bandeau_titre_boite($titre, $afficher_auteurs, $boite_importante = true
 	echo "</tr>";
 }
 
+// http://doc.spip.org/@debut_page
 function debut_page($titre = "", $rubrique = "accueil", $sous_rubrique = "accueil", $onLoad = "", $id_rubrique = "") {
 	$commencer_page = charger_fonction('commencer_page', 'inc');
 	echo $commencer_page($titre, $rubrique, $sous_rubrique, $onLoad, $id_rubrique);
-- 
GitLab