diff --git a/ecrire/balise/logo_.php b/ecrire/balise/logo_.php index 87b68848e3c03dfcf12a1912416daa054a930888..0bbcb7751ea2de0800ed2fadc1b9e8722a6cb749 100644 --- a/ecrire/balise/logo_.php +++ b/ecrire/balise/logo_.php @@ -39,7 +39,7 @@ if (!defined('_ECRIRE_INC_VERSION')) return; * - `LOGO_ARTICLE{200, 0}`. Redimensionnement indiqué * * @balise LOGO_ - * @use logo_survol() + * @uses logo_survol() * @example * ``` * #LOGO_ARTICLE diff --git a/ecrire/balise/menu_lang.php b/ecrire/balise/menu_lang.php index 2cd91743f23ce0bdc7f6ade36b262c9551a60a99..854b094a6bff36cc73cc7c0e241c1d6e898770dd 100644 --- a/ecrire/balise/menu_lang.php +++ b/ecrire/balise/menu_lang.php @@ -60,7 +60,7 @@ function balise_MENU_LANG_stat ($args, $context_compil) { /** * Exécution de la balise dynamique `#MENU_LANG` * - * @use menu_lang_pour_tous() + * @uses menu_lang_pour_tous() * @note * Normalement `$opt` sera toujours non vide suite au test ci-dessus * diff --git a/ecrire/balise/menu_lang_ecrire.php b/ecrire/balise/menu_lang_ecrire.php index 5a271e1bba54e549cb8f8bba38b0b1578978101c..ff40b89e3fae7cfb4d837ec6d1f68b1dffc932ca 100644 --- a/ecrire/balise/menu_lang_ecrire.php +++ b/ecrire/balise/menu_lang_ecrire.php @@ -61,7 +61,7 @@ function balise_MENU_LANG_ECRIRE_stat ($args, $context_compil) { /** * Exécution de la balise dynamique `#MENU_LANG_ECRIRE` * - * @use menu_lang_pour_tous() + * @uses menu_lang_pour_tous() * @note * Normalement `$opt` sera toujours non vide suite au test ci-dessus * @@ -80,7 +80,7 @@ function balise_MENU_LANG_ECRIRE_dyn($opt) { * * Le changement de langue se fait par l'appel à l'action `converser` * - * @use lang_select() + * @uses lang_select() * @see action_converser_dist() * * @param string $nom diff --git a/ecrire/balise/url_.php b/ecrire/balise/url_.php index 29efa5bb7e57213bd78c66c407477f421013bbb6..b9218e32161a4ecaf61caa5ea5b9464e6358d8f1 100644 --- a/ecrire/balise/url_.php +++ b/ecrire/balise/url_.php @@ -26,7 +26,7 @@ if (!defined('_ECRIRE_INC_VERSION')) return; * Utilise le premier paramètre de la balise d'URL comme identifiant d'objet * s'il est donné, sinon le prendra dans un champ d'une boucle englobante. * - * @use generer_generer_url_arg() + * @uses generer_generer_url_arg() * @param string $type * Type d'objet * @param Champ $p diff --git a/ecrire/base/abstract_sql.php b/ecrire/base/abstract_sql.php index 52710123fb9fa7131a809a2b621aa0bf96179543..0e55d064e368fdf84a886e7ec152ccff4719ffd6 100644 --- a/ecrire/base/abstract_sql.php +++ b/ecrire/base/abstract_sql.php @@ -877,7 +877,7 @@ function sql_replace_multi($table, $tab_couples, $desc=array(), $serveur='', $op * Supprime une table SQL (structure et données) * * @api - * @see sql_create_table() + * @see sql_create() * @see sql_drop_view() * * @param string $table @@ -1124,7 +1124,7 @@ function sql_create_base($nom, $serveur='', $option=true) * * @api * @see sql_drop_view() - * @see sql_create_table() + * @see sql_create() * @see sql_get_select() Pour obtenir le texte de la requête SELECT pour créer la vue. * * @param string $nom diff --git a/ecrire/base/repair.php b/ecrire/base/repair.php index 59d871fa77bfab4a3120a1588ac15df6a7ccb06b..c34285f8a06fbea3ecac1a28911db465a2cbd6cd 100644 --- a/ecrire/base/repair.php +++ b/ecrire/base/repair.php @@ -25,9 +25,9 @@ if (!defined('_ECRIRE_INC_VERSION')) return; * de rubriques. Affiche les erreurs s'il y en a eu. * * @pipeline_appel base_admin_repair - * @use admin_repair_tables() - * @use calculer_rubriques() - * @use propager_les_secteurs() + * @uses admin_repair_tables() + * @uses calculer_rubriques() + * @uses propager_les_secteurs() * * @param string $titre Inutilisé * @param string $reprise Inutilisé diff --git a/ecrire/base/upgrade.php b/ecrire/base/upgrade.php index a674113fe49d41e2c7649e0001c3941bff999e96..a9d19af3e2df63ba8d1c0fa039a021786ea8704c 100644 --- a/ecrire/base/upgrade.php +++ b/ecrire/base/upgrade.php @@ -29,9 +29,9 @@ if (!defined('_ECRIRE_INC_VERSION')) return; * et fournir le tableau `$maj` à la fonction `maj_plugin`. * La reprise sur timeout se fait alors par la page admin_plugin et jamais par ici. * - * @use creer_base() - * @use maj_base() - * @use auth_synchroniser_distant() + * @uses creer_base() + * @uses maj_base() + * @uses auth_synchroniser_distant() * * @param string $titre * @param string $reprise Inutilisé @@ -82,8 +82,8 @@ function base_upgrade_dist($titre='', $reprise='') * * Les fonctions de mises à jour se trouvent dans `ecrire/maj/` * - * @use upgrade_test() - * @use maj_while() + * @uses upgrade_test() + * @uses maj_while() * * @param int $version_cible * @param string $redirect @@ -156,7 +156,7 @@ function maj_base($version_cible = 0, $redirect = '') { * On lui fournit un tableau de fonctions élementaires * dont l'indice est la version. * - * @use maj_while() + * @uses maj_while() * * @param string $nom_meta_base_version * Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP @@ -238,7 +238,7 @@ function maj_plugin($nom_meta_base_version, $version_cible, $maj, $table_meta='m * si pas de redirect fourni, on redirige vers `exec=upgrade` pour finir * ce qui doit être une mise à jour SPIP * - * @use redirige_formulaire() + * @uses redirige_formulaire() * * @param string $meta * @param string $table @@ -318,9 +318,9 @@ define('_UPGRADE_TIME_OUT', 20); * spécifiques sont relancées jusqu'à ce qu'elles finissent. * Elles doivent donc s'assurer de progresser à chaque reprise. * - * @use maj_debut_page() - * @use serie_alter() - * @use relance_maj() + * @uses maj_debut_page() + * @uses serie_alter() + * @uses relance_maj() * * @param string $installee * @param string $cible @@ -389,7 +389,7 @@ function maj_while($installee, $cible, $maj, $meta='', $table='meta', $redirect= * * Alter crée une copie temporaire d'une table, c'est lourd. * - * @use relance_maj() + * @uses relance_maj() * * @param string $serie * numero de version upgrade @@ -460,7 +460,7 @@ function serie_alter($serie, $q = array(), $meta='', $table='meta', $redirect='' * $GLOBALS['maj'][1953] = array(array('upgrade_types_documents')); * * ``` - * @use creer_base_types_doc() + * @uses creer_base_types_doc() * **/ function upgrade_types_documents() { diff --git a/ecrire/exec/admin_plugin.php b/ecrire/exec/admin_plugin.php index 48feaf387ce426847c59f2b279dbf3662a05d1e5..1d96e2d486747ad7f2ea5e030221795c829115e1 100644 --- a/ecrire/exec/admin_plugin.php +++ b/ecrire/exec/admin_plugin.php @@ -29,7 +29,7 @@ include_spip('inc/securiser_action'); * * Relance la page si des plugins ont été modifiés, sinon affiche la liste. * - * @use actualise_plugins_actifs() + * @uses actualise_plugins_actifs() * @param string $retour Inutilisé */ function exec_admin_plugin_dist($retour='') { @@ -58,10 +58,10 @@ include_spip('inc/securiser_action'); * * Affiche la liste des plugins demandés et les erreurs éventuelles. * - * @use plugin_donne_erreurs() - * @use liste_chemin_plugin() - * @use plugin_installes_meta() - * @use affiche_les_plugins_verrouilles() + * @uses plugin_donne_erreurs() + * @uses liste_chemin_plugin() + * @uses plugin_installes_meta() + * @uses affiche_les_plugins_verrouilles() * * @pipeline_appel affiche_gauche * @pipeline_appel affiche_droit @@ -222,7 +222,7 @@ function admin_plug_args($quoi, $erreur, $format) /** * Crée le code HTML de la liste des plugins verrouillés * - * @use liste_plugin_files() + * @uses liste_plugin_files() * * @param array $actifs * Liste des plugins actifs @@ -251,7 +251,7 @@ function affiche_les_plugins_verrouilles($actifs) /** * Crée le code HTML de la liste des librairies présentes * - * @use liste_librairies() + * @uses liste_librairies() * * @return string Code HTML */ diff --git a/ecrire/exec/puce_statut.php b/ecrire/exec/puce_statut.php index e8885fcba1df4b5922e508e1327e3f84f77b469b..e536e32414f7faf5ab4627544038e44112a49584 100644 --- a/ecrire/exec/puce_statut.php +++ b/ecrire/exec/puce_statut.php @@ -26,7 +26,7 @@ include_spip('inc/presentation'); * Récupère l'identifiant id et le type d'objet dans les données postées * et appelle la fonction de traitement de cet exec. * - * @see exec_puce_statut_formulaires_args() + * @uses exec_puce_statut_args() * @return string Code HTML **/ function exec_puce_statut_dist() diff --git a/ecrire/inc/filtres.php b/ecrire/inc/filtres.php index 61198de5d8303cd96fd2bd41e95c81112b455dbf..9da76a79d329b29a5aa298cf573d33dca2f1995a 100644 --- a/ecrire/inc/filtres.php +++ b/ecrire/inc/filtres.php @@ -489,11 +489,11 @@ function proteger_amp($texte){ * @filtre entites_html * @link http://www.spip.net/4280 * - * @use echappe_html() - * @use echappe_retour() - * @use proteger_amp() - * @use corriger_toutes_html() - * @use corriger_toutes_entites_html() + * @uses echappe_html() + * @uses echappe_retour() + * @uses proteger_amp() + * @uses corriger_toutes_html() + * @uses corriger_toutes_entites_html() * * @param string $texte * chaine a echapper @@ -614,7 +614,7 @@ function texte_backend($texte) { * * Comme texte_backend(), mais avec addslashes final pour squelettes avec PHP (rss) * - * @uses texte_backend + * @uses texte_backend() * @filtre texte_backendq * * @param string $texte @@ -837,14 +837,13 @@ function PtoBR($texte){ * Ne devrait plus être utilisé et fait directement en CSS par un style * `word-wrap:break-word;` * - * @see http://www.alsacreations.com/tuto/lire/1038-gerer-debordement-contenu-css.html - * * @note * Pour assurer la compatibilité du filtre, on encapsule le contenu par * un `div` ou `span` portant ce style CSS inline. * * @filtre lignes_longues * @link http://www.spip.net/4298 + * @link http://www.alsacreations.com/tuto/lire/1038-gerer-debordement-contenu-css.html * @deprecated Utiliser le style CSS `word-wrap:break-word;` * * @param string $texte Texte @@ -947,7 +946,7 @@ function attribut_html($texte,$textebrut = true) { * - Vide les URL vides comme `http://` ou `mailto:` (sans rien d'autre) * - échappe les entités et gère les `&` * - * @use entites_html() + * @uses entites_html() * * @param string $url * URL à vérifier et échapper @@ -3505,7 +3504,7 @@ function prepare_icone_base($type, $lien, $texte, $fond, $fonction="", $class="" /** * Crée un lien ayant une icone * - * @use prepare_icone_base() + * @uses prepare_icone_base() * * @param string $texte * Texte du lien diff --git a/ecrire/inc/flock.php b/ecrire/inc/flock.php index 3a7bc45137982739045a85e614956e66946f7111..c429a29537716dea1114e0e2bd176d270d4d787c 100644 --- a/ecrire/inc/flock.php +++ b/ecrire/inc/flock.php @@ -45,7 +45,7 @@ $GLOBALS['liste_verrous'] = array(); * * @link http://php.net/manual/fr/function.flock.php pour le type de verrou. * @see _SPIP_LOCK_MODE - * @see spip_fopen_unlock() + * @see spip_fclose_unlock() * @uses spip_nfslock() si _SPIP_LOCK_MODE = 2. * * @param string $fichier diff --git a/ecrire/inc/headers.php b/ecrire/inc/headers.php index df73032cea07c45b36544b861c08cf888c7d6bdd..662b04183cf3e7a94cc0ea270ee477ca4be23132 100644 --- a/ecrire/inc/headers.php +++ b/ecrire/inc/headers.php @@ -148,7 +148,7 @@ function redirige_formulaire($url, $equiv = '', $format='message') { * * @param string $script * Nom de la page privée (exec) - * @param string args + * @param string $args * Arguments à transmettre. Exemple `etape=1&autre=oui` * @param string $equiv * @return void @@ -162,7 +162,7 @@ function redirige_url_ecrire($script='', $args='', $equiv='') { * * Ainsi `http_status(301)` enverra le message `301 Moved Permanently`. * - * @uses header() de PHP + * @link http://php.net/manual/fr/function.header.php Fonction header() de PHP utilisée ici * * @param int $status * Code d'erreur diff --git a/ecrire/inc/modifier.php b/ecrire/inc/modifier.php index 5f607fd41c890372c46163a1025c16cdb87ab6be..9da97da661e6715795896c5ecb3bc513a89ec856 100644 --- a/ecrire/inc/modifier.php +++ b/ecrire/inc/modifier.php @@ -298,7 +298,7 @@ function modifier_contenu($type, $id, $options, $c=null, $serveur='') { * * @deprecated * Utiliser objet_modifier(); - * @see objet_modifier(); + * @uses objet_modifier() * * @param string $objet * Nom de l'objet diff --git a/ecrire/inc/utils.php b/ecrire/inc/utils.php index 88f515ceb5522388cc93d28ae0663c45e48f77be..ae20a2955881d8ee9b675a62bd961f198cf50ee8 100644 --- a/ecrire/inc/utils.php +++ b/ecrire/inc/utils.php @@ -145,6 +145,8 @@ function require_spip($f) { } /** + * Exécute une fonction (appellée par un pipeline) avec la donnée transmise. + * * Un pipeline est lie a une action et une valeur * chaque element du pipeline est autorise a modifier la valeur * le pipeline execute les elements disponibles pour cette action, @@ -157,12 +159,12 @@ function require_spip($f) { * * on passe $val par reference pour limiter les allocations memoire * - * @param string $fond - * Nom de la fonction appelée par le pipeline + * @param string $fonc + * Nom de la fonction appelée par le pipeline * @param string|array $val - * Les paramètres du pipeline, son environnement + * Les paramètres du pipeline, son environnement * @return string|array $val - * Les paramètres du pipeline modifiés + * Les paramètres du pipeline modifiés **/ function minipipe($fonc,&$val){ // fonction diff --git a/ecrire/iterateur/data.php b/ecrire/iterateur/data.php index a4a2895389de4ece52418f38f2da8b3469a651df..5a8faa4f0721e65df8218cdb5a5308ee253bbb0f 100644 --- a/ecrire/iterateur/data.php +++ b/ecrire/iterateur/data.php @@ -340,7 +340,7 @@ class IterateurDATA implements Iterator { * * Critère `{liste X1, X2, X3}` * - * @see critere_liste_dist() + * @see critere_DATA_liste_dist() * **/ protected function select_liste() { diff --git a/ecrire/maj/svn10000.php b/ecrire/maj/svn10000.php index e11a2117ed0962fe4d21cf1dfda7c8f1c16c8d8a..c3aa5dd786986842433a1cce75b728a81fe8593f 100644 --- a/ecrire/maj/svn10000.php +++ b/ecrire/maj/svn10000.php @@ -51,7 +51,7 @@ $GLOBALS['maj'][11268] = array(array('maj_11268')); /** * Mise à jour 11276 : réparer les éventuelles tables spip_documents * en se fondant sur l'extension de la colonne fichier - * @use maj_1_938() + * @uses maj_1_938() **/ function maj_11276 () { include_spip('maj/v019'); @@ -303,8 +303,8 @@ $GLOBALS['maj'][16428] = array( * * Supprime la table au vieux format une fois les données transférées. * - * @use creer_ou_upgrader_table() - * @use maj_liens_insertq_multi_check() + * @uses creer_ou_upgrader_table() + * @uses maj_liens_insertq_multi_check() * * @param string $pivot * Nom de la table pivot, tel que `auteur` @@ -458,7 +458,7 @@ $GLOBALS['maj'][18955] = array( /** * Mise à jour pour recalculer les secteurs des rubriques - * @use propager_les_secteurs() + * @uses propager_les_secteurs() **/ function maj_propager_les_secteurs(){ include_spip('inc/rubriques'); @@ -469,8 +469,8 @@ function maj_propager_les_secteurs(){ * Mise à jour des bdd SQLite pour réparer les collation des champs texte * pour les passer en NOCASE * - * @use base_lister_toutes_tables() - * @use _sqlite_remplacements_definitions_table() + * @uses base_lister_toutes_tables() + * @uses _sqlite_remplacements_definitions_table() **/ function maj_collation_sqlite(){ diff --git a/ecrire/public/composer.php b/ecrire/public/composer.php index a4c9a00f3199a1b05eb485a6039c738243cbfa45..cb9d38e7375cfea12ae86fa866c2f7efee12c31d 100644 --- a/ecrire/public/composer.php +++ b/ecrire/public/composer.php @@ -596,11 +596,10 @@ function remplace_sous_requete($w,$sousrequete){ /** * Sépare les conditions de boucles simples de celles possédant des sous-requêtes. * - * @param array + * @param array $where * Description d'une condition WHERE de boucle * @return array * Liste de 2 tableaux : - * * - Conditions simples (ne possédant pas de sous requêtes) * - Conditions avec des sous requêtes **/ diff --git a/ecrire/req/mysql.php b/ecrire/req/mysql.php index f6296c5ad65d4cc236ad1cbd014334c648216ccc..d6603e12742affa9a114602f0650549024949503 100644 --- a/ecrire/req/mysql.php +++ b/ecrire/req/mysql.php @@ -1451,7 +1451,7 @@ function spip_get_lock($nom, $timeout = 0) { * Relâcher un verrou SQL local * * @deprecated Pas d'équivalence actuellement en dehors de MySQL - * @see spip_get_lock + * @see spip_get_lock() * * @param string $nom * Inutilisé. Le nom est calculé en fonction de la connexion principale diff --git a/prive/formulaires/login.php b/prive/formulaires/login.php index 11f5408f4092210d97fd78ab217860f23b963b40..c6bf024a311d02a3ff8271021c2681cd4b7ad249 100644 --- a/prive/formulaires/login.php +++ b/prive/formulaires/login.php @@ -40,9 +40,9 @@ function is_url_prive($cible){ * * Si on est déjà connecté, on redirige directement sur l'URL cible ! * - * @use auth_informer_login() - * @use is_url_prive() - * @use login_auth_http() + * @uses auth_informer_login() + * @uses is_url_prive() + * @uses login_auth_http() * * @param string $cible * URL de destination après identification. @@ -50,7 +50,7 @@ function is_url_prive($cible){ * après connexion sur le squelette public de l'auteur qui se connecte. * @param string $login * Login de la personne à identifier (si connu) - * @param null|bool + * @param null|bool $prive * Identifier pour l'espace privé (true), public (false) * ou automatiquement (null) en fonction de la destination de l'URL cible. * @return array @@ -164,9 +164,9 @@ function login_auth_http() * * Connecte la personne si l'identification réussie. * - * @use auth_identifier_login() - * @use auth_loger() - * @use login_autoriser() + * @uses auth_identifier_login() + * @uses auth_loger() + * @uses login_autoriser() * * @param string $cible * URL de destination après identification. @@ -174,7 +174,7 @@ function login_auth_http() * après connexion sur le squelette public de l'auteur qui se connecte. * @param string $login * Login de la personne à identifier (si connu) - * @param null|bool + * @param null|bool $prive * Identifier pour l'espace privé (true), public (false) * ou automatiquement (null) en fonction de la destination de l'URL cible. * @return array @@ -261,7 +261,7 @@ function login_autoriser() * après connexion sur le squelette public de l'auteur qui se connecte. * @param string $login * Login de la personne à identifier (si connu) - * @param null|bool + * @param null|bool $prive * Identifier pour l'espace privé (true), public (false) * ou automatiquement (null) en fonction de la destination de l'URL cible. * @return array