spip / SPIP

ecrire/xml/sax.php

Doc Comments +9 added lines

@@ -102,6 +102,9 @@ 
 		: xml_entites_html($data);
 }
 
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_piElement($phraseur, $target, $data) {
 	$depth = $phraseur->depth;
 
@@ -118,6 +121,9 @@ 
 
 
 // http://code.spip.net/@xml_defautElement
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_defaultElement($phraseur, $data) {
 	$depth = $phraseur->depth;
 
@@ -149,6 +155,9 @@ 
 }
 
 // http://code.spip.net/@coordonnees_erreur
+/**
+ * @param string $msg
+ */
 function coordonnees_erreur($phraseur, $msg) {
 	$entete_length = substr_count($phraseur->entete, "\n");
 	$phraseur->err[] = array(

ecrire/inc/securiser_action.php

Doc Comments +1 added lines

@@ -304,6 +304,7 @@
  * @param string $url Url à autoriser en prévisu
  * @param int|null id_auteur qui génère le token de prévisu. Null utilisera auteur courant.
  * @param string $alea Nom de l’alea à utiliser
+ * @param integer $id_auteur
  * @return string Token, de la forme "{id}*{hash}"
  */
 function calculer_token_previsu($url, $id_auteur = null, $alea = 'alea_ephemere') {

ecrire/public/quete.php

Doc Comments +5 added lines, -5 removed lines

@@ -28,9 +28,9 @@ 
 /**
  * Retourne l'URL de redirection d'un article virtuel, seulement si il est publié
  *
- * @param $id_article
- * @param $connect
- * @return array|bool|null
+ * @param integer $id_article
+ * @param string $connect
+ * @return string
  */
 function quete_virtuel($id_article, $connect) {
 	return sql_getfetsel(
@@ -122,7 +122,7 @@ 
  * @uses quete_parent_lang()
  *
  * @param int $id_article
- * @param $serveur
+ * @param string $serveur
  * @return int
  */
 function quete_rubrique($id_article, $serveur) {
@@ -293,7 +293,7 @@ 
  *
  * @param int $id_document
  * @param string $serveur
- * @return array|bool|null
+ * @return string
  */
 function quete_fichier($id_document, $serveur = '') {
 	return sql_getfetsel('fichier', 'spip_documents', ('id_document=' . intval($id_document)), '', array(), '', '', $serveur);

ecrire/inc/lien.php

Doc Comments +13 added lines, -1 removed lines

@@ -42,6 +42,9 @@ 
 define('_RACCOURCI_LIEN', "/\[([^][]*?([[]\w*[]][^][]*)*)->(>?)([^]]*)\]/msS");
 
 // http://code.spip.net/@expanser_liens
+/**
+ * @return string
+ */
 function expanser_liens($t, $connect = '', $env = array()) {
 
 	$t = pipeline('pre_liens', $t);
@@ -56,6 +59,9 @@ 
 // Meme analyse mais pour eliminer les liens
 // et ne laisser que leur titre, a expliciter si ce n'est fait
 // http://code.spip.net/@nettoyer_raccourcis_typo
+/**
+ * @param string $texte
+ */
 function nettoyer_raccourcis_typo($texte, $connect = '') {
 	return $texte;
 }
@@ -96,6 +102,9 @@ 
 // 'url':   seulement U  (i.e. generer_url_RACCOURCI)
 
 // http://code.spip.net/@calculer_url
+/**
+ * @return string
+ */
 function calculer_url($ref, $texte = '', $pour = 'url', $connect = '', $echappe_typo = true) {
 	$r = traiter_lien_implicite($ref, $texte, $pour, $connect, $echappe_typo);
 
@@ -256,7 +265,7 @@ 
  * @param int $id Identifiant de l'objet
  * @param string $type Type d'objet
  * @param string|null $connect Connecteur SQL utilisé
- * @return array {
+ * @return string {
  * @var string $titre Titre si présent, sinon ''
  * @var string $lang Langue si présente, sinon ''
  * }
@@ -302,6 +311,9 @@ 
 define('_RACCOURCI_MODELE_DEBUT', '@^' . _RACCOURCI_MODELE . '@isS');
 
 // http://code.spip.net/@traiter_modeles
+/**
+ * @return string
+ */
 function traiter_modeles($texte, $doublons = false, $echap = '', $connect = '', $liens = null, $env = array()) {
 	// preserver la compatibilite : true = recherche des documents
 	if ($doublons === true) {

ecrire/req/sqlite_fonctions.php

Doc Comments +1 added lines, -1 removed lines

@@ -33,7 +33,7 @@
  * @link http://www.sqlite.org/lang_corefunc.html Liste des fonctions natives
  * @link http://sqlite.org/changes.html Liste des évolutions
  * 
- * @param PDO|resource $sqlite Représente la connexion Sqlite
+ * @param PDO $sqlite Représente la connexion Sqlite
  * @return false|void
  */
 function _sqlite_init_functions(&$sqlite) {

ecrire/req/sqlite_generique.php

Doc Comments +6 added lines, -6 removed lines

@@ -1528,8 +1528,8 @@ 
  * @param string|array $select Champs sélectionnés
  * @param string|array $from Tables sélectionnées
  * @param string|array $where Contraintes
- * @param string|array $groupby Regroupements
- * @param string|array $orderby Tris
+ * @param string $groupby Regroupements
+ * @param string $orderby Tris
  * @param string $limit Limites de résultats
  * @param string|array $having Contraintes posts sélections
  * @param string $serveur Nom de la connexion
@@ -1687,7 +1687,7 @@ 
  * @param string $nom_table Nom de la table SQL
  * @param string $serveur Nom de la connexion
  * @param bool $requeter Exécuter la requête, sinon la retourner
- * @return array|string
+ * @return string
  *     - chaîne vide si pas de description obtenue
  *     - string Texte de la requête si demandé
  *     - array description de la table sinon
@@ -2194,7 +2194,7 @@ 
  * 4) Renommer la table B en A
  * 5) Remettre les index (qui sont supprimés avec la table A)
  *
- * @param string|array $table
+ * @param string $table
  *     - string : Nom de la table table,
  *     - array : couple (nom de la table => nom futur)
  * @param string|array $colonne
@@ -2597,7 +2597,7 @@ 
  * stocke le resultat pour ne pas faire
  * de requetes showtable intempestives
  *
- * @param  $table
+ * @param  string $table
  * @param  $couples
  * @param string $desc
  * @param string $serveur
@@ -2789,7 +2789,7 @@ 
 	 * Constructeur
 	 *
 	 * @param string $serveur
-	 * @return bool
+	 * @return false|null
 	 */
 	public function __construct($serveur = '') {
 		_sqlite_init();

ecrire/inc/filtres_mini.php

Doc Comments +1 added lines, -1 removed lines

@@ -147,7 +147,7 @@
 /**
  * Verifier qu'une url est absolue et que son protocole est bien parmi une liste autorisee
  * @param string $url_absolue
- * @param array $protocoles_autorises
+ * @param string[] $protocoles_autorises
  * @return bool
  */
 function protocole_verifier($url_absolue, $protocoles_autorises = array('http','https')) {

ecrire/inc/utils.php

Doc Comments +14 added lines, -5 removed lines

@@ -946,6 +946,9 @@ 
 // Renvoie False si un fichier n'est pas plus vieux que $duree secondes,
 // sinon renvoie True et le date sauf si ca n'est pas souhaite
 // http://code.spip.net/@spip_touch
+/**
+ * @param string $fichier
+ */
 function spip_touch($fichier, $duree = 0, $touch = true) {
 	if ($duree) {
 		clearstatcache();
@@ -1023,7 +1026,7 @@ 
  * @param string $description
  *     Une description humainement compréhensible de ce que fait la tâche
  *     (essentiellement pour l’affichage dans la page de suivi de l’espace privé)
- * @param array $arguments
+ * @param integer[] $arguments
  *     Facultatif, vide par défaut : les arguments qui seront passés à la fonction, sous forme de tableau PHP
  * @param string $file
  *     Facultatif, vide par défaut : nom du fichier à inclure, via `include_spip($file)`
@@ -1062,7 +1065,7 @@ 
  *
  * @param int $id_job
  *  id of jonb to delete
- * @return bool
+ * @return boolean|string
  */
 function job_queue_remove($id_job) {
 	include_spip('inc/queue');
@@ -1378,6 +1381,9 @@ 
 	return $themes;
 }
 
+/**
+ * @return string
+ */
 function find_in_theme($file, $subdir = '', $include = false) {
 	static $themefiles = array();
 	if (isset($themefiles["$subdir$file"])) {
@@ -1792,6 +1798,9 @@ 
 }
 
 // http://code.spip.net/@generer_url_entite_absolue
+/**
+ * @param boolean|string $connect
+ */
 function generer_url_entite_absolue($id = '', $entite = '', $args = '', $ancre = '', $connect = null) {
 	if (!$connect) {
 		$connect = true;
@@ -2049,7 +2058,7 @@ 
  *
  * @param string $script
  *     Nom de la page
- * @param string|array $args
+ * @param string $args
  *     Arguments à transmettre a l'URL,
  *      soit sous la forme d'un string tel que `arg1=yy&arg2=zz`
  *      soit sous la forme d'un array tel que array( `arg1` => `yy`, `arg2` => `zz` )
@@ -3224,7 +3233,7 @@ 
 /**
  * Trouve un squelette dans le repertoire modeles/
  *
- * @param  $nom
+ * @param  string $nom
  * @return string
  */
 function trouve_modele($nom) {
@@ -3397,7 +3406,7 @@ 
 		 *
 		 * @param array $input A multi-dimensional array (record set) from which to pull
 		 *                     a column of values.
-		 * @param mixed $columnKey The column of values to return. This value may be the
+		 * @param string $columnKey The column of values to return. This value may be the
 		 *                         integer key of the column you wish to retrieve, or it
 		 *                         may be the string key name for an associative array.
 		 * @param mixed $indexKey (Optional.) The column to use as the index/keys for

ecrire/inc/documents.php

Doc Comments +4 added lines, -4 removed lines

@@ -43,7 +43,7 @@ 
  * @uses _DIR_IMG
  *
  * @param string $fichier
- * @return bool|string
+ * @return string|false
  */
 function get_spip_doc($fichier) {
 	// fichier distant
@@ -125,7 +125,7 @@ 
  * @param string $ext
  * @param string $orig
  * @param string $source
- * @return bool|mixed|string
+ * @return string|false
  */
 function copier_document($ext, $orig, $source) {
 
@@ -162,7 +162,7 @@ 
  * @uses sous_repertoire()
  *
  * @param string $type
- * @return bool|string
+ * @return string
  */
 function determine_upload($type = '') {
 	if (!function_exists('autoriser')) {
@@ -202,7 +202,7 @@ 
  * @param bool $move
  *     - `true` : on déplace le fichier source vers le fichier de destination
  *     - `false` : valeur par défaut. On ne fait que copier le fichier source vers la destination.
- * @return bool|mixed|string
+ * @return string|false
  */
 function deplacer_fichier_upload($source, $dest, $move = false) {
 	// Securite