spip / SPIP

ecrire/plugins/infos_plugin.php

Doc Comments -2 removed lines

@@ -116,8 +116,6 @@
  * - 'nom' (= id)
  * - 'compatibilite' (= version)
  *
- * @param array $utilise
- * 		Liste des necessite trouvés pour le plugin
  * @return array
  * 		Liste des necessite modifiés.
  */

ecrire/public/compiler.php

Doc Comments +15 added lines

@@ -57,6 +57,9 @@ 
 
 
 // http://doc.spip.org/@argumenter_inclure
+/**
+ * @param boolean $rejet_filtres
+ */
 function argumenter_inclure($params, $rejet_filtres, $p, &$boucles, $id_boucle, $echap=true, $lang = '', $fond1=false){
 	$l = array();
 	$erreur_p_i_i = '';
@@ -665,6 +668,9 @@ 
 }
 
 // http://doc.spip.org/@calculer_dec
+/**
+ * @param string $nom
+ */
 function calculer_dec($nom, $val)
 {
 	$static = 'if (!isset($command[\''.$nom.'\'])) ';
@@ -712,6 +718,9 @@ 
 }
 
 // http://doc.spip.org/@calculer_from
+/**
+ * @param Boucle $boucle
+ */
 function calculer_from(&$boucle)
 {
   $res = "";
@@ -783,6 +792,9 @@ 
 define('_REGEXP_CONCAT_NON_VIDE', "/^(.*)[.]\s*'[^']+'\s*$/");
 
 // http://doc.spip.org/@compile_cas
+/**
+ * @param string $id_boucle
+ */
 function compile_cas($tableau, $descr, &$boucles, $id_boucle) {
 
         $codes = array();
@@ -960,6 +972,9 @@ 
 // de meme si EXP est de la forme (t ? '' : 'C')
 
 // http://doc.spip.org/@compile_retour
+/**
+ * @param string $tab
+ */
 function compile_retour($code, $avant, $apres, $altern, $tab, $n)
 {
 	if ($avant == "''") $avant = '';

ecrire/public/criteres.php

Doc Comments +13 added lines

@@ -788,6 +788,9 @@ 
 // Code specifique aux criteres {pagination}, {1,n} {n/m} etc
 //
 
+/**
+ * @param string $mode
+ */
 function calculer_parties(&$boucles, $id_boucle, $debut, $mode){
 	$total_parties = $boucles[$id_boucle]->total_parties;
 
@@ -978,6 +981,9 @@ 
 }
 
 // http://doc.spip.org/@critere_IN_cas
+/**
+ * @param string $crit2
+ */
 function critere_IN_cas($idb, &$boucles, $crit2, $arg, $op, $val, $col){
 	static $num = array();
 	$descr = $boucles[$idb]->descr;
@@ -1473,6 +1479,9 @@ 
 
 
 // http://doc.spip.org/@trouver_champ
+/**
+ * @param string $champ
+ */
 function trouver_champ($champ, $where){
 	if (!is_array($where))
 		return preg_match($champ, $where);
@@ -1680,6 +1689,10 @@ 
 }
 
 // http://doc.spip.org/@calculer_param_date
+/**
+ * @param string $date_compare
+ * @param string $date_orig
+ */
 function calculer_param_date($date_compare, $date_orig){
 	if (preg_match(",'\" *\.(.*)\. *\"',", $date_compare, $r)){
 		$init = "'\" . (\$x = $r[1]) . \"'";

ecrire/public/debusquer.php

Doc Comments +10 added lines

@@ -374,6 +374,10 @@ 
 }
 
 // http://doc.spip.org/@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);
 
@@ -459,6 +463,9 @@ 
 
 // l'environnement graphique du debuggueur 
 
+/**
+ * @param null|string $self
+ */
 function debusquer_squelette($fonc, $mode, $self){
 	global $debug_objets;
 
@@ -745,6 +752,9 @@ 
 }
 
 // http://doc.spip.org/@debusquer_entete
+/**
+ * @param string $corps
+ */
 function debusquer_entete($titre, $corps){
 	global $debug_objets;
 	include_spip('balise/formulaire_admin');

ecrire/public/references.php

Doc Comments +17 added lines

@@ -130,6 +130,10 @@ 
 }
 
 // http://doc.spip.org/@index_tables_en_pile
+/**
+ * @param string $nom_champ
+ * @param boolean $joker
+ */
 function index_tables_en_pile($idb, $nom_champ, &$boucles, &$joker) {
 	global $exceptions_des_tables;
 
@@ -568,6 +572,9 @@ 
 
 // Filtres et,ou,oui,non,sinon,xou,xor,and,or,not,yes
 // et comparateurs
+/**
+ * @param string $arg
+ */
 function filtre_logique($fonc, $code, $arg)
 {
 	global $table_criteres_infixes;
@@ -591,6 +598,9 @@ 
 }
 
 // http://doc.spip.org/@compose_filtres_args
+/**
+ * @param string $sep
+ */
 function compose_filtres_args($p, $args, $sep)
 {
 	$arglist = "";
@@ -607,6 +617,9 @@ 
 // ET chez sa maman
 // 
 // http://doc.spip.org/@calculer_argument_precedent
+/**
+ * @param string $defaut
+ */
 function calculer_argument_precedent($idb, $nom_champ, &$boucles, $defaut=null) {
 
 	// si recursif, forcer l'extraction du champ SQL mais ignorer le code
@@ -631,6 +644,10 @@ 
 //
 
 // http://doc.spip.org/@rindex_pile
+/**
+ * @param string $champ
+ * @param string $motif
+ */
 function rindex_pile($p, $champ, $motif) 
 {
 	$n = 0;

ecrire/public/sandbox.php

Doc Comments +1 added lines, -3 removed lines

@@ -20,8 +20,6 @@ 
  * dans les squelette
  *
  * @param string $texte
- * @param string $code
- * @param string $arglist
  * @param Object $p
  * @return string
  */
@@ -85,7 +83,7 @@ 
  * Composer le code d'inclusion PHP
  *
  * @param string $fichier
- * @param Object $p
+ * @param Inclure $p
  * @param array $_contexte
  * @return string
  */

ecrire/public/styliser.php

Doc Comments -1 removed lines

@@ -26,7 +26,6 @@
  * @param array $contexte
  * @param string $lang
  * @param string $connect
- * @param string $ext
  * @return array
  *
  * http://doc.spip.org/@public_styliser_dist

ecrire/public/styliser_par_z.php

Doc Comments +1 added lines, -3 removed lines

@@ -201,7 +201,7 @@ 
  * @param string $type
  * @param string $ext
  * @param bool $echafauder
- * @return mixed
+ * @return string|boolean
  */
 function z_contenu_disponible($prefix_path,$z_contenu,$type,$ext,$echafauder=true){
 	if ($d = z_trouver_bloc($prefix_path,$z_contenu,$type,$ext))
@@ -295,10 +295,8 @@ 
  * tous les squelettes d'echafaudage du prive sont en fait explicites dans prive/echafaudage
  * on ne fait qu'un mini squelette d'inclusion pour reecrire les variables d'env
  *
- * @param string $type
  * @param string $table
  * @param string $table_sql
- * @param array $desc
  * @param string $ext
  * @return string
  */

ecrire/req/pg.php

Doc Comments +29 added lines, -4 removed lines

@@ -120,6 +120,11 @@ 
 
 // Par ou ca passe une fois les traductions faites
 // http://doc.spip.org/@spip_pg_trace_query
+/**
+ * @param string $query
+ *
+ * @return resource
+ */
 function spip_pg_trace_query($query, $serveur='')
 {
 	$connexion = &$GLOBALS['connexions'][$serveur ? strtolower($serveur) : 0];
@@ -255,6 +260,9 @@ 
 }
 	      
 // http://doc.spip.org/@spip_pg_alter_change
+/**
+ * @param string $arg
+ */
 function spip_pg_alter_change($table, $arg, $serveur='',$requeter=true)
 {
 	if (!preg_match('/^`?(\w+)`?\s+`?(\w+)`?\s+(.*?)\s*(DEFAULT .*?)?(NOT\s+NULL)?\s*(DEFAULT .*?)?$/i',$arg, $r)) {
@@ -373,7 +381,7 @@ 
  * 
  * @param string $nom : nom de l'index
  * @param string $table : table sql de l'index
- * @param string/array $champs : liste de champs sur lesquels s'applique l'index
+ * @param string $champs : liste de champs sur lesquels s'applique l'index
  * @param string $serveur : nom de la connexion sql utilisee
  * @param bool $requeter : true pour executer la requete ou false pour retourner le texte de la requete
  * 
@@ -424,8 +432,6 @@ 
 /**
  * Selectionne une base de donnees
  *
- * @param string $nom
- * 		Nom de la base a utiliser
  * @param string $serveur
  * 		Nom du connecteur
  * @param bool $requeter
@@ -519,6 +525,9 @@ 
 }
 
 // http://doc.spip.org/@spip_pg_orderby
+/**
+ * @param string $order
+ */
 function spip_pg_orderby($order, $select)
 {
 	$res = array();
@@ -680,6 +689,9 @@ 
 }
 
 // http://doc.spip.org/@calculer_pg_where
+/**
+ * @param string $v
+ */
 function calculer_pg_where($v)
 {
 	if (!is_array($v))
@@ -703,6 +715,9 @@ 
 
 
 // http://doc.spip.org/@calculer_pg_expression
+/**
+ * @param string $expression
+ */
 function calculer_pg_expression($expression, $v, $join = 'AND'){
 	if (empty($v))
 		return '';
@@ -749,6 +764,9 @@ 
 }
 
 // http://doc.spip.org/@spip_pg_fetch
+/**
+ * @param resource $res
+ */
 function spip_pg_fetch($res, $t='', $serveur='',$requeter=true) {
 
 	if ($res) $res = pg_fetch_array($res, NULL, PGSQL_ASSOC);
@@ -805,6 +823,10 @@ 
 }
 
 // http://doc.spip.org/@spip_pg_insert
+/**
+ * @param string $champs
+ * @param string $valeurs
+ */
 function spip_pg_insert($table, $champs, $valeurs, $desc=array(), $serveur='',$requeter=true) {
 	$connexion = &$GLOBALS['connexions'][$serveur ? strtolower($serveur) : 0];
 	$prefixe = $connexion['prefixe'];
@@ -1115,6 +1137,9 @@ 
 }
 
 // http://doc.spip.org/@spip_pg_error
+/**
+ * @param string $serveur
+ */
 function spip_pg_error($query='', $serveur, $requeter=true) {
 	$link = $GLOBALS['connexions'][$serveur ? strtolower($serveur) : 0]['link'];
 	$s = $link ? pg_last_error($link) : pg_last_error();
@@ -1158,7 +1183,7 @@ 
  * @param bool $requeter
  *     true pour éxecuter la requête
  *     false pour retourner le texte de la requête.
- * @return ressource
+ * @return resource
  *     Ressource à utiliser avec sql_fetch()
 **/
 function spip_pg_showbase($match, $serveur='',$requeter=true)