spip / SPIP

ecrire/inc/texte.php

Doc Comments +2 added lines, -2 removed lines

@@ -31,7 +31,7 @@ 
 /**
  * Raccourcis dépendant du sens de la langue
  *
- * @return array Tablea ('','')
+ * @return string[] Tablea ('','')
  */
 function definir_raccourcis_alineas() {
 	return array('', '');
@@ -354,7 +354,7 @@ 
  * Ne fait rien ici. Voir plugin Textwheel
  *
  * @param string $letexte
- * @param null $forcer
+ * @param boolean|null $forcer
  * @return string
  */
 function paragrapher($letexte, $forcer = true) {

ecrire/inc/xml.php

Doc Comments +1 added lines, -1 removed lines

@@ -245,7 +245,7 @@
  * @param array $matches
  *     Branches de l'arbre validant la rexgep
  * @param bool $init ?
- * @return bool
+ * @return integer
  *     false si aucun élément ne valide l'expression régulière, true sinon.
  **/
 function spip_xml_match_nodes($regexp, &$arbre, &$matches, $init = true) {

ecrire/install/etape_3.php

Doc Comments +3 added lines

@@ -235,6 +235,9 @@
 
 
 // http://code.spip.net/@install_premier_auteur
+/**
+ * @param string $hidden
+ */
 function install_premier_auteur($email, $login, $nom, $pass, $hidden, $auteur_obligatoire) {
 	return info_progression_etape(3, 'etape_', 'install/') .
 	info_etape(

ecrire/iterateur/data.php

Doc Comments +3 added lines, -3 removed lines

@@ -133,7 +133,7 @@ 
 	/**
 	 * Déclarer les critères exceptions
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public function exception_des_criteres() {
 		return array('tableau');
@@ -787,7 +787,7 @@ 
  * pour la syntaxe cf la fonction spip preg_files
  *
  * @param string $dir
- * @param string $regexp
+ * @param integer $regexp
  * @param int $limit
  * @return array|bool
  */
@@ -826,7 +826,7 @@ 
 /**
  * Object -> tableau
  *
- * @param Object $object
+ * @param SimpleXMLIterator $object
  * @return array|bool
  */
 function XMLObjectToArray($object) {

ecrire/plugins/afficher_plugin.php

Doc Comments +7 added lines

@@ -121,6 +121,10 @@ 
 // checkbox pour activer ou desactiver
 // si ce n'est pas une extension
 
+/**
+ * @param integer $id_input
+ * @param string $file
+ */
 function plugin_checkbox($id_input, $file, $actif) {
 	$name = substr(md5($file), 0, 16);
 
@@ -185,6 +189,9 @@ 
 	. "</div>";
 }
 
+/**
+ * @param string $nom
+ */
 function plugin_desintalle($plug_file, $nom, $dir_plugins = null) {
 	if (!$dir_plugins) {
 		$dir_plugins = _DIR_PLUGINS;

ecrire/plugins/afficher_repertoires.php

Doc Comments +8 added lines

@@ -75,11 +75,19 @@
 // vraiment n'importe quoi la gestion des chemins des plugins
 // une fonction pour aider...
 // http://code.spip.net/@chemin_plug
+/**
+ * @param string $racine
+ *
+ * @return string
+ */
 function chemin_plug($racine, $plug) {
 	return preg_replace(',[^/]+/\.\./,', '', "$racine/$plug");
 }
 
 // http://code.spip.net/@tree_open_close_dir
+/**
+ * @param string $target
+ */
 function tree_open_close_dir(&$current, $target, $deplie = array()) {
 	if ($current == $target) {
 		return "";

ecrire/public/aiguiller.php

Doc Comments +3 added lines

@@ -14,6 +14,9 @@
 	return;
 }
 
+/**
+ * @return string|null
+ */
 function securiser_redirect_action($redirect) {
 	if ((tester_url_absolue($redirect) or preg_match(',^\w+:,',trim($redirect)))
 		and !defined('_AUTORISER_ACTION_ABS_REDIRECT')) {

ecrire/public/compiler.php

Doc Comments +14 added lines, -1 removed lines

@@ -59,6 +59,10 @@ 
 
 
 // http://code.spip.net/@argumenter_inclure
+/**
+ * @param boolean $rejet_filtres
+ * @param string $id_boucle
+ */
 function argumenter_inclure(
 	$params,
 	$rejet_filtres,
@@ -747,7 +751,7 @@ 
  *    Nom de la commande
  * @param string $val
  *    Code PHP décrivant la valeur à affecter
- * @return array
+ * @return string[]
  *
  *    - index 0 : Code pour une affectation statique. Si non rempli, la propriété devra
  *                être ré-affectée à chaque appel de la boucle.
@@ -855,6 +859,9 @@ 
 }
 
 // http://code.spip.net/@calculer_order
+/**
+ * @param Boucle $boucle
+ */
 function calculer_order(&$boucle) {
 	if (!$order = $boucle->order
 		and !$order = $boucle->default_order
@@ -924,6 +931,9 @@ 
 define('_REGEXP_CONCAT_NON_VIDE', "/^(.*)[.]\s*'[^']+'\s*$/");
 
 // http://code.spip.net/@compile_cas
+/**
+ * @param string $id_boucle
+ */
 function compile_cas($tableau, $descr, &$boucles, $id_boucle) {
 
 	$codes = array();
@@ -1113,6 +1123,9 @@ 
 // de meme si EXP est de la forme (t ? '' : 'C')
 
 // http://code.spip.net/@compile_retour
+/**
+ * @param string $tab
+ */
 function compile_retour($code, $avant, $apres, $altern, $tab, $n) {
 	if ($avant == "''") {
 		$avant = '';

ecrire/public/composer.php

Doc Comments +7 added lines

@@ -133,6 +133,10 @@ 
 	return $nom ? $nom : false;
 }
 
+/**
+ * @param string $squelette
+ * @param string $phpfile
+ */
 function squelette_traduit($squelette, $sourcefile, $phpfile, $boucles) {
 
 	// Le dernier index est '' (fonction principale)
@@ -157,6 +161,9 @@ 
 
 // Le squelette compile est-il trop vieux ?
 // http://code.spip.net/@squelette_obsolete
+/**
+ * @param string $skel
+ */
 function squelette_obsolete($skel, $squelette) {
 	static $date_change = null;
 	// ne verifier la date de mes_fonctions et mes_options qu'une seule fois