spip / SPIP

ecrire/inc/acces.php

Doc Comments +2 added lines, -2 removed lines

@@ -261,7 +261,7 @@ 
 /**
  * Initialiser la globale htsalt si cela n'a pas déjà été fait.
  *
- * @return void|bool
+ * @return string
  */
 function initialiser_sel() {
 	if (!isset($GLOBALS['htsalt'])) {
@@ -317,7 +317,7 @@ 
 
 /**
  * Generer le fichier de htpasswd contenant les htpass
- * @param $htpasswd
+ * @param string $htpasswd
  * @param $htpasswd_admin
  */
 function generer_htpasswd_files($htpasswd, $htpasswd_admin) {

ecrire/req/sqlite_fonctions.php

Doc Comments +2 added lines, -2 removed lines

@@ -33,7 +33,7 @@ 
  * @link http://www.sqlite.org/lang_corefunc.html Liste des fonctions natives
  * @link http://sqlite.org/changes.html Liste des évolutions
  * 
- * @param PDO|resource $sqlite Représente la connexion Sqlite
+ * @param PDO $sqlite Représente la connexion Sqlite
  * @return false|void
  */
 function _sqlite_init_functions(&$sqlite) {
@@ -337,7 +337,7 @@ 
  * soit inadapté.
  *
  * @param string $conv
- * @return void
+ * @return string
  */
 function _sqlite_func_strftime_format_converter(string $conv) : string {
 	// ok : %a %b %d %e %H %I %l %j %k %m %p %r %S %T %w %y %Y

ecrire/inc/rubriques.php

Doc Comments +2 added lines, -2 removed lines

@@ -50,7 +50,7 @@ 
  *     Infos sur l'objet modifié : statut_ancien, objet, id_objet…
  * @param bool $postdate
  *     true pour recalculer aussi la date du prochain article post-daté
- * @return bool
+ * @return boolean|null
  *     true si le statut change effectivement
  **/
 function calculer_rubriques_if($id_rubrique, $modifs, $infos = array(), $postdate = false) {
@@ -453,7 +453,7 @@ 
  * de la rubrique parente lorsque langue_choisie est différent de oui,
  * et les corrige.
  *
- * @return bool
+ * @return boolean|string
  *     true si un changement a eu lieu
  **/
 function calculer_langues_rubriques_etape() {

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) {