diff --git a/UPGRADE.txt b/UPGRADE.txt
index daa8ac8b6f..b47bcbacdd 100644
--- a/UPGRADE.txt
+++ b/UPGRADE.txt
@@ -302,6 +302,10 @@ The SIP channel:
   in coming versions of Asterisk. Please use the dialplan function
   SIPCHANINFO(useragent) instead.
 
+* The ALERT_INFO dialplan variable is deprecated and will be removed
+  in coming versions of Asterisk. Please use the dialplan application
+  sipaddheader() to add the "Alert-Info" header to the outbound invite.
+
 The Zap channel:
 
 * Support for MFC/R2 has been removed, as it has not been functional for some
diff --git a/channels/chan_sip.c b/channels/chan_sip.c
index a7b7bf81cf..f97e498ab2 100644
--- a/channels/chan_sip.c
+++ b/channels/chan_sip.c
@@ -81,6 +81,10 @@
  * The PBX issues a hangup on both incoming and outgoing calls through
  * the sip_hangup() function
  *
+ * \par Deprecated stuff
+ * This is deprecated and will be removed after the 1.4 release
+ * - the SIPUSERAGENT dialplan variable
+ * - the ALERT_INFO dialplan variable
  */