spip / SPIP

ecrire/inc/acces.php

Doc Comments +3 added lines

@@ -199,6 +199,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

@@ -30,6 +30,9 @@ 
 }
 
 // http://doc.spip.org/@redirige_action_post
+/**
+ * @return string
+ */
 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'");
@@ -41,6 +44,9 @@ 
 // d'attribut  id = $action-$id (cf. AjaxSqueeze dans layer.js)
 
 // http://doc.spip.org/@ajax_action_auteur
+/**
+ * @param string $action
+ */
 function ajax_action_auteur($action, $id, $script, $args='', $corps=false, $args_ajax='', $fct_ajax='')
 {
 	if (strpos($args,"#")===FALSE)
@@ -109,6 +115,9 @@ 
 // Comme ci-dessus, mais reduit au cas POST et on fournit le bouton Submit.
 // 
 // http://doc.spip.org/@ajax_action_post
+/**
+ * @param string $action
+ */
 function ajax_action_post($action, $arg, $retour, $gra, $corps, $clic='', $atts_i='', $atts_span = "", $args_ajax='', $fct_ajax='')
 {
 	global $spip_lang_right;
@@ -187,6 +196,9 @@ 
 // $fonction : denomination semantique du bloc, que l'on retouve en attribut class
 // $id : id de l'objet concerne si il y a lieu ou "", sert a construire un identifiant unique au bloc ("fonction-id")
 // http://doc.spip.org/@ajax_action_greffe
+/**
+ * @param string $fonction
+ */
 function ajax_action_greffe($fonction, $id, $corps)
 {
 	$idom = $fonction.(strlen($id)?"-$id":"");

ecrire/inc/admin.php

Doc Comments +3 added lines

@@ -167,6 +167,9 @@
 }
 
 // http://doc.spip.org/@copy_request
+/**
+ * @param string $suite
+ */
 function copy_request($script, $suite, $submit='')
 {
         include_spip('inc/filtres');

ecrire/inc/agenda.php

Doc Comments +64 added lines

@@ -48,6 +48,9 @@ 
 /// Pas si simple: certains param ne sont pas remplaces 
 /// et doivent reprendre leur valeur par defaut -- esj.
 /// http://doc.spip.org/@calendrier_retire_args_ancre
+/**
+ * @param string $script
+ */
 function calendrier_retire_args_ancre($script)
 {
 
@@ -78,6 +81,9 @@ 
 /// on peut definir generer_url_date et un htacces pour simplifier les URL
 
 // http://doc.spip.org/@calendrier_args_date
+/**
+ * @param string $finurl
+ */
 function calendrier_args_date($script, $annee, $mois, $jour, $type, $finurl) {
 	if (function_exists('generer_url_date'))
 		return generer_url_date($script, $annee, $mois, $jour, $type, $finurl);
@@ -89,6 +95,9 @@ 
 	return $script . $finurl;
 }
 
+/**
+ * @param integer $time
+ */
 function calendrier_args_time($time, $script, $type, $fin='')
 {
 	if (!is_numeric($time)) $time = strtotime($time);
@@ -381,6 +390,9 @@ 
 /// Appelle la fonction precedente en sachant que ca produira 1 TD/TR unique.
 /// retourne le contenu du TD
 
+/**
+ * @param string $finurl
+ */
 function http_calendrier_sept_un($annee, $mois, $jour,$evenements, $script, $finurl, $ancre='', $class='', $att='')
 {
 	$res = http_calendrier_mois_sept($annee, $mois, $jour, $jour,$evenements, $script, $finurl, $ancre);
@@ -391,6 +403,12 @@ 
 
 /// typo pour l'espace public
 // http://doc.spip.org/@http_calendrier_mois_clics
+/**
+ * @param string $annee
+ * @param string $mois
+ * @param string $jour
+ * @param string $ancre
+ */
 function http_calendrier_mois_clics($annee, $mois, $jour, $script, $finurl, $ancre)
 {
 	$d = mktime(0,0,0,$mois, $jour, $annee);
@@ -484,6 +502,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_semaine_noms
+/**
+ * @param string $finurl
+ */
 function http_calendrier_semaine_noms($annee, $mois, $jour, $script, $finurl, $ancre){
 
 	$bandeau = '';
@@ -553,6 +574,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_jour_noms
+/**
+ * @param double $jour
+ */
 function http_calendrier_jour_noms($annee, $mois, $jour, $echelle, $partie_cal, $script, $ancre){
 
 	global $spip_ecran;
@@ -576,6 +600,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_jour_sept
+/**
+ * @param double $jour
+ */
 function http_calendrier_jour_sept($annee, $mois, $jour, $echelle,  $partie_cal, $script, $ancre, $evt){
 	global $spip_ecran;
 
@@ -613,6 +640,9 @@ 
 /// a travers la globale calendrier_partie ou sous la forme D_F
 
 // http://doc.spip.org/@http_calendrier_ics
+/**
+ * @param integer $largeur
+ */
 function http_calendrier_ics($annee, $mois, $jour, $echelle, $partie_cal, $largeur, $evt, $style='', $class='') {
 	global $spip_lang_left;
 
@@ -647,6 +677,12 @@ 
 	  $sansheure;
 }
 
+/**
+ * @param string $date
+ * @param double $dimheure
+ * @param double $dimjour
+ * @param double $padding
+ */
 function http_calendrier_ics_div($evts, $date, $debut, $fin, $dimheure, $dimjour, $echelle, $largeur, $padding)
 {
 	global $spip_lang_left;
@@ -752,6 +788,10 @@ 
 /// Selon l'echelle demandee, on affiche heure, 1/2 heure 1/4 heure, 5minutes.
 
 // http://doc.spip.org/@http_calendrier_ics_grille
+/**
+ * @param double $dimheure
+ * @param double $dimjour
+ */
 function http_calendrier_ics_grille($debut, $fin, $dimheure, $dimjour, $echelle)
 {
 	global $spip_lang_left, $spip_lang_right;
@@ -787,6 +827,11 @@ 
 /// se placent a cote des autres, sinon en dessous
 
 // http://doc.spip.org/@http_calendrier_ics_trois
+/**
+ * @param double $dimjour
+ * @param double $echelle
+ * @param string $border
+ */
 function http_calendrier_ics_trois($evt, $largeur, $dimjour, $echelle, $border)
 {
 	global $spip_lang_left; 
@@ -858,6 +903,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_avec_heure
+/**
+ * @param string $amj
+ */
 function http_calendrier_avec_heure($evenement, $amj)
 {
 	$jour_debut = substr($evenement['DTSTART'], 0,8);
@@ -1007,6 +1055,9 @@ 
 /// et le $nom du calendrier
 
 // http://doc.spip.org/@http_calendrier_navigation
+/**
+ * @param string $type
+ */
 function http_calendrier_navigation($annee, $mois, $jour, $echelle, $partie_cal, $nom, $script, $args_pred, $args_suiv, $type, $ancre)
 {
 	global $spip_lang_right, $spip_lang_left;
@@ -1163,6 +1214,9 @@ 
 /// typographie un mois sous forme d'un tableau de 7 colonnes
 
 // http://doc.spip.org/@http_calendrier_agenda_rv
+/**
+ * @param string $fclic
+ */
 function http_calendrier_agenda_rv ($annee, $mois, $les_rv, $fclic,
 				    $script='', $ancre='',
 				    $jour_ved='', $mois_ved='', $annee_ved='',
@@ -1261,6 +1315,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_rv
+/**
+ * @param string $type
+ */
 function http_calendrier_rv($messages, $type) {
 
 	$total = $date_rv = '';
@@ -1324,6 +1381,10 @@ 
 }
 
 // http://doc.spip.org/@calendrier_categories
+/**
+ * @param string $table
+ * @param string $objet
+ */
 function calendrier_categories($table, $num, $objet)
 {
   if (function_exists('generer_calendrier_class'))
@@ -1337,6 +1398,9 @@ 
 }
 
 // http://doc.spip.org/@http_calendrier_ics_message
+/**
+ * @param boolean $large
+ */
 function http_calendrier_ics_message($annee, $mois, $jour, $large)
 {	
 

ecrire/inc/aider.php

Doc Comments +3 added lines

@@ -66,6 +66,9 @@
 	return aider_icone(generer_url_ecrire("aide_index", $args));
 }
 
+/**
+ * @param string $url
+ */
 function aider_icone($url, $clic= '')
 {
 	global $spip_lang, $spip_lang_rtl;

ecrire/inc/ajouter_documents.php

Doc Comments +8 added lines

@@ -464,6 +464,9 @@ 
 // A noter : une extension 'pdf ' passe dans la requete de controle
 // mysql> SELECT * FROM spip_types_documents WHERE extension="pdf ";
 // http://doc.spip.org/@corriger_extension
+/**
+ * @param string $ext
+ */
 function corriger_extension($ext) {
 	$ext = preg_replace(',[^a-z0-9],i', '', $ext);
 	switch ($ext) {
@@ -510,6 +513,11 @@ 
 // Passer ca en squelette un de ces jours.
 
 // http://doc.spip.org/@liste_archive_jointe
+/**
+ * @param string $hash
+ * @param string $redirect
+ * @param string $iframe_redirect
+ */
 function liste_archive_jointe($valables, $zip, $type, $id, $mode, $id_document, $hash, $redirect, $iframe_redirect)
 {
 	include_spip('inc/layer');

ecrire/inc/article_select.php

Doc Comments +3 added lines

@@ -93,6 +93,9 @@
 // on initialise les donnees de maniere specifique
 //
 // http://doc.spip.org/@article_select_trad
+/**
+ * @param integer $lier_trad
+ */
 function article_select_trad($lier_trad, $id_rubrique=0) {
 	// Recuperer les donnees de l'article original
 	$row = sql_fetsel("*", "spip_articles", "id_article=$lier_trad");

ecrire/inc/auth.php

Doc Comments +7 added lines

@@ -300,6 +300,9 @@ 
 }
 
 // http://doc.spip.org/@auth_trace
+/**
+ * @param string $date
+ */
 function auth_trace($row, $date=null)
 {
 	// Indiquer la connexion. A la minute pres ca suffit.
@@ -454,6 +457,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/autoriser.php

Doc Comments +8 added lines

@@ -122,6 +122,10 @@ 
 // une globale pour aller au plus vite dans la fonction generique ci dessus
 $GLOBALS['autoriser_exception']=array();
 // http://doc.spip.org/@autoriser_exception
+/**
+ * @param string $type
+ * @param integer $id
+ */
 function autoriser_exception($faire,$type,$id,$autoriser=true){
 	// une static innaccessible par url pour verifier que la globale est positionnee a bon escient
 	static $autorisation;
@@ -709,6 +713,10 @@ 
 }
 
 // http://doc.spip.org/@autoriser_rubrique_editermots_dist
+/**
+ * @param string $quoi
+ * @param integer $id
+ */
 function autoriser_rubrique_editermots_dist($faire,$quoi,$id,$qui,$opts){
 	// on recupere les champs du groupe s'ils ne sont pas passes en opt
 	if (!isset($opts['groupe_champs'])){