spip / SPIP

ecrire/inc/pclzip.php

Doc Comments +26 added lines

@@ -268,6 +268,10 @@ 
   //   The list of the added files, with a status of the add action.
   //   (see PclZip::listContent() for list entry format)
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_filelist
+   */
   function create($p_filelist)
   {
     $v_result=1;
@@ -2335,6 +2339,10 @@ 
   // Description :
   // Parameters :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_mode
+   */
   function privOpenFd($p_mode)
   {
     $v_result=1;
@@ -4151,6 +4159,10 @@ 
   // Parameters :
   // Return Values :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_string
+   */
   function privExtractFileAsString(&$p_entry, &$p_string, &$p_options)
   {
     $v_result=1;
@@ -5044,6 +5056,10 @@ 
   // Parameters :
   // Return Values :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param PclZip $p_archive_to_add
+   */
   function privMerge(&$p_archive_to_add)
   {
     $v_result=1;
@@ -5551,6 +5567,11 @@ 
   //             3 : src & dest gzip
   // Return Values :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param integer $p_src
+   * @param integer $p_dest
+   */
   function PclZipUtilCopyBlock($p_src, $p_dest, $p_size, $p_mode=0)
   {
     $v_result = 1;
@@ -5613,6 +5634,11 @@ 
   // Return Values :
   //   1 on success, 0 on failure.
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_src
+   * @param string $p_dest
+   */
   function PclZipUtilRename($p_src, $p_dest)
   {
     $v_result = 1;

ecrire/inc/plugin.php

Doc Comments +18 added lines

@@ -21,6 +21,9 @@ 
 // besoin de inc_meta
 include_spip('inc/texte');
 
+/**
+ * @param string $op
+ */
 function spip_version_compare($v1,$v2,$op){
 	$v1 = strtolower(preg_replace(',([0-9])[\s-.]?(dev|alpha|a|beta|b|rc|pl|p),i','\\1.\\2',$v1));
 	$v2 = strtolower(preg_replace(',([0-9])[\s-.]?(dev|alpha|a|beta|b|rc|pl|p),i','\\1.\\2',$v2));
@@ -42,6 +45,9 @@ 
 // $dir_plugins pour forcer un repertoire (ex: _DIR_EXTENSIONS)
 // _DIR_PLUGINS_SUPPL pour aller en chercher ailleurs (separes par des ":")
 // http://doc.spip.org/@liste_plugin_files
+/**
+ * @param string $dir_plugins
+ */
 function liste_plugin_files($dir_plugins = null){
 	static $plugin_files=array();
 
@@ -307,6 +313,9 @@ 
  * @return unknown
  */
 // http://doc.spip.org/@liste_chemin_plugin_actifs
+/**
+ * @param string $dir_plugins
+ */
 function liste_chemin_plugin_actifs($dir_plugins=_DIR_PLUGINS){
 	$liste = liste_plugin_actifs();
 	foreach ($liste as $prefix=>$infos) {
@@ -368,6 +377,9 @@ 
     return $plugin_s;
 }
 
+/**
+ * @param boolean $pipe_recherche
+ */
 function ecrire_plugin_actifs2($plugin_valides, $ordre, $infos, $pipe_recherche)
 {	
 	static $liste_pipe_manquants=array();
@@ -584,6 +596,9 @@ 
 	return $liste_fichier_verif;
 }
 
+/**
+ * @param string $nom
+ */
 function ecrire_fichier_actif($nom, $corps)
 {
     $corps = '<'."?php\nif (defined('_ECRIRE_INC_VERSION')) {\n$corps}\n?".'>';
@@ -609,6 +624,9 @@ 
 }
 
 // http://doc.spip.org/@spip_plugin_install
+/**
+ * @param string $action
+ */
 function spip_plugin_install($action, $infos){
 	$prefix = $infos['prefix'];
 	$version_cible = $infos['version_base'];

ecrire/inc/presentation.php

Doc Comments +18 added lines

@@ -22,6 +22,9 @@ 
 define('_INTERFACE_ONGLETS', false);
 
 // http://doc.spip.org/@echo_log
+/**
+ * @param string $f
+ */
 function echo_log($f, $ret) {
 	spip_log("Page " . self() . " function $f: echo ".substr($ret,0,50)."...",'echo');
 	echo
@@ -303,6 +306,9 @@ 
 // Afficher un petit "+" pour lien vers autre page
 
 // http://doc.spip.org/@afficher_plus
+/**
+ * @param string $lien
+ */
 function afficher_plus($lien) {
 	global $spip_lang_right, $spip_display;
 
@@ -367,6 +373,9 @@ 
 }
 
 // http://doc.spip.org/@generer_onclic_ajax
+/**
+ * @param integer $val
+ */
 function generer_onclic_ajax($url, $idom, $val)
 {
 	return "\nonclick=\"return charger_id_url('"
@@ -598,6 +607,9 @@ 
 }
 
 // http://doc.spip.org/@icone
+/**
+ * @param string $fond
+ */
 function icone($texte, $lien, $fond, $fonction="", $align="", $echo=false){
 	$retour = "<div style='padding-top: 20px;width:100px' class='icone36'>" . icone_inline($texte, $lien, $fond, $fonction, $align) . "</div>";
 	if ($echo) echo_log('icone',$retour); else return $retour;
@@ -776,6 +788,9 @@ 
 
 
 // http://doc.spip.org/@formulaire_recherche
+/**
+ * @param string $page
+ */
 function formulaire_recherche($page, $complement=""){
 	$recherche = _request('recherche');
 	$recherche_aff = entites_html($recherche);
@@ -1095,6 +1110,9 @@ 
 
 // Voir en ligne, ou apercu, ou rien (renvoie tout le bloc)
 // http://doc.spip.org/@voir_en_ligne
+/**
+ * @param string $type
+ */
 function voir_en_ligne ($type, $id, $statut=false, $image='racine-24.gif', $af = true, $inline=true) {
 
 	$en_ligne = $message = '';

ecrire/inc/presenter_liste.php

Doc Comments +3 added lines

@@ -119,6 +119,9 @@
 }
 
 // http://doc.spip.org/@affiche_tranche_bandeau
+/**
+ * @param string $idom
+ */
 function affiche_tranche_bandeau(&$requete, $idom, $url='', $cpt=NULL, $pas=10)
 {
 	if (!isset($requete['GROUP BY'])) $requete['GROUP BY'] = '';

ecrire/inc/puce_statut.php

Doc Comments +5 added lines

@@ -364,6 +364,11 @@
 }
 
 // http://doc.spip.org/@afficher_script_statut
+/**
+ * @param integer $n
+ * @param string $img
+ * @param string $statut
+ */
 function afficher_script_statut($id, $type, $n, $img, $statut, $titre, $act='') {
 	$i = http_wrapper($img);
 	$h = generer_action_auteur("instituer_$type","$id-$statut");

ecrire/inc/securiser_action.php

Doc Comments +10 added lines

@@ -36,6 +36,10 @@ 
 // Attention: PHP applique urldecode sur $_GET mais pas sur $_POST
 // cf http://fr.php.net/urldecode#48481
 // http://doc.spip.org/@securiser_action_auteur
+/**
+ * @param string $action
+ * @param string $arg
+ */
 function securiser_action_auteur($action, $arg, $redirect="", $mode=false, $att='', $public=false)
 {
 	static $id_auteur=0, $pass;
@@ -99,6 +103,9 @@ 
 }
 
 // http://doc.spip.org/@_action_auteur
+/**
+ * @param string $alea
+ */
 function _action_auteur($action, $id_auteur, $pass, $alea) {
 	static $sha = array();
 	if (!isset($sha[$id_auteur.$pass.$alea])){
@@ -169,6 +176,9 @@ 
 }
 
 // http://doc.spip.org/@verifier_cle_action
+/**
+ * @param string $action
+ */
 function verifier_cle_action($action, $cle) {
 	return ($cle == calculer_cle_action($action));
 }

ecrire/inc/selectionner.php

Doc Comments +6 added lines

@@ -58,6 +58,12 @@
 }
 
 // http://doc.spip.org/@construire_selectionner_hierarchie
+/**
+ * @param string $idom
+ * @param string|boolean $racine
+ * @param string $url
+ * @param string $name
+ */
 function construire_selectionner_hierarchie($idom, $liste, $racine, $url, $name, $url_init='')
 {
 	global $spip_lang_right;

ecrire/inc/session.php

Doc Comments +9 added lines

@@ -113,6 +113,9 @@ 
 
 // Ajouter une donnee dans la session SPIP
 // http://doc.spip.org/@session_set
+/**
+ * @param string $nom
+ */
 function session_set($nom, $val=null) {
 	// On ajoute la valeur dans la globale
 	$GLOBALS['visiteur_session'][$nom] = $val;
@@ -123,6 +126,9 @@ 
 
 // Lire une valeur dans la session SPIP
 // http://doc.spip.org/@session_get
+/**
+ * @param string $nom
+ */
 function session_get($nom) {
 	return isset($GLOBALS['visiteur_session'][$nom]) ? $GLOBALS['visiteur_session'][$nom] : null;
 }
@@ -291,6 +297,9 @@ 
 // Calcule le nom du fichier session
 //
 // http://doc.spip.org/@fichier_session
+/**
+ * @param string $alea
+ */
 function fichier_session($alea, $tantpis=false) {
 
 	if (!isset($GLOBALS['meta'][$alea])) {

ecrire/inc/statistiques.php

Doc Comments +34 added lines

@@ -13,6 +13,10 @@ 
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
 // http://doc.spip.org/@aff_statistique_visites_popularite
+/**
+ * @param string $serveur
+ * @param integer $liste
+ */
 function aff_statistique_visites_popularite($serveur, $id_article, &$classement, &$liste){
 	// Par popularite
 	$result = sql_select("id_article, titre, popularite, visites", "spip_articles", "statut='publie' AND popularite > 0", "", "popularite DESC",'','',$serveur);
@@ -139,6 +143,10 @@ 
 }
 
 // http://doc.spip.org/@cadre_stat
+/**
+ * @param string[] $stats
+ * @param string $table
+ */
 function cadre_stat($stats, $table, $id_article)
 {
 	if (!$stats) return '';
@@ -149,6 +157,10 @@ 
 }
 
 // http://doc.spip.org/@statistiques_collecte_date
+/**
+ * @param string $count
+ * @param string $table
+ */
 function statistiques_collecte_date($count, $date, $table, $where, $serveur)
 {
 	$result = sql_select("$count AS n, $date AS d", $table, $where, 'd', 'd', '','', $serveur);
@@ -159,6 +171,10 @@ 
 }
 
 // http://doc.spip.org/@statistiques_tous
+/**
+ * @param string $table
+ * @param string $order
+ */
 function statistiques_tous($log, $id_article, $table, $where, $order, $serveur, $duree, $interval, $total, $popularite, $liste='', $classement=array(), $script='')
 {
 	$r = array_keys($log);
@@ -318,6 +334,10 @@ 
 // Presentation graphique
 // (rq: on n'affiche pas le jour courant, c'est a la charge de la prevision)
 // http://doc.spip.org/@stat_log1
+/**
+ * @param double $agreg
+ * @param string $script
+ */
 function stat_log1($log, $agreg, $date_today, $largeur, $rapport, $interval, $script) {
 	$res = '';
 	$rien = http_img_rien($largeur, 1, 'trait_bas', '');
@@ -365,6 +385,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_vides
+/**
+ * @param integer $moyenne
+ */
 function statistiques_vides($prec, $largeur, $rapport, $moyenne, $script)
 {
 	$hauteur_moyenne = round($moyenne*$rapport)-1;
@@ -412,6 +435,11 @@ 
 
 // Dimanche en couleur foncee
 // http://doc.spip.org/@statistiques_jour
+/**
+ * @param double $moyenne
+ * @param double $hauteur
+ * @param boolean $dimanche
+ */
 function statistiques_jour($key, $value, $largeur, $moyenne, $hauteur, $rapport, $dimanche, $script)
 {
 	$hauteur_moyenne = round($moyenne * $rapport) - 1;
@@ -448,6 +476,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_nom_des_mois
+/**
+ * @param double $agreg
+ */
 function statistiques_nom_des_mois($date_debut, $date_today, $largeur, $pas, $agreg)
 {
 	global $spip_lang_left;
@@ -474,6 +505,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_par_mois
+/**
+ * @param string $script
+ */
 function statistiques_par_mois($entrees, $script){
 
 	$maxgraph = maxgraph(max($entrees));