diff --git a/htdocs/lib/files.lib.php b/htdocs/lib/files.lib.php
index b927bfe51d1..5a4f96918fe 100644
--- a/htdocs/lib/files.lib.php
+++ b/htdocs/lib/files.lib.php
@@ -766,10 +766,11 @@ function dol_delete_preview($object)
 /**
  * Get and save an upload file (for example after submitting a new file a mail form).
  * All information used are in db, conf, langs, user and _FILES.
- * @param	upload_dir				Directory to store upload files
- * @param	allowoverwrite			1=Allow overwrite existing file
- * @param	donotupdatesession		1=Do no edit _SESSION variable
- * @return	string					Message with result of upload and store.
+ * 
+ * @param	string	$upload_dir				Directory to store upload files
+ * @param	int		$allowoverwrite			1=Allow overwrite existing file
+ * @param	int		$donotupdatesession		1=Do no edit _SESSION variable
+ * @return	string							Message with result of upload and store.
  */
 function dol_add_file_process($upload_dir,$allowoverwrite=0,$donotupdatesession=0)
 {
diff --git a/htdocs/lib/functions.lib.php b/htdocs/lib/functions.lib.php
index 073eeff58dd..63e0a37dadb 100644
--- a/htdocs/lib/functions.lib.php
+++ b/htdocs/lib/functions.lib.php
@@ -3349,10 +3349,10 @@ function create_exdir($dir)
 }
 
 /**
- *	Creation of a directory (recursive)
+ *	Creation of a directory (this can create recursive subdir)
  *
- *	@param      $dir        Directory to create
- *	@return     int         < 0 if KO, 0 = already exists, > 0 if OK
+ *	@param	string	$dir	Directory to create (Separator must be '/'. Example: '/mydir/mysubdir')
+ *	@return int         	< 0 if KO, 0 = already exists, > 0 if OK
  */
 function dol_mkdir($dir)
 {