@@ -135,15 +135,41 @@ discard block  | 
                                                    ||
| 135 | 135 | return (int)$x >> (int)$n;  | 
                                                        
| 136 | 136 | }  | 
                                                        
| 137 | 137 | |
| 138 | + /**  | 
                                                        |
| 139 | + * @param integer $n  | 
                                                        |
| 140 | + */  | 
                                                        |
| 138 | 141 |          function ROTR($x, $n) { return (int)(($this->SHR($x, $n) | ($x << (32-$n)) & 0xFFFFFFFF)); } | 
                                                        
| 142 | +  | 
                                                        |
| 143 | + /**  | 
                                                        |
| 144 | + * @param integer $x  | 
                                                        |
| 145 | + * @param integer $y  | 
                                                        |
| 146 | + * @param integer $z  | 
                                                        |
| 147 | + */  | 
                                                        |
| 139 | 148 |          function Ch($x, $y, $z) { return ($x & $y) ^ ((~$x) & $z); } | 
                                                        
| 149 | +  | 
                                                        |
| 150 | + /**  | 
                                                        |
| 151 | + * @param integer $x  | 
                                                        |
| 152 | + * @param integer $y  | 
                                                        |
| 153 | + * @param integer $z  | 
                                                        |
| 154 | + */  | 
                                                        |
| 140 | 155 |          function Maj($x, $y, $z) { return ($x & $y) ^ ($x & $z) ^ ($y & $z); } | 
                                                        
| 156 | +  | 
                                                        |
| 157 | + /**  | 
                                                        |
| 158 | + * @param integer $x  | 
                                                        |
| 159 | + */  | 
                                                        |
| 141 | 160 |          function Sigma0($x) { return (int) ($this->ROTR($x, 2)^$this->ROTR($x, 13)^$this->ROTR($x, 22)); } | 
                                                        
| 161 | +  | 
                                                        |
| 162 | + /**  | 
                                                        |
| 163 | + * @param integer $x  | 
                                                        |
| 164 | + */  | 
                                                        |
| 142 | 165 |          function Sigma1($x) { return (int) ($this->ROTR($x, 6)^$this->ROTR($x, 11)^$this->ROTR($x, 25)); } | 
                                                        
| 143 | 166 |          function sigma_0($x) { return (int) ($this->ROTR($x, 7)^$this->ROTR($x, 18)^$this->SHR($x, 3)); } | 
                                                        
| 144 | 167 |          function sigma_1($x) { return (int) ($this->ROTR($x, 17)^$this->ROTR($x, 19)^$this->SHR($x, 10)); } | 
                                                        
| 145 | 168 | |
| 146 | 169 | |
| 170 | + /**  | 
                                                        |
| 171 | + * @param integer $byteSize  | 
                                                        |
| 172 | + */  | 
                                                        |
| 147 | 173 |  				function string2ordUTF8($s,&$byteSize){ | 
                                                        
| 148 | 174 | $chars = array();  | 
                                                        
| 149 | 175 | // par defaut sur 8bits  | 
                                                        
@@ -219,6 +245,9 @@ discard block  | 
                                                    ||
| 219 | 245 | return $bin;  | 
                                                        
| 220 | 246 | }  | 
                                                        
| 221 | 247 | |
| 248 | + /**  | 
                                                        |
| 249 | + * @param integer $n  | 
                                                        |
| 250 | + */  | 
                                                        |
