spip / SPIP

ecrire/genie/optimiser.php

Doc Comments +3 added lines

@@ -65,6 +65,9 @@
 // L'index du SELECT doit s'appeler "id"
 
 // http://doc.spip.org/@optimiser_sansref
+/**
+ * @param string $id
+ */
 function optimiser_sansref($table, $id, $sel, $and="")
 {
 	$in = array();

ecrire/inc/acces.php

Doc Comments +6 added lines

@@ -105,6 +105,9 @@ 
 // Inclure les arguments significatifs pour le hachage
 // cas particulier du statut pour compatibilite ancien rss/suivi_revisions
 
+/**
+ * @param string $op
+ */
 function param_low_sec($op, $args=array(), $lang='', $mime='rss')
 {
 	$a = $b = '';
@@ -202,6 +205,9 @@ 
 // Installe ou verifie un .htaccess, y compris sa prise en compte par Apache
 //
 // http://doc.spip.org/@verifier_htaccess
+/**
+ * @param string|null $rep
+ */
 function verifier_htaccess($rep, $force=false) {
 	$htaccess = rtrim($rep,"/") . "/" . _ACCESS_FILE_NAME;
 	if (((@file_exists($htaccess)) OR defined('_TEST_DIRS')) AND !$force)

ecrire/inc/actions.php

Doc Comments +12 added lines, -2 removed lines

@@ -24,11 +24,11 @@ 
  *   -1 : renvoyer action, arg et hash sous forme de array()
  *   true ou false : renvoyer une url, avec & (false) ou & (true)
  *   string : renvoyer un formulaire
- * @param string|int $att
+ * @param string $att
  *   id_auteur pour lequel generer l'action en mode url ou array()
  *   atributs du formulaire en mode formulaire
  * @param bool $public
- * @return array|string
+ * @return string
  */
 function generer_action_auteur($action, $arg, $redirect = "", $mode = false, $att = '', $public = false){
 	$securiser_action = charger_fonction('securiser_action', 'inc');
@@ -36,6 +36,10 @@ 
 }
 
 // http://doc.spip.org/@redirige_action_auteur
+/**
+ * @param string $action
+ * @param string $ret
+ */
 function redirige_action_auteur($action, $arg, $ret, $gra = '', $mode = false, $atts = '', $public = false) {
 
 	$r = ($public ? _DIR_RESTREINT_ABS : _DIR_RESTREINT) .generer_url_ecrire($ret, $gra, true, true);
@@ -44,6 +48,12 @@ 
 }
 
 // http://doc.spip.org/@redirige_action_post
+/**
+ * @param string $action
+ * @param string $arg
+ * @param string $ret
+ * @param string $gra
+ */
 function redirige_action_post($action, $arg, $ret, $gra, $corps, $att = ''){
 	$r = _DIR_RESTREINT.generer_url_ecrire($ret, $gra, false, true);
 	return generer_action_auteur($action, $arg, $r, $corps, $att." method='post'");

ecrire/inc/aider.php

Doc Comments +6 added lines

@@ -92,6 +92,9 @@ 
 	return aider_icone($url);
 }
 
+/**
+ * @param null|string $url
+ */
 function aider_icone($url, $clic= '')
 {
 	global $spip_lang, $spip_lang_rtl;
@@ -118,6 +121,9 @@ 
 // Les sections d'un fichier aide sont reperees ainsi:
 define('_SECTIONS_AIDE', ',<h([12])(?:\s+class="spip")?'. '>([^/]+?)(?:/(.+?))?</h\1>,ism');
 
+/**
+ * @param string $path
+ */
 function aide_fichier($path, $help_server) {
 
 	$md5 = md5(serialize($help_server));

ecrire/inc/auth.php

Doc Comments +4 added lines

@@ -448,6 +448,10 @@
 	return $securiser_action('auth', "$auth_methode/$login", $redirect, true);
 }
 
+/**
+ * @param string $auth_methode
+ * @param string $login
+ */
 function auth_terminer_identifier_login($auth_methode, $login, $serveur=''){
 	$args = func_get_args();
 	$auteur = auth_administrer('terminer_identifier_login',$args);

ecrire/inc/bandeau.php

Doc Comments -3 removed lines

@@ -132,9 +132,6 @@
 /**
  * Construire tout le bandeau superieur de l'espace prive
  *
- * @param unknown_type $rubrique
- * @param unknown_type $sous_rubrique
- * @param unknown_type $largeur
  * @return unknown
  */
 function inc_bandeau_dist() {

ecrire/inc/boutons.php

Doc Comments +4 added lines

@@ -73,6 +73,10 @@
 
 
 // http://doc.spip.org/@barre_onglets
+/**
+ * @param string $rubrique
+ * @param string $ongletCourant
+ */
 function barre_onglets($rubrique, $ongletCourant, $class="barre_onglet"){
 	include_spip('inc/presentation');
 

ecrire/inc/config.php

Doc Comments +1 added lines, -1 removed lines

@@ -135,7 +135,7 @@
  * @param string $cfg
  * @param mixed $def
  * @param bool $unserialize
- * @return mixed
+ * @return string
  */
 function lire_config_metapack_dist($cfg='', $def=null, $unserialize=true) {
 	return lire_config($cfg, $def, $unserialize);

ecrire/inc/distant.php

Doc Comments +12 added lines

@@ -110,6 +110,9 @@ 
 }
 
 // http://doc.spip.org/@prepare_donnees_post
+/**
+ * @param string $donnees
+ */
 function prepare_donnees_post($donnees, $boundary = '') {
 
 	// permettre a la fonction qui a demande le post de formater elle meme ses donnees
@@ -211,6 +214,9 @@ 
 //   dans lequel on ecrit directement la page
 // * si c'est true/null ca correspond a une demande d'encodage/charset
 // http://doc.spip.org/@recuperer_page
+/**
+ * @param integer $taille_max
+ */
 function recuperer_page($url, $trans = false, $get_headers = false,
                         $taille_max = null, $datas = '', $boundary = '', $refuser_gz = false,
                         $date_verif = '', $uri_referer = ''){
@@ -655,6 +661,9 @@ 
 // retourne le descripteur sur lequel lire la reponse
 //
 // http://doc.spip.org/@init_http
+/**
+ * @param string $method
+ */
 function init_http($method, $url, $refuse_gz = false, $referer = '', $datas = "", $vers = "HTTP/1.0", $date = ''){
 	$user = $via_proxy = $proxy_user = '';
 	$fopen = false;
@@ -699,6 +708,9 @@ 
 }
 
 // http://doc.spip.org/@lance_requete
+/**
+ * @param string $noproxy
+ */
 function lance_requete($method, $scheme, $user, $host, $path, $port, $noproxy, $refuse_gz = false, $referer = '', $datas = "", $vers = "HTTP/1.0", $date = ''){
 
 	$proxy_user = '';