spip / SPIP

ecrire/public/compiler.php

Doc Comments +14 added lines, -1 removed lines

@@ -59,6 +59,10 @@ 
 
 
 // http://code.spip.net/@argumenter_inclure
+/**
+ * @param boolean $rejet_filtres
+ * @param string $id_boucle
+ */
 function argumenter_inclure(
 	$params,
 	$rejet_filtres,
@@ -747,7 +751,7 @@ 
  *    Nom de la commande
  * @param string $val
  *    Code PHP décrivant la valeur à affecter
- * @return array
+ * @return string[]
  *
  *    - index 0 : Code pour une affectation statique. Si non rempli, la propriété devra
  *                être ré-affectée à chaque appel de la boucle.
@@ -855,6 +859,9 @@ 
 }
 
 // http://code.spip.net/@calculer_order
+/**
+ * @param Boucle $boucle
+ */
 function calculer_order(&$boucle) {
 	if (!$order = $boucle->order
 		and !$order = $boucle->default_order
@@ -924,6 +931,9 @@ 
 define('_REGEXP_CONCAT_NON_VIDE', "/^(.*)[.]\s*'[^']+'\s*$/");
 
 // http://code.spip.net/@compile_cas
+/**
+ * @param string $id_boucle
+ */
 function compile_cas($tableau, $descr, &$boucles, $id_boucle) {
 
 	$codes = array();
@@ -1113,6 +1123,9 @@ 
 // de meme si EXP est de la forme (t ? '' : 'C')
 
 // http://code.spip.net/@compile_retour
+/**
+ * @param string $tab
+ */
 function compile_retour($code, $avant, $apres, $altern, $tab, $n) {
 	if ($avant == "''") {
 		$avant = '';

ecrire/public/composer.php

Doc Comments +7 added lines

@@ -133,6 +133,10 @@ 
 	return $nom ? $nom : false;
 }
 
+/**
+ * @param string $squelette
+ * @param string $phpfile
+ */
 function squelette_traduit($squelette, $sourcefile, $phpfile, $boucles) {
 
 	// Le dernier index est '' (fonction principale)
@@ -157,6 +161,9 @@ 
 
 // Le squelette compile est-il trop vieux ?
 // http://code.spip.net/@squelette_obsolete
+/**
+ * @param string $skel
+ */
 function squelette_obsolete($skel, $squelette) {
 	static $date_change = null;
 	// ne verifier la date de mes_fonctions et mes_options qu'une seule fois

ecrire/public/criteres.php

Doc Comments +9 added lines

@@ -661,6 +661,11 @@ 
 }
 
 // http://code.spip.net/@calculer_critere_arg_dynamique
+/**
+ * @param string $idb
+ *
+ * @return string
+ */
 function calculer_critere_arg_dynamique($idb, &$boucles, $crit, $suffix = '') {
 	$boucle = $boucles[$idb];
 	$alt = "('" . $boucle->id_table . '.\' . $x' . $suffix . ')';
@@ -1509,6 +1514,10 @@ 
 }
 
 // http://code.spip.net/@critere_IN_cas
+/**
+ * @param string $idb
+ * @param string $crit2
+ */
 function critere_IN_cas($idb, &$boucles, $crit2, $arg, $op, $val, $col) {
 	static $num = array();
 	$descr = $boucles[$idb]->descr;

ecrire/public/debusquer.php

Doc Comments +7 added lines

@@ -418,6 +418,10 @@ 
 }
 
 // http://code.spip.net/@reference_boucle_debug
+/**
+ * @param string $nom
+ * @param string $self
+ */
 function reference_boucle_debug($n, $nom, $self) {
 	list($skel, $boucle, $ligne) = trouve_boucle_debug($n, $nom);
 
@@ -806,6 +810,9 @@ 
 }
 
 // http://code.spip.net/@debusquer_entete
+/**
+ * @param string $corps
+ */
 function debusquer_entete($titre, $corps) {
 
 	include_spip('balise/formulaire_admin');

ecrire/public/iterateur.php

Doc Comments +4 added lines

@@ -457,6 +457,10 @@
 	 * aller a la position $n en parcourant
 	 * un par un tous les elements
 	 */
+
+	/**
+	 * @param integer $n
+	 */
 	private function seek_loop($n) {
 		if ($this->pos > $n) {
 			$this->rewind();

ecrire/public/jointures.php

Doc Comments +1 added lines, -1 removed lines

@@ -231,7 +231,7 @@
  *
  * @param array $depart
  * @param array $arrivee
- * @param string|array $col
+ * @param string $col
  * @return bool
  */
 function nogroupby_if($depart, $arrivee, $col) {

ecrire/public/normaliser.php

Doc Comments +3 added lines

@@ -75,6 +75,9 @@
 }
 
 
+/**
+ * @param string $nom
+ */
 function phraser_logo_faux_filtres($nom) {
 	switch ($nom) {
 		case 'top':

ecrire/public/parametrer.php

Doc Comments +1 added lines, -1 removed lines

@@ -231,7 +231,7 @@
  *
  * @uses public_tester_redirection_dist()
  * @param string $fond
- * @param array $contexte
+ * @param string $contexte
  * @param string $connect
  * @return array|bool
  */

ecrire/public/references.php

Doc Comments +16 added lines, -2 removed lines

@@ -293,7 +293,7 @@ 
  *           est dans une autre table et construit la jointure dessus
  *         - liste (table, champ, fonction) idem, mais en passant un
  *           nom de fonction qui s'occupera de créer la jointure.
- * @return array
+ * @return string[]
  *     Liste (nom du champ alias, nom du champ). Le nom du champ alias
  *     est une expression pour le SELECT de la boucle du style "mots.titre AS titre_mot"
  **/
@@ -471,7 +471,7 @@ 
  *     Nom de la balise
  * @param Champ $p
  *     AST au niveau de la balise
- * @return string
+ * @return Champ
  *     Code PHP pour d'exécution de la balise et de ses filtres
  **/
 function calculer_balise_DEFAUT_dist($nom, $p) {
@@ -755,6 +755,9 @@ 
 //  - deux etoiles => pas de securite non plus !
 //
 // http://code.spip.net/@applique_filtres
+/**
+ * @param Champ $p
+ */
 function applique_filtres($p) {
 
 	// Traitements standards (cf. supra)
@@ -829,6 +832,9 @@ 
 
 // Filtres et,ou,oui,non,sinon,xou,xor,and,or,not,yes
 // et comparateurs
+/**
+ * @param string $arg
+ */
 function filtre_logique($fonc, $code, $arg) {
 
 	switch (true) {
@@ -852,6 +858,9 @@ 
 }
 
 // http://code.spip.net/@compose_filtres_args
+/**
+ * @param string $sep
+ */
 function compose_filtres_args($p, $args, $sep) {
 	$arglist = "";
 	foreach ($args as $arg) {
@@ -899,6 +908,11 @@ 
 //
 
 // http://code.spip.net/@rindex_pile
+/**
+ * @param Champ $p
+ * @param string $champ
+ * @param string $motif
+ */
 function rindex_pile($p, $champ, $motif) {
 	$n = 0;
 	$b = $p->id_boucle;