| 222 | 251 |  				function array_split($a, $n) { | 
                                                        
| 223 | 252 | $split = array();  | 
                                                        
| 224 | 253 |  					while (count($a)>$n) { | 
                                                        
@@ -434,6 +463,10 @@ discard block  | 
                                                    ||
| 434 | 463 |  if (!function_exists('hash')) | 
                                                        
| 435 | 464 |  { | 
                                                        
| 436 | 465 |      define('_NO_HASH_DEFINED',true); | 
                                                        
| 466 | +  | 
                                                        |
| 467 | + /**  | 
                                                        |
| 468 | + * @param string $algo  | 
                                                        |
| 469 | + */  | 
                                                        |
| 437 | 470 | function hash($algo, $data)  | 
                                                        
| 438 | 471 |      { | 
                                                        
| 439 | 472 |          if (empty($algo) || !is_string($algo) || !is_string($data)) { | 
                                                        
@@ -96,6 +96,13 @@  | 
                                                    ||
| 96 | 96 | return $p;  | 
                                                        
| 97 | 97 | }  | 
                                                        
| 98 | 98 | |
| 99 | +/**  | 
                                                        |
| 100 | + * @param string $id_objet  | 
                                                        |
| 101 | + * @param string $_id_objet  | 
                                                        |
| 102 | + * @param string $type  | 
                                                        |
| 103 | + * @param integer $fichier  | 
                                                        |
| 104 | + * @param string $suite  | 
                                                        |
| 105 | + */  | 
                                                        |
| 99 | 106 | function logo_survol($id_objet, $_id_objet, $type, $align, $fichier, $lien, $p, $suite)  | 
                                                        
| 100 | 107 |  { | 
                                                        
| 101 | 108 |  	$code = "quete_logo('$id_objet', '" . | 
                                                        
@@ -25,6 +25,9 @@  | 
                                                    ||
| 25 | 25 | // car rien ne garantit que le .htaccess soit identique. A approfondir  | 
                                                        
| 26 | 26 | |
| 27 | 27 | // http://doc.spip.org/@generer_generer_url  | 
                                                        
| 28 | +/**  | 
                                                        |
| 29 | + * @param string $type  | 
                                                        |
| 30 | + */  | 
                                                        |
| 28 | 31 | function generer_generer_url($type, $p)  | 
                                                        
| 29 | 32 |  { | 
                                                        
| 30 | 33 | $_id = interprete_argument_balise(1,$p);  | 
                                                        
@@ -231,6 +231,9 @@  | 
                                                    ||
| 231 | 231 | |
| 232 | 232 | // pour versions <= 1.926  | 
                                                        
| 233 | 233 | // http://doc.spip.org/@upgrade_vers  | 
                                                        
| 234 | +/**  | 
                                                        |
| 235 | + * @param double $version  | 
                                                        |
| 236 | + */  | 
                                                        |
| 234 | 237 |  function upgrade_vers($version, $version_installee, $version_cible = 0){ | 
                                                        
| 235 | 238 | return ($version_installee<$version  | 
                                                        
| 236 | 239 | AND (($version_cible>=$version) OR ($version_cible==0))  | 
                                                        
@@ -30,6 +30,11 @@  | 
                                                    ||
| 30 | 30 | }  | 
                                                        
| 31 | 31 | |
| 32 | 32 | // http://doc.spip.org/@exec_rechercher_args  | 
                                                        
| 33 | +/**  | 
                                                        |
| 34 | + * @param integer $id  | 
                                                        |
| 35 | + * @param integer $exclus  | 
                                                        |
| 36 | + * @param string $rac  | 
                                                        |
| 37 | + */  | 
                                                        |
| 33 | 38 | function exec_rechercher_args($id, $type, $exclus, $rac, $do)  | 
                                                        
| 34 | 39 |  { | 
                                                        
| 35 | 40 | if (!$do) $do = 'aff';  | 
                                                        
@@ -34,6 +34,10 @@ discard block  | 
                                                    ||
| 34 | 34 |  define('_VERSIONS_SERVEUR', 'http://files.spip.org/'); | 
                                                        
| 35 | 35 |  define('_VERSIONS_LISTE', 'archives.xml'); | 
                                                        
| 36 | 36 | |
| 37 | +/**  | 
                                                        |
| 38 | + * @param string $dir  | 
                                                        |
| 39 | + * @param string $file  | 
                                                        |
| 40 | + */  | 
                                                        |
| 37 | 41 |  function info_maj ($dir, $file, $version){ | 
                                                        
| 38 | 42 |  	include_spip('inc/plugin'); | 
                                                        
| 39 | 43 | |
@@ -67,6 +71,11 @@ discard block  | 
                                                    ||
| 67 | 71 | // on teste la nouveaute par If-Modified-Since,  | 
                                                        
| 68 | 72 | // et seulement quand celui-ci a change' pour limiter les acces HTTP  | 
                                                        
| 69 | 73 | |
| 74 | +/**  | 
                                                        |
| 75 | + * @param string $nom  | 
                                                        |
| 76 | + *  | 
                                                        |
| 77 | + * @return string  | 
                                                        |
| 78 | + */  | 
                                                        |
| 70 | 79 | function info_maj_cache($nom, $dir, $page='')  | 
                                                        
| 71 | 80 |  { | 
                                                        
| 72 | 81 | $re = '<archives id="a' . $GLOBALS['meta']["alea_ephemere"] . '">';  | 
                                                        
@@ -167,6 +167,9 @@  | 
                                                    ||
| 167 | 167 | }  | 
                                                        
| 168 | 168 | |
| 169 | 169 | // http://doc.spip.org/@copy_request  | 
                                                        
| 170 | +/**  | 
                                                        |
| 171 | + * @param string $suite  | 
                                                        |
| 172 | + */  | 
                                                        |
| 170 | 173 | function copy_request($script, $suite, $submit='')  | 
                                                        
| 171 | 174 |  { | 
                                                        
| 172 | 175 |          include_spip('inc/filtres'); | 
                                                        
@@ -205,6 +205,9 @@  | 
                                                    ||
| 205 | 205 | }  | 
                                                        
| 206 | 206 | }  | 
                                                        
| 207 | 207 | |
| 208 | +/**  | 
                                                        |
| 209 | + * @param string $to  | 
                                                        |
| 210 | + */  | 
                                                        |
| 208 | 211 | function mail_normaliser_headers($headers, $from, $to, $texte, $parts="")  | 
                                                        
| 209 | 212 |  { | 
                                                        
| 210 | 213 | $charset = $GLOBALS['meta']['charset'];  | 
                                                        
@@ -14,6 +14,9 @@  | 
                                                    ||
| 14 | 14 |  include_spip('inc/filtres_images_lib_mini'); // par precaution | 
                                                        
| 15 | 15 | |
| 16 | 16 | // http://doc.spip.org/@couleur_html_to_hex  | 
                                                        
| 17 | +/**  | 
                                                        |
| 18 | + * @param string $couleur  | 
                                                        |
| 19 | + */  | 
                                                        |
| 17 | 20 |  function couleur_html_to_hex($couleur){ | 
                                                        
| 18 | 21 | $couleurs_html=array(  | 
                                                        
| 19 | 22 | 'aqua'=>'00FFFF','black'=>'000000','blue'=>'0000FF','fuchsia'=>'FF00FF','gray'=>'808080','green'=>'008000','lime'=>'00FF00','maroon'=>'800000',  |