spip / SPIP

ecrire/auth/ldap.php

Doc Comments +3 added lines

@@ -138,6 +138,9 @@
 	return '';
 }
 
+/**
+ * @param string $dn
+ */
 function auth_ldap_retrouver($dn, $desc=array(), $serveur='')
 {
 	// Lire les infos sur l'utilisateur a partir de son DN depuis LDAP

ecrire/auth/sha256.inc.php

Doc Comments +33 added lines

@@ -135,15 +135,41 @@ 
             return (int)$x >> (int)$n;
         }
 
+        /**
+         * @param integer $n
+         */
         function ROTR($x, $n) { return (int)(($this->SHR($x, $n) | ($x << (32-$n)) & 0xFFFFFFFF)); }
+
+        /**
+         * @param integer $x
+         * @param integer $y
+         * @param integer $z
+         */
         function Ch($x, $y, $z) { return ($x & $y) ^ ((~$x) & $z); }
+
+        /**
+         * @param integer $x
+         * @param integer $y
+         * @param integer $z
+         */
         function Maj($x, $y, $z) { return ($x & $y) ^ ($x & $z) ^ ($y & $z); }
+
+        /**
+         * @param integer $x
+         */
         function Sigma0($x) { return (int) ($this->ROTR($x, 2)^$this->ROTR($x, 13)^$this->ROTR($x, 22)); }
+
+        /**
+         * @param integer $x
+         */
         function Sigma1($x) { return (int) ($this->ROTR($x, 6)^$this->ROTR($x, 11)^$this->ROTR($x, 25)); }
         function sigma_0($x) { return (int) ($this->ROTR($x, 7)^$this->ROTR($x, 18)^$this->SHR($x, 3)); }
         function sigma_1($x) { return (int) ($this->ROTR($x, 17)^$this->ROTR($x, 19)^$this->SHR($x, 10)); }
 
 
+				/**
+				 * @param integer $byteSize
+				 */
 				function string2ordUTF8($s,&$byteSize){
 					$chars = array();
 					// par defaut sur 8bits
@@ -219,6 +245,9 @@ 
 					return $bin;
 				}
 
