spip / SPIP

ecrire/inc/distant.php

Doc Comments +7 added lines, -7 removed lines

@@ -64,7 +64,7 @@ 
  *   permet de specifier le nom du fichier local (stockage d'un cache par exemple, et non document IMG)
  * @param int $taille_max
  *   taille maxi de la copie local, par defaut _COPIE_LOCALE_MAX_SIZE
- * @return bool|string
+ * @return string|false
  */
 function copie_locale($source, $mode = 'auto', $local = null, $taille_max = null) {
 
@@ -246,7 +246,7 @@ 
  * La fonction PHP idn_to_ascii depend d'un package php5-intl et est rarement disponible
  *
  * @param string $url_idn
- * @return array|string
+ * @return string|boolean
  */
 function url_to_ascii($url_idn) {
 
@@ -642,13 +642,13 @@ 
  *
  * @param string $url
  *     URL de la page à récupérer
- * @param bool|null|string $trans
+ * @param boolean $trans
  *     - chaîne longue : c'est un nom de fichier (nom pour sa copie locale)
  *     - true : demande d'encodage/charset
  *     - null : ne retourner que les headers
  * @param string $get
  *     Type de requête HTTP à faire (HEAD, GET ou POST)
- * @param int|bool $taille_max
+ * @param integer $taille_max
  *     Arrêter le contenu au-delà (0 = seulement les entetes ==> requête HEAD).
  *     Par defaut taille_max = 1Mo.
  * @param string|array $datas
@@ -774,7 +774,7 @@ 
  *
  * @param resource $handle
  * @param int|bool $if_modified_since
- * @return bool|array
+ * @return string
  *   int status
  *   string headers
  *   int last_modified
@@ -1251,9 +1251,9 @@ 
  *   donnees postees
  * @param string $vers
  *   version HTTP
- * @param int|string $date
+ * @param string $date
  *   timestamp pour entente If-Modified-Since
- * @return bool|resource
+ * @return string
  *   false|int si echec
  *   resource socket vers l'url demandee
  */

ecrire/inc/editer.php

Doc Comments +4 added lines, -4 removed lines

@@ -314,7 +314,7 @@ 
  * utile pour les textes > 32ko
  *
  * @param  string $texte
- * @return array
+ * @return string[]
  */
 function coupe_trop_long($texte) {
 	$aider = charger_fonction('aider', 'inc');
@@ -347,7 +347,7 @@ 
  *
  * @param string $texte
  * @param string $att_text
- * @return array
+ * @return string[]
  */
 function editer_texte_recolle($texte, $att_text) {
 	if ((strlen($texte) < 29 * 1024)
@@ -373,8 +373,8 @@ 
 /**
  * auto-renseigner le titre si il n'existe pas
  *
- * @param $champ_titre
- * @param $champs_contenu
+ * @param string $champ_titre
+ * @param string[] $champs_contenu
  * @param int $longueur
  */
 function titre_automatique($champ_titre, $champs_contenu, $longueur = null) {

ecrire/inc/envoyer_mail.php

Doc Comments +1 added lines, -1 removed lines

@@ -187,7 +187,7 @@
  * @param string $to
  * @param string $texte
  * @param string $parts
- * @return array
+ * @return string[]
  */
 function mail_normaliser_headers($headers, $from, $to, $texte, $parts = '') {
 	$charset = $GLOBALS['meta']['charset'];

ecrire/inc/plugin.php

Doc Comments +2 added lines, -2 removed lines

@@ -623,11 +623,11 @@
  * 
  * @param $liste
  *    Liste de description des plugins
- * @param $nom
+ * @param string $nom
  *    Le plugin donc on cherche la presence
  * @param $intervalle
  *    L'éventuelle intervalle de compatibilité de la dépendance. ex: [1.1.0;]
- * @param $balise
+ * @param string $balise
  *    Permet de définir si on teste un utilise ou un nécessite
  * @return string.
  *    Vide si ok,

ecrire/inc/prepare_recherche.php

Doc Comments +1 added lines, -1 removed lines

@@ -165,7 +165,7 @@
  * @param string $primary
  * @param array $rows
  * @param string $serveur
- * @return array
+ * @return string[]
  */
 function generer_select_where_explicites($table, $primary, $rows, $serveur) {
 	# calculer le {id_article IN()} et le {... as points}

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/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/public/iterateur.php

Doc Comments +4 added lines

@@ -457,6 +457,10 @@
 	 * aller a la position $n en parcourant
 	 * un par un tous les elements
 	 */
+
+	/**
+	 * @param integer $n
+	 */
 	private function seek_loop($n) {
 		if ($this->pos > $n) {
 			$this->rewind();