diff --git a/htdocs/boxes.php b/htdocs/boxes.php
index 64119d45be7..8120aa1a657 100644
--- a/htdocs/boxes.php
+++ b/htdocs/boxes.php
@@ -21,7 +21,7 @@
  *
  */
 
-/*!	\file boxes.php
+/*!	\file htdocs/boxes.php
 		\brief  Fichier de la classe boxes
 		\author Rodolphe Qiedeville
 		\author	Laurent Destailleur
diff --git a/htdocs/comm/propal.php b/htdocs/comm/propal.php
index 8925c10a4a3..b8ce8aa9be0 100644
--- a/htdocs/comm/propal.php
+++ b/htdocs/comm/propal.php
@@ -21,9 +21,10 @@
  *
  */
 
-/**
-* Gestion d'une proposition commerciale
-* @package propale
+/*!
+    \file       htdocs/comm/propal.php
+    \ingroup    propale
+    \brief      Page liste des propales
 */
 
 require("./pre.inc.php");
diff --git a/htdocs/propal.class.php b/htdocs/propal.class.php
index c8e2e571150..7315023e32a 100644
--- a/htdocs/propal.class.php
+++ b/htdocs/propal.class.php
@@ -23,7 +23,7 @@
  */
 
 
-/*!	\file propal.class.php
+/*!	\file htdocs/propal.class.php
 		\brief  Fichier de la classe des propales
 		\author Rodolphe Qiedeville
 		\author	Eric Seigne
@@ -39,8 +39,6 @@
 
 class Propal
 {
-  // {{{ properties
-
   var $id;
   var $db;
   var $socidp;
@@ -55,10 +53,9 @@ class Propal
   var $note;
   var $price;
 
-  // }}}
-
-  // {{{ constructor
 
+    /*! \brief  Constructeur
+    */
   function Propal($DB, $soc_idp="", $propalid=0)
     {
       $this->db = $DB ;
@@ -67,16 +64,15 @@ class Propal
       $this->products = array();
       $this->remise = 0;
     }
-  // }}}
-  // {{{ add_product()
-  /**
-   * Ajout d'un produit dans la proposition
-   * 
-   * @access public
-   * @param integer $idproduct l'id du produit
-   * @param integer $qty quantité
-   * @param integer $remise_percent remise effectuée sur le produit
-   * @return void
+
+
+  /*!
+   * \brief     Ajout d'un produit dans la proposition, en memoire dans l'objet
+   * \param     idproduct       id du produit à ajouter
+   * \param     qty             quantité
+   * \param     remise_percent  remise effectuée sur le produit
+   * \return    void
+   * \see       insert_product
    */
   function add_product($idproduct, $qty, $remise_percent=0)
     {
@@ -92,11 +88,14 @@ class Propal
 	  $this->products_remise_percent[$i] = $remise_percent;
 	}
     }
-  // }}}
+
   /**
-   *
-   *
-   * @return integer
+   * \brief     Ajout d'un produit dans la proposition, en base
+   * \param     idproduct       id du produit à ajouter
+   * \param     qty             quantité
+   * \param     remise_percent  remise effectuée sur le produit
+   * \return    int             0 en cas de succès
+   * \see       add_product
    */
   function insert_product($idproduct, $qty, $remise_percent=0)
     {
diff --git a/htdocs/user.class.php b/htdocs/user.class.php
index 961f90e09fd..75ce6e5175d 100644
--- a/htdocs/user.class.php
+++ b/htdocs/user.class.php
@@ -21,7 +21,7 @@
  * $Source$
  */
 
-/*!	\file user.class.php
+/*!	\file htdocs/user.class.php
 		\brief  Fichier de la classe utilisateur
 		\author Rodolphe Qiedeville
 		\author Jean-Louis Bergamo
@@ -729,17 +729,17 @@ class User
 
   /**
    * \brief     Change le mot de passe d'un utilisateur et l'envoie par mail
-   * \param     password    nouveau mot de passe (généré par defaut si non communiqué)
-   * \param     encrypted   0 ou 1 si il faut crypter le mot de passe en base (0 par défaut)
+   * \param     password        nouveau mot de passe (généré par defaut si non communiqué)
+   * \param     isencrypted     0 ou 1 si il faut crypter le mot de passe en base (0 par défaut)
    */
-  function password($password='', $password_encrypted = 0)
+  function password($password='', $isencrypted = 0)
     {
       if (! $password)
 	{
 	  $password =  strtolower(substr(md5(uniqid(rand())),0,6));
 	}
 
-      if ($password_encrypted)
+      if ($isencrypted)
 	{
 	  $sqlpass = crypt($password, "CRYPT_STD_DES");
 	}