spip / SPIP

ecrire/base/abstract_sql.php

Doc Comments +20 added lines, -20 removed lines

@@ -286,19 +286,19 @@ 
  * @api
  * @uses sql_select()
  *
- * @param array|string $select
+ * @param string $select
  *    Liste des champs a recuperer (Select)
- * @param array|string $from
+ * @param string $from
  *    Tables a consulter (From)
- * @param array|string $where
+ * @param string $where
  *    Conditions a remplir (Where)
- * @param array|string $groupby
+ * @param string $groupby
  *    Critere de regroupement (Group by)
- * @param array|string $orderby
+ * @param string $orderby
  *    Tableau de classement (Order By)
  * @param string $limit
  *    Critere de limite (Limit)
- * @param array $having
+ * @param string $having
  *    Tableau des des post-conditions a remplir (Having)
  * @param string $serveur
  *    Le serveur sollicite (pour retrouver la connexion)
@@ -343,9 +343,9 @@ 
  *    Tables a consulter (From)
  * @param array|string $where
  *    Conditions a remplir (Where)
- * @param array|string $groupby
+ * @param string $groupby
  *    Critere de regroupement (Group by)
- * @param array $having
+ * @param string $having
  *    Tableau des des post-conditions a remplir (Having)
  * @param string $serveur
  *    Le serveur sollicite (pour retrouver la connexion)
@@ -818,7 +818,7 @@ 
  *     Couples (colonne => valeur)
  * @param string|array $where
  *     Conditions a remplir (Where)
- * @param array $desc
+ * @param string $desc
  *     Tableau de description des colonnes de la table SQL utilisée
  *     (il sera calculé si nécessaire s'il n'est pas transmis).
  * @param string $serveur
@@ -1636,13 +1636,13 @@ 
  *    Tables a consulter (From)
  * @param array|string $where
  *    Conditions a remplir (Where)
- * @param array|string $groupby
+ * @param string $groupby
  *    Critere de regroupement (Group by)
- * @param array|string $orderby
+ * @param string $orderby
  *    Tableau de classement (Order By)
  * @param string $limit
  *    Critere de limite (Limit)
- * @param array $having
+ * @param string $having
  *    Tableau des des post-conditions a remplir (Having)
  * @param string $serveur
  *    Le serveur sollicite (pour retrouver la connexion)
@@ -1700,7 +1700,7 @@ 
  * @api
  * @uses sql_fetsel()
  *
- * @param array|string $select
+ * @param string $select
  *     Liste des champs à récupérer (Select)
  * @param array|string $from
  *     Tables à consulter (From)
@@ -2057,16 +2057,16 @@ 
  * @api
  * @param string $in
  *     Colonne SQL sur laquelle appliquer le test
- * @param array|string $select
+ * @param string $select
  *     Liste des champs à récupérer (Select).
  *     La donnée extraite est le premier élément de la sélection.
- * @param array|string $from
+ * @param string $from
  *     Tables a consulter (From)
- * @param array|string $where
+ * @param string $where
  *     Conditions a remplir (Where)
- * @param array|string $groupby
+ * @param string $groupby
  *     Critere de regroupement (Group by)
- * @param array|string $orderby
+ * @param string $orderby
  *     Tableau de classement (Order By)
  * @param string $limit
  *     Critere de limite (Limit)
@@ -2165,7 +2165,7 @@ 
  *    Nom du connecteur
  * @param bool $option
  *     Inutilisé
