spip / SPIP

ecrire/req/sqlite_generique.php

Doc Comments +30 added lines, -7 removed lines

@@ -854,6 +854,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){
 
 	$query = "INSERT INTO $table ".($champs ? "$champs VALUES $valeurs" : "DEFAULT VALUES");
@@ -1136,8 +1140,6 @@ 
 /**
  * Selectionne un fichier de base de donnees
  *
- * @param string $nom
- * 		Nom de la base a utiliser
  * @param string $serveur
  * 		Nom du connecteur
  * @param bool $requeter
@@ -1476,7 +1478,7 @@ 
  * renvoie grosso modo "$expression join($join, $v)"
  * http://doc.spip.org/@_sqlite_calculer_expression
  *
- * @param  $expression
+ * @param  string $expression
  * @param  $v
  * @param string $join
  * @return string
@@ -1502,7 +1504,7 @@ 
  * pour conversion 0+x ? (pas la peine en sqlite)
  * http://doc.spip.org/@_sqlite_calculer_order
  *
- * @param  $orderby
+ * @param  string $orderby
  * @return string
  */
 function _sqlite_calculer_order($orderby){
@@ -1611,7 +1613,6 @@ 
  * http://doc.spip.org/@_sqlite_modifier_table
  *
  * @param string/array $table : nom_table, array(nom_table=>nom_futur)
- * @param string/array $col : nom_colonne, array(nom_colonne=>nom_futur)
  * @param array $opt : options comme les tables spip, qui sera merge a la table creee : array('field'=>array('nom'=>'syntaxe', ...), 'key'=>array('KEY nom'=>'colonne', ...))
  * @param string $serveur : nom de la connexion sql en cours
  *
@@ -2062,32 +2063,50 @@ 
 		return spip_sqlite::$requeteurs[$serveur];
 	}
 
+	/**
+	 * @param string $serveur
+	 */
 	static function traduire_requete($query, $serveur){
 		$requeteur = spip_sqlite::requeteur($serveur);
 		$traducteur = new sqlite_traducteur($query, $requeteur->prefixe,$requeteur->sqlite_version);
 		return $traducteur->traduire_requete();
 	}
 
+	/**
+	 * @param string $serveur
+	 */
 	static function demarrer_transaction($serveur){
 		spip_sqlite::executer_requete("BEGIN TRANSACTION",$serveur);
 		spip_sqlite::$transaction_en_cours[$serveur] = true;
 	}
 
+	/**
+	 * @param boolean $tracer
+	 */
 	static function executer_requete($query, $serveur, $tracer=null){
 		$requeteur = spip_sqlite::requeteur($serveur);
 		return $requeteur->executer_requete($query, $tracer);
 	}
 
+	/**
+	 * @param string $serveur
+	 */
 	static function last_insert_id($serveur){
 		$requeteur = spip_sqlite::requeteur($serveur);
 		return $requeteur->last_insert_id($serveur);
 	}
 
+	/**
+	 * @param string $serveur
+	 */
 	static function annuler_transaction($serveur){
 		spip_sqlite::executer_requete("ROLLBACK",$serveur);
 		spip_sqlite::$transaction_en_cours[$serveur] = false;
 	}
 
+	/**
+	 * @param string $serveur
+	 */
 	static function finir_transaction($serveur){
 		// si pas de transaction en cours, ne rien faire et le dire
 		if (!isset (spip_sqlite::$transaction_en_cours[$serveur])
@@ -2123,7 +2142,7 @@ 
 	 *
 	 * @param  $query
 	 * @param string $serveur
-	 * @return bool
+	 * @return false|null
 	 */
 	function sqlite_requeteur($serveur = ''){
 		_sqlite_init();
@@ -2229,6 +2248,10 @@ 
 	// Pour les corrections a effectuer sur les requetes :
 	var $textes = array(); // array(code=>'texte') trouvé
 
+	/**
+	 * @param string $prefixe
+	 * @param string $sqlite_version
+	 */
 	function sqlite_traducteur($query, $prefixe, $sqlite_version){
 		$this->query = $query;
 		$this->prefixe = $prefixe;
@@ -2242,7 +2265,7 @@ 
 	 * la fonction affecte $this->query
 	 * http://doc.spip.org/@traduire_requete
 	 *
-	 * @return void
+	 * @return string
 	 */
 	function traduire_requete(){
 		//

prive/formulaires/configurer_relayeur.php

Doc Comments +3 added lines

@@ -87,6 +87,9 @@
 	return $res;
 }
 
+/**
+ * @param string $default
+ */
 function relayeur_saisie_ou_config($http_proxy, $default){
 	// http_proxy : ne pas prendre en compte la modif si le password est '****'
 	if (preg_match(',:\*\*\*\*@,', $http_proxy))

ecrire/req/mysql.php

Doc Comments +4 added lines, -5 removed lines

@@ -288,7 +288,7 @@ 
 
 // http://doc.spip.org/@spip_mysql_order
 /**
- * @param $orderby
+ * @param string $orderby
  * @return string
  */
 function spip_mysql_order($orderby)
@@ -325,7 +325,7 @@ 
 
 // http://doc.spip.org/@calculer_mysql_expression
 /**
- * @param $expression
+ * @param string $expression
  * @param $v
  * @param string $join
  * @return string
@@ -420,9 +420,8 @@ 
 /**
  * Selectionne une base de donnees
  *
- * @param string $nom
- * 		Nom de la base a utiliser
  * 
+ * @param string $db
  * @return bool
  * 		True cas de success.
  * 		False en cas d'erreur.
@@ -828,7 +827,7 @@ 
 // http://doc.spip.org/@spip_mysql_insert
 /**
  * @param $table
- * @param $champs
+ * @param string $champs
  * @param $valeurs
  * @param string $desc
  * @param string $serveur

ecrire/action/editer_liens.php

Doc Comments +1 added lines, -1 removed lines

@@ -177,7 +177,7 @@
  * 
  * @api
  * @param array $objets_source
- * @param array|string $objets_lies
+ * @param string $objets_lies
  * @return int
  */
 function objet_optimiser_liens($objets_source,$objets_lies){

ecrire/action/menu_rubriques.php

Doc Comments +3 added lines

@@ -45,6 +45,9 @@
 	}
 }
 
+/**
+ * @return string
+ */
 function menu_rubriques($complet = true){
 	$ret = "<li class='toutsite'><a href='".generer_url_ecrire('plan')."'>"._T('info_tout_site')."</a></li>";
 

ecrire/auth/ldap.php

Doc Comments +1 added lines, -1 removed lines

@@ -266,7 +266,7 @@
  * @param $new_pass
  * @param $id_auteur
  * @param string $serveur
- * @return bool
+ * @return string|boolean
  *  informe du succes ou de l'echec du changement du mot de passe
  */
 function auth_ldap_modifier_pass($login, $new_pass, $id_auteur, $serveur=''){

ecrire/balise/formulaire_.php

Doc Comments +1 added lines, -1 removed lines

@@ -56,7 +56,7 @@
  * @see trouver_fond()
  * @param string
  *     Nom du formulaire
- * @return string|bool
+ * @return string|false
  *     - string : chemin du squelette
  *     - false : pas de squelette trouvé
 **/

ecrire/balise/url_.php

Doc Comments +3 added lines

@@ -25,6 +25,9 @@
 // car rien ne garantit que le .htaccess soit identique. A approfondir
 
 // http://doc.spip.org/@generer_generer_url
+/**
+ * @param string $type
+ */
 function generer_generer_url($type, $p){
 	$_id = interprete_argument_balise(1,$p);
 

ecrire/base/connect_sql.php

Doc Comments +3 added lines

@@ -25,6 +25,9 @@
 // A l'installation, il faut simuler l'existence de ce fichier
 
 // http://doc.spip.org/@spip_connect
+/**
+ * @return string
+ */
 function spip_connect($serveur='', $version='') {
 	global $connexions, $spip_sql_version;