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

Doc Comments +11 added lines

@@ -62,6 +62,11 @@ 
 }
 
 // http://doc.spip.org/@sous_menu_rubriques
+/**
+ * @param integer $root
+ * @param integer $niv
+ * @param integer $exclus
+ */
 function sous_menu_rubriques($id_rubrique, $root, $niv, &$data, &$enfants, $exclus, $restreint, $type) {
 	static $decalage_secteur;
 
@@ -206,6 +211,12 @@ 
 // getElement en mode Ajax est trop couteux).
 
 // http://doc.spip.org/@construire_selecteur
+/**
+ * @param string $url
+ * @param string $js
+ * @param string $idom
+ * @param string $name
+ */
 function construire_selecteur($url, $js, $idom, $name, $init='', $id=0)
 {
 	$icone = (strpos($idom, 'auteur')!==false) ? 'auteur-24.png' : 'rechercher-20.png';

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);