- * @return bool
+ * @return integer
  *     True si le champ est de type entier
  */
 function sql_test_int($type, $serveur = '', $option = true) {
@@ -2184,7 +2184,7 @@ 
  *    Nom du connecteur
  * @param bool $option
  *     Inutilisé
- * @return bool
+ * @return integer
  *     True si le champ est de type entier
  */
 function sql_test_date($type, $serveur = '', $option = true) {

ecrire/base/objets.php

Doc Comments +1 added lines, -1 removed lines

@@ -1578,7 +1578,7 @@
 /**
  * Donne les informations de parenté directe d'un type d'objet si on en trouve
  * 
- * @param $objet
+ * @param string $objet
  *     Type de l'objet dont on cherche les informations de parent
  * @return array|false
  *     Retourne un tableau de tableau contenant les informations de type et de champ pour trouver le parent ou false sinon

prive/themes/spip/vars.css_fonctions.php

Doc Comments +1 added lines, -1 removed lines

@@ -27,7 +27,7 @@
 /**
  * Génère les variables CSS relatif à la typo et langue pour l'espace privé
  *
- * @param Pile $pile Pile
+ * @param Pile $Pile Pile
  */
 function spip_generer_variables_css_typo(array $Pile) : \Spip_Css_Vars_Collection {
 	$vars = new \Spip_Css_Vars_Collection();

ecrire/inc/presentation.php

Doc Comments +7 added lines

@@ -31,6 +31,9 @@ 
 include_spip('inc/filtres_alertes');
 
 // https://code.spip.net/@debut_cadre
+/**
+ * @param string $style
+ */
 function debut_cadre($style, $icone = "", $fonction = "", $titre = "", $id = "", $class = "", $padding = true) {
 	$style_mapping = array(
 		'r' => 'simple',
@@ -184,6 +187,10 @@ 
 function fin_onglet() { return "</ul></div>\n"; }
 
 // https://code.spip.net/@onglet
+/**
+ * @param string $texte
+ * @param string $onglet
+ */
 function onglet($texte, $lien, $onglet_ref, $onglet, $icone = "") {
 	return "<li>"
 	. ($icone ? http_img_pack($icone, '', " class='cadre-icone'") : '')

ecrire/inc/filtres.php

Doc Comments +22 added lines, -10 removed lines

@@ -69,7 +69,7 @@ 
  *
  * @param string $fonc
  *     Nom du filtre
- * @param null $default
+ * @param string $default
  *     Nom du filtre appliqué par défaut si celui demandé n'est pas trouvé
  * @return string
  *     Fonction PHP correspondante du filtre demandé
@@ -141,7 +141,7 @@ 
  * @see appliquer_si_filtre() Proche : retourne le texte d'origine si le filtre est absent
  * @uses appliquer_filtre_sinon()
  *
- * @param mixed $arg
+ * @param string $arg
  *     Texte (le plus souvent) sur lequel appliquer le filtre
  * @param string $filtre
  *     Nom du filtre à appliquer
@@ -797,7 +797,7 @@ 
  *   corriger toutes les `&xx;` en `&xx;`
  * @param bool $quote
  *   Échapper aussi les simples quotes en `'`
- * @return mixed|string
+ * @return string
  */
 function entites_html($texte, $tout = false, $quote = true) {
 	if (!is_string($texte) or !$texte
@@ -1432,7 +1432,7 @@ 
  *
  * @param mixed $texte
  *     Contenu de reference a tester
- * @param mixed $sinon
+ * @param string|null $sinon
  *     Contenu a retourner si le contenu de reference est vide
  * @return mixed
  *     Retourne $texte, sinon $sinon.
@@ -1614,7 +1614,7 @@ 
  * @param string $letexte
  * @param string $lang
  *     Langue à retrouver (si vide, utilise la langue en cours).
- * @param array $options Options {
+ * @param boolean $options Options {
  * @type bool $echappe_span
  *         True pour échapper les balises span (false par défaut)
  * @type string $lang_defaut
@@ -1704,7 +1704,7 @@ 
  * @param string $letexte
  * @param string $lang
  *     Langue à retrouver (si vide, utilise la langue en cours).
- * @param array $options Options {
+ * @param boolean $options Options {
  * @type bool $echappe_span
  *         True pour échapper les balises span (false par défaut)
  * @type string $lang_defaut
@@ -1913,7 +1913,7 @@ 
  *
  * @param int $i
  *     Le compteur
- * @param array $args
+ * @param string $args
  *     Liste des éléments à alterner
  * @return mixed
  *     Une des valeurs en fonction du compteur.
@@ -2178,6 +2178,9 @@ 
 // Quelques fonctions de calcul arithmetique
 //
 function floatstr($a) { return str_replace(',','.',(string)floatval($a)); }
+/**
+ * @param string $f
+ */
 function strize($f, $a, $b) { return floatstr($f(floatstr($a),floatstr($b))); }
 
 /**
@@ -2321,7 +2324,7 @@ 
  * @param string|array $adresses
  *      Adresse ou liste d'adresse
  *      si on fournit un tableau, il est filtre et la fonction renvoie avec uniquement les adresses email valides (donc possiblement vide)
- * @return bool|string|array
+ * @return string|null
  *      - false si une des adresses n'est pas conforme,
  *      - la normalisation de la dernière adresse donnée sinon
  *      - renvoie un tableau si l'entree est un tableau
@@ -2645,7 +2648,7 @@ 
  * @param int $a
  * @param int $b
  * @param int $c
- * @return int
+ * @return double
  *      Retourne `$a*$b/$c`
  **/
 function regledetrois($a, $b, $c) {
@@ -3466,6 +3469,10 @@ 
 }
 
 
+/**
+ * @param string $alt_or_size
+ * @param string|null $class_or_size
+ */
 function helper_filtre_balise_img_svg_arguments($alt_or_size, $class_or_size, $size) {
 	$args = [$alt_or_size, $class_or_size, $size];
 	while (is_null(end($args)) and count($args)) {
@@ -3494,6 +3501,10 @@ 
 	return $args;
 }
 
+/**
+ * @param string $img
+ * @param string $size
+ */
 function helper_filtre_balise_img_svg_size($img, $size) {
 	// si size est de la forme '@2x' c'est un coeff multiplicateur sur la densite
 	if (strpos($size, '@') === 0 and substr($size,-1) === 'x') {
@@ -4811,7 +4822,7 @@ 
  *     Nombre d'éléments
  * @param string $objet
  *     Objet
- * @return mixed|string
+ * @return string
  *     Texte traduit du comptage, tel que '3 articles'
  */
 function objet_afficher_nb($nb, $objet) {
@@ -5291,6 +5302,7 @@ 
  *
  * @param string $objet
  * @param int|string $id_objet
+ * @param string $fonction
  * @return array
  */
 function helper_filtre_objet_lister_enfants_ou_parents($objet, $id_objet, $fonction) {

ecrire/action/editer_article.php

Doc Comments +1 added lines, -1 removed lines

@@ -160,7 +160,7 @@
  * @param int $id_rubrique
  *     Identifiant de la rubrique parente
  * @param array|null $set
- * @return int
+ * @return boolean|string
  *     Identifiant du nouvel article
  *
  */

ecrire/action/editer_auteur.php

Doc Comments +3 added lines, -3 removed lines

@@ -85,7 +85,7 @@ 
  * @param string|null $source
  *     D'où provient l'auteur créé ? par défaut 'spip', mais peut être 'ldap' ou autre.
  * @param array|null $set
- * @return int
+ * @return boolean|string
  *     Identifiant de l'auteur créé
  */
 function auteur_inserer($source = null, $set = null) {
@@ -143,7 +143,7 @@ 
  * @param bool $force_update
  *   Permet de forcer la maj en base des champs fournis, sans passer par instancier.
  *   Utilise par auth/spip
- * @return string|null
+ * @return string|false
  *
  *     - Chaîne vide si aucune erreur,
  *     - Chaîne contenant un texte d'erreur sinon.
@@ -307,7 +307,7 @@ 
  *     Couples (colonne => valeur) des données à instituer
  * @param bool $force_webmestre
  *     Autoriser un auteur à passer webmestre (force l'autorisation)
- * @return bool|string
+ * @return false|string
  */
 function auteur_instituer($id_auteur, $c, $force_webmestre = false) {
 	if (!$id_auteur = intval($id_auteur)) {

ecrire/action/editer_rubrique.php

Doc Comments +2 added lines, -2 removed lines

@@ -73,7 +73,7 @@ 
  *     Identifiant de la rubrique parente.
  *     0 pour la racine.
  * @param array|null $set
- * @return int
+ * @return boolean|string
  *     Identifiant de la rubrique crée
  */
 function rubrique_inserer($id_parent, $set = null) {
@@ -120,7 +120,7 @@ 
  *     Identifiant de la rubrique modifiée
  * @param array|null $set
  *     Tableau qu'on peut proposer en lieu et place de _request()
- * @return bool|string
+ * @return string|false
  *     - false  : Aucune modification, aucun champ n'est à modifier
  *     - chaîne vide : Vide si tout s'est bien passé
  *     - chaîne : Texte d'un message d'erreur