diff --git a/htdocs/categories/class/api_deprecated_category.class.php b/htdocs/categories/class/api_deprecated_category.class.php
index c6a52f72035..656c769bed3 100644
--- a/htdocs/categories/class/api_deprecated_category.class.php
+++ b/htdocs/categories/class/api_deprecated_category.class.php
@@ -27,7 +27,7 @@
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
  * 
- * @deprecated
+ * @deprecated Use Categories instead (defined in api_categories.class.php)
  */
 class CategoryApi extends DolibarrApi
 {
diff --git a/htdocs/commande/class/api_deprecated_commande.class.php b/htdocs/commande/class/api_deprecated_commande.class.php
index 557682b8cf7..2a8caf5321e 100644
--- a/htdocs/commande/class/api_deprecated_commande.class.php
+++ b/htdocs/commande/class/api_deprecated_commande.class.php
@@ -29,7 +29,7 @@
  * @category Api
  * @package  Api
  * 
- * @deprecated
+ * @deprecated Use Orders instead (defined in api_orders.class.php)
  */
 class CommandeApi extends DolibarrApi
 {
diff --git a/htdocs/compta/facture/class/api_deprecated_invoice.class.php b/htdocs/compta/facture/class/api_deprecated_invoice.class.php
index 2ba4873fe8f..99fe0d7fe52 100644
--- a/htdocs/compta/facture/class/api_deprecated_invoice.class.php
+++ b/htdocs/compta/facture/class/api_deprecated_invoice.class.php
@@ -25,7 +25,7 @@
  * @smart-auto-routing false
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
- * @deprecated
+ * @deprecated Use Invoices instead (defined in api_invoices.class.php)
  */
 class InvoiceApi extends DolibarrApi
 {
diff --git a/htdocs/product/class/api_deprecated_product.class.php b/htdocs/product/class/api_deprecated_product.class.php
index 784539230e5..4efa2ef5502 100644
--- a/htdocs/product/class/api_deprecated_product.class.php
+++ b/htdocs/product/class/api_deprecated_product.class.php
@@ -26,7 +26,7 @@
  * @smart-auto-routing false
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
- * @deprecated
+ * @deprecated Use Products instead (defined in api_products.class.php)
  */
 class ProductApi extends DolibarrApi
 {
diff --git a/htdocs/societe/class/api_deprecated_contact.class.php b/htdocs/societe/class/api_deprecated_contact.class.php
index c4b0c672e19..9509e276f32 100644
--- a/htdocs/societe/class/api_deprecated_contact.class.php
+++ b/htdocs/societe/class/api_deprecated_contact.class.php
@@ -25,7 +25,7 @@ use Luracast\Restler\RestException;
  * @smart-auto-routing false
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
- * @deprecated
+ * @deprecated Use Contacts instead (defined in api_contacts.class.php)
  */
 class ContactApi extends DolibarrApi
 {
diff --git a/htdocs/societe/class/api_deprecated_thirdparty.class.php b/htdocs/societe/class/api_deprecated_thirdparty.class.php
index 5eb86405a5b..db270142972 100644
--- a/htdocs/societe/class/api_deprecated_thirdparty.class.php
+++ b/htdocs/societe/class/api_deprecated_thirdparty.class.php
@@ -24,7 +24,7 @@
  * @smart-auto-routing false
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
- * @deprecated
+ * @deprecated Use Thirdparties instead (defined in api_thirdparties.class.php)
  */
 class ThirdpartyApi extends DolibarrApi
 {
diff --git a/htdocs/user/class/api_deprecated_user.class.php b/htdocs/user/class/api_deprecated_user.class.php
index 5c5e7abaca6..c9fcb2b0dd7 100644
--- a/htdocs/user/class/api_deprecated_user.class.php
+++ b/htdocs/user/class/api_deprecated_user.class.php
@@ -25,7 +25,7 @@ use Luracast\Restler\RestException;
  * @smart-auto-routing false
  * @access protected 
  * @class  DolibarrApiAccess {@requires user,external}
- * @deprecated
+ * @deprecated Use Users instead (defined in api_users.class.php)
  */
 class UserApi extends DolibarrApi
 {