spip / SPIP

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