spip / SPIP

ecrire/public/quete.php

Doc Comments +16 added lines

@@ -23,10 +23,19 @@ 
 # retourne le chapeau d'un article, et seulement s'il est publie
 
 // http://doc.spip.org/@quete_chapo
+/**
+ * @param integer $id_article
+ * @param string $connect
+ *
+ * @return string
+ */
 function quete_chapo($id_article, $connect) {
 	return sql_getfetsel('chapo', 'spip_articles', array("id_article=".intval($id_article), "statut='publie'"), '','','','',$connect);
 }
 
+/**
+ * @param string $table
+ */
 function quete_parent_lang($table,$id,$connect=''){
 	static $cache_quete = array();
 
@@ -53,6 +62,9 @@ 
 # retourne la rubrique d'un article
 
 // http://doc.spip.org/@quete_rubrique
+/**
+ * @param string $serveur
+ */
 function quete_rubrique($id_article, $serveur) {
 	$id_parent = quete_parent_lang('spip_articles',$id_article,$serveur);
 	return $id_parent['id_rubrique'];
@@ -126,6 +138,10 @@ 
 
 // recuperer une meta sur un site distant (en local il y a plus simple)
 // http://doc.spip.org/@quete_meta
+/**
+ * @param string $nom
+ * @param string $serveur
+ */
 function quete_meta($nom, $serveur) {
 	return sql_getfetsel("valeur", "spip_meta", "nom=" . sql_quote($nom),
 			     '','','','',$serveur);

ecrire/public/references.php

Doc Comments +13 added lines

@@ -61,6 +61,9 @@ 
 }
 
 // http://doc.spip.org/@index_tables_en_pile
+/**
+ * @param string $nom_champ
+ */
 function index_tables_en_pile($idb, $nom_champ, &$boucles) {
 	global $exceptions_des_tables;
 
@@ -467,6 +470,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;
@@ -490,6 +496,9 @@ 
 }
 
 // http://doc.spip.org/@compose_filtres_args
+/**
+ * @param string $sep
+ */
 function compose_filtres_args($p, $args, $sep)
 {
 	$arglist = "";
@@ -531,6 +540,10 @@ 
 //
 
 // http://doc.spip.org/@rindex_pile
+/**
+ * @param string $champ
+ * @param string $motif
+ */
 function rindex_pile($p, $champ, $motif) 
 {
 	$n = 0;

ecrire/public/tracer.php

Doc Comments +3 added lines

@@ -36,6 +36,9 @@
 }
 
 // http://doc.spip.org/@trace_query_chrono
+/**
+ * @param string $m2
+ */
 function trace_query_chrono($m1, $m2, $query, $result, $serveur='')
 {
 	static $tt = 0, $nb=0;

ecrire/public/vertebrer.php

Doc Comments +3 added lines

@@ -27,6 +27,9 @@
 // distingue champ numerique et non numerique
 
 // http://doc.spip.org/@vertebrer_sort
+/**
+ * @param string $direction
+ */
 function vertebrer_sort($fields, $direction)
 {
 	$res = '';

ecrire/req/mysql.php

Doc Comments +12 added lines

@@ -229,6 +229,9 @@ 
 // Pas portable malheureusement, on laisse pour le moment.
 
 // http://doc.spip.org/@spip_mysql_order
+/**
+ * @param string $orderby
+ */
 function spip_mysql_order($orderby)
 {
 	return (is_array($orderby)) ? join(", ", $orderby) :  $orderby;
@@ -258,6 +261,9 @@ 
 }
 
 // http://doc.spip.org/@calculer_mysql_expression
+/**
+ * @param string $expression
+ */
 function calculer_mysql_expression($expression, $v, $join = 'AND'){
 	if (empty($v))
 		return '';
@@ -340,6 +346,9 @@ 
 }
 
 // http://doc.spip.org/@spip_mysql_selectdb
+/**
+ * @param string $db
+ */
 function spip_mysql_selectdb($db) {
 	$ok = mysql_select_db($db);
 	if (!$ok)
@@ -600,6 +609,9 @@ 
 }
 
 // http://doc.spip.org/@spip_mysql_insert
+/**
+ * @param string $champs
+ */
 function spip_mysql_insert($table, $champs, $valeurs, $desc='', $serveur='',$requeter=true) {
 
 	$connexion = &$GLOBALS['connexions'][$serveur ? strtolower($serveur) : 0];

ecrire/req/pg.php

Doc Comments +28 added lines, -1 removed lines

@@ -105,6 +105,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];
@@ -238,6 +243,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)) {
@@ -357,7 +365,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
  * 
@@ -484,6 +492,9 @@ 
 }
 
 // http://doc.spip.org/@spip_pg_orderby
+/**
+ * @param string $order
+ */
 function spip_pg_orderby($order, $select)
 {
 	$res = array();
@@ -631,6 +642,9 @@ 
 }
 
 // http://doc.spip.org/@calculer_pg_where
+/**
+ * @param string $v
+ */
 function calculer_pg_where($v)
 {
 	if (!is_array($v))
@@ -654,6 +668,9 @@ 
 
 
 // http://doc.spip.org/@calculer_pg_expression
+/**
+ * @param string $expression
+ */
 function calculer_pg_expression($expression, $v, $join = 'AND'){
 	if (empty($v))
 		return '';
@@ -700,6 +717,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);
@@ -756,6 +776,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'];
@@ -1061,6 +1085,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();

ecrire/req/sqlite_fonctions.php

Doc Comments +6 added lines

@@ -85,6 +85,9 @@ 
 
 // permet au besoin de charger des fonctions ailleurs par _sqlite_init_functions();
 // http://doc.spip.org/@_sqlite_add_function
+/**
+ * @param string $f
+ */
 function _sqlite_add_function(&$sqlite, &$f, &$r){
 	if (_sqlite_is_version(3, $sqlite)){
 		isset($r[1])
@@ -246,6 +249,9 @@ 
 
 
 // http://doc.spip.org/@_sqlite_func_unix_timestamp
+/**
+ * @param string $d
+ */
 function _sqlite_func_unix_timestamp($d) {
 	//2005-12-02 20:53:53
 	#spip_log("Passage avec UNIX_TIMESTAMP : $d",'debug');

ecrire/req/sqlite_generique.php

Doc Comments +13 added lines

@@ -728,6 +728,10 @@ 
 
 
 // http://doc.spip.org/@spip_sqlite_insert
+/**
+ * @param string $champs
+ * @param string $valeurs
+ */
 function spip_sqlite_insert($table, $champs, $valeurs, $desc='', $serveur='',$requeter=true) {
 
 	$connexion = $GLOBALS['connexions'][$serveur ? $serveur : 0];
@@ -1182,6 +1186,9 @@ 
 
 // renvoie grosso modo "$expression join($join, $v)"
 // http://doc.spip.org/@_sqlite_calculer_expression
+/**
+ * @param string $expression
+ */
 function _sqlite_calculer_expression($expression, $v, $join = 'AND'){
 	if (empty($v))
 		return '';
@@ -1203,6 +1210,9 @@ 
 
 // pour conversion 0+x ? (pas la peine en sqlite)
 // http://doc.spip.org/@_sqlite_calculer_order
+/**
+ * @param string $orderby
+ */
 function _sqlite_calculer_order($orderby) {
 	return (is_array($orderby)) ? join(", ", $orderby) :  $orderby;
 }
@@ -1692,6 +1702,9 @@ 
 	// lancer la requete $this->query,
 	// faire le tracage si demande 
 // http://doc.spip.org/@executer_requete
+	/**
+	 * @return string
+	 */
 	function executer_requete(){
 		$err = "";
 		if ($this->tracer) {

ecrire/urls/propres.php

Doc Comments +3 added lines

@@ -62,6 +62,9 @@
 // Retire les marqueurs de type dans une URL propre ancienne maniere
 
 // http://doc.spip.org/@retirer_marqueurs_url_propre
+/**
+ * @param string $url_propre
+ */
 function retirer_marqueurs_url_propre($url_propre) {
 	if (preg_match(',^[+][-](.*?)[-][+]$,', $url_propre, $regs)) {
 		return $regs[1];