+				/**
+				 * @param integer $n
+				 */
 				function array_split($a, $n) {
 					$split = array();
 					while (count($a)>$n) {
@@ -434,6 +463,10 @@ 
 if (!function_exists('hash'))
 {
     define('_NO_HASH_DEFINED',true);
+
+    /**
+     * @param string $algo
+     */
     function hash($algo, $data)
     {
         if (empty($algo) || !is_string($algo) || !is_string($data)) {

ecrire/balise/formulaire_.php

Doc Comments +6 added lines

@@ -57,6 +57,9 @@ 
 
 /* prendre en charge par defaut les balises dynamiques formulaires simples */
 // http://doc.spip.org/@balise_FORMULAIRE__dyn
+/**
+ * @param string $form
+ */
 function balise_FORMULAIRE__dyn($form)
 {
 	$form = existe_formulaire($form);
@@ -77,6 +80,9 @@ 
 	return array("formulaires/$form", 3600, $contexte);
 }
 
+/**
+ * @param string $form
+ */
 function balise_FORMULAIRE__contexte($form, $args)
 {
 	// tester si ce formulaire vient d'etre poste (memes arguments)

ecrire/balise/formulaire_admin.php

Doc Comments +6 added lines

@@ -130,6 +130,9 @@ 
 
 
 // http://doc.spip.org/@admin_preview
+/**
+ * @param string $id
+ */
 function admin_preview($id, $id_type)
 {
 	if ($GLOBALS['var_preview']) return '';
@@ -199,6 +202,9 @@ 
 
 // Tant que les stats ne sont pas passees dans une extension, il faut les traiter ici
 // http://doc.spip.org/@admin_stats
+/**
+ * @param string $id
+ */
 function admin_stats($id, $id_type, $var_preview)
 {
 	if ($GLOBALS['meta']["activer_statistiques"] != "non" 

ecrire/balise/logo_.php

Doc Comments +7 added lines

@@ -96,6 +96,13 @@
 	return $p;
 }
 
+/**
+ * @param string $id_objet
+ * @param string $_id_objet
+ * @param string $type
+ * @param integer $fichier
+ * @param string $suite
+ */
 function logo_survol($id_objet, $_id_objet, $type, $align, $fichier, $lien, $p, $suite)
 {
 	$code = "quete_logo('$id_objet', '" .

ecrire/balise/menu_lang_ecrire.php

Doc Comments +3 added lines

@@ -37,6 +37,9 @@
 }
 
 // http://doc.spip.org/@menu_lang_pour_tous
+/**
+ * @param string $nom
+ */
 function menu_lang_pour_tous($nom, $default) {
 	include_spip('inc/lang');
 

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/abstract_sql.php

Doc Comments +28 added lines

@@ -34,6 +34,9 @@ 
 
 // Demande si un charset est disponible. 
 // http://doc.spip.org/@sql_get_charset
+/**
+ * @return string
+ */
 function sql_get_charset($charset, $serveur='', $option=true){
   // le nom http du charset differe parfois du nom SQL utf-8 ==> utf8 etc.
 	$desc = sql_serveur('', $serveur, true,true);
@@ -205,6 +208,9 @@ 
 // Elle est fournie pour permettre l'actualisation de vieux codes 
 // par un Sed brutal qui peut donner des resultats provisoirement acceptables
 // http://doc.spip.org/@sql_insert
+/**
+ * @param string $table
+ */
 function sql_insert($table, $noms, $valeurs, $desc=array(), $serveur='', $option=true)
 {
 	$f = sql_serveur('insert', $serveur,  $option==='continue' OR $option===false);
@@ -225,6 +231,9 @@ 
 }
 
 // http://doc.spip.org/@sql_insertq_multi
+/**
+ * @param string $table
+ */
 function sql_insertq_multi($table, $couples=array(), $desc=array(), $serveur='', $option=true)
 {
 	$f = sql_serveur('insertq_multi', $serveur,  $option==='continue' OR $option===false);
@@ -235,6 +244,9 @@ 
 }
 
 // http://doc.spip.org/@sql_update
+/**
+ * @param string $table
+ */
 function sql_update($table, $exp, $where='', $desc=array(), $serveur='', $option=true)
 {
 	$f = sql_serveur('update', $serveur,  $option==='continue' OR $option===false);
@@ -322,6 +334,9 @@ 
 	return $f($spip, $serveur, $option!==false);
 }
 
+/**
+ * @param string $spip
+ */
 function sql_alltable($spip=NULL, $serveur='', $option=true)
 {
 	$q = sql_showbase($spip, $serveur, $option);
@@ -382,6 +397,9 @@ 
 }
 
 // http://doc.spip.org/@sql_multi
+/**
+ * @param string $sel
+ */
 function sql_multi($sel, $lang, $serveur='', $option=true)
 {
 	$f = sql_serveur('multi', $serveur,  $option==='continue' OR $option===false);
@@ -479,6 +497,9 @@ 
 }
 
 // http://doc.spip.org/@sql_version
+/**
+ * @return string
+ */
 function sql_version($serveur='', $option=true) {
 	$row = sql_fetsel("version() AS n", '','','','','','',$serveur);
 	return ($row['n']);
@@ -488,6 +509,9 @@ 
 // et retourne sa representation numerique:
 // FF ==> 0xFF en MySQL mais x'FF' en PG
 // http://doc.spip.org/@sql_hex
+/**
+ * @param string $val
+ */
 function sql_hex($val, $serveur='', $option=true)
 {
 	$f = sql_serveur('hex', $serveur,  $option==='continue' OR $option===false);
@@ -526,6 +550,10 @@ 
 // s'il accepte les requetes imbriquees afin d'optimiser ca
 
 // http://doc.spip.org/@sql_in_select
+/**
+ * @param string $in
+ * @param string $select
+ */
 function sql_in_select($in, $select, $from = array(), $where = array(),
 		    $groupby = array(), $orderby = array(), $limit = '', $having = array(), $serveur='')
 {

ecrire/base/connect_sql.php

Doc Comments +9 added lines

@@ -24,6 +24,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;
 
@@ -128,6 +131,9 @@ 
 // connue seulement des convertisseurs automatiques
 
 // http://doc.spip.org/@spip_connect_sql
+/**
+ * @return string
+ */
 function spip_connect_sql($version, $ins='', $serveur='', $cont=false) {
 	$desc = spip_connect($serveur, $version);
 	if (function_exists($f = @$desc[$version][$ins])) return $f;
@@ -330,6 +336,9 @@ 
 
 // Recuperer le nom de la table de jointure xxxx sur l'objet yyyy
 // http://doc.spip.org/@table_jointure
+/**
+ * @param string $x
+ */
 function table_jointure($x, $y) {
 	$trouver_table = charger_fonction('trouver_table', 'base');
 	$xdesc = $trouver_table(table_objet($x));