diff --git a/base/medias.php b/base/medias.php
index 8090501fa1f3f1b19b1574b9ac547328761a1644..30354f1d496895a280f2d4dd06f4f6de62645030 100644
--- a/base/medias.php
+++ b/base/medias.php
@@ -10,10 +10,16 @@
  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
 \***************************************************************************/
 
+/**
+ * Déclarations relatives à la base de données
+ *
+ * @package SPIP\Medias\Pipelines
+**/
+
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
 /**
- * Interfaces des tables breves pour le compilateur
+ * Interfaces des tables documents pour le compilateur
  *
  * @param array $interfaces
  * @return array
@@ -183,9 +189,8 @@ function medias_declarer_tables_objets_sql($tables){
 /**
  * Creer la table des types de document
  *
- * http://doc.spip.org/@creer_base_types_doc
- *
  * @param string $serveur
+ * @param string $champ_media
  * @return void
  */
 function creer_base_types_doc($serveur='', $champ_media="media_defaut") {
@@ -260,10 +265,10 @@ function creer_base_types_doc($serveur='', $champ_media="media_defaut") {
 
 
 /**
- * Optimiser la base de donnee en supprimant les liens orphelins
+ * Optimiser la base de données en supprimant les liens orphelins
  *
- * @param int $n
- * @return int
+ * @param array $flux
+ * @return array
  */
 function medias_optimiser_base_disparus($flux){
 
@@ -277,4 +282,4 @@ function medias_optimiser_base_disparus($flux){
 	return $flux;
 }
 
-?>
\ No newline at end of file
+?>
diff --git a/inc/choisir_mode_document.php b/inc/choisir_mode_document.php
index 3ed613464c15ea1a026173e0a343541b4811dda9..2220278eeac94f363eab159bf4ac83210593bf44 100644
--- a/inc/choisir_mode_document.php
+++ b/inc/choisir_mode_document.php
@@ -10,16 +10,24 @@
  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
 \***************************************************************************/
 
+/**
+ * Gestion des modes de documents
+ *
+ * @package SPIP\Medias\Modes
+ */
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
 /**
  * Choisir le mode du document : image/document
- * fonction surchargeable
  *
- * @param unknown_type $fichier
- * @param unknown_type $type_image
- * @param unknown_type $largeur
- * @param unknown_type $hauteur
+ * @param array $infos
+ *     Informations sur le document (en base + prises sur le fichier)
+ * @param bool $type_image
+ *     Type d'inclusion demandée : true si image
+ * @param string $objet
+ *     Objet sur lequel est placé le document
+ * @return string
+ *     Mode du document
  */
 function inc_choisir_mode_document($infos, $type_inclus_image, $objet){
 	
@@ -51,4 +59,4 @@ function inc_choisir_mode_document($infos, $type_inclus_image, $objet){
 		return 'document';
 }
 
-?>
\ No newline at end of file
+?>
diff --git a/medias_fonctions.php b/medias_fonctions.php
index b3c180cc5547370fe9ad5de4756b437d69c38654..56583cfdc6dbf598d62af8d299d723b979f86cc9 100644
--- a/medias_fonctions.php
+++ b/medias_fonctions.php
@@ -24,12 +24,12 @@ if (!defined('_ECRIRE_INC_VERSION')) return;
 /**
  * Afficher la puce de statut pour les documents
  *
- * @param unknown_type $id_document
- * @param unknown_type $statut
- * @param unknown_type $id_rubrique
- * @param unknown_type $type
- * @param unknown_type $ajax
- * @return unknown
+ * @param int $id_document
+ *     Identifiant du document
+ * @param string $statut
+ *     Statut du document
+ * @return string
+ *     Code HTML de l'image de puce
  */
 function medias_puce_statut_document($id_document, $statut){
 	if ($statut=='publie') {