diff --git a/html/css/style-classic7.css b/html/css/style-classic7.css
index 5b2c521ad..1e17005e3 100644
--- a/html/css/style-classic7.css
+++ b/html/css/style-classic7.css
@@ -2436,6 +2436,9 @@ td.box {
 @media (min-width: 1200px) {
 
 }
+/*
+ * Smoke CSS (see smoke.js) 
+ */ 
 .dialog-prompt {
   margin-top: 15px;
   text-align: center;
diff --git a/include/class/document.class.php b/include/class/document.class.php
index 072788674..6a109d3c9 100644
--- a/include/class/document.class.php
+++ b/include/class/document.class.php
@@ -702,7 +702,7 @@ class Document
      *  - [DESCRIPTION]
      *  - [DOCUMENT_ID]
      *  - [DATE_PAID]
-     *  - [NOTE]
+     *  - [NOTE] Note from SALE or PURCHASE 
      *
      * \param $p_tag TAG
      * \param $p_array data from $_POST
diff --git a/include/class/fiche.class.php b/include/class/fiche.class.php
index 401763c11..03a6f4a82 100644
--- a/include/class/fiche.class.php
+++ b/include/class/fiche.class.php
@@ -39,7 +39,7 @@ class Fiche
     var $cn;           /*! < $cn database connection */
     var $id;           /*! < $id fiche.f_id */
     var $fiche_def;    /*! < $fiche_def fd_id */
-    var $attribut;     /*! < $attribut array of attribut object */
+    var $attribut;     /*! < $attribut array of Card_Property objects */
     var $fiche_def_ref; /*!< $fiche_def_ref Type */
     var $row;           /*! < All the row from the ledgers */
     var $quick_code;		/*!< quick_code of the card */
@@ -457,15 +457,15 @@ class Fiche
      * \brief  insert a new record thanks an array , either as parameter or $_POST
      *
      * \param $p_fiche_def fiche_def.fd_id
-     * \param $p_array is the array containing the data
+     * \param $p_array is the array containing the data key = av_textX where X is AD_ID
      *\param $transation DEPRECATED : if we are in a transaction, we don't commit here , else if not, the
      * then a transaction is started and committed 
      * 
      av_textX where X is the ad_id
-     *\verb
+     *\verbatim
     example
     av_text1=>'name'
-    \endverb
+    \endverbatim
      */
     function insert($p_fiche_def, $p_array=null, $transaction=true)
     {