diff --git a/CHANGES b/CHANGES
index 7d0b954a85..dcda33fe5b 100644
--- a/CHANGES
+++ b/CHANGES
@@ -221,6 +221,16 @@ res_pjsip
* The ability to use "like" has been added to the pjsip list and show
CLI commands. For instance: CLI> pjsip list endpoints like abc
+func_callerid
+-------------------
+ * CALLERID(pres) is now documented as a valid alternative to setting both
+ CALLERID(name-pres) and CALLERID(num-pres) at once. Some channel drivers,
+ like chan_sip, don't make a distinction between the two: they take the
+ least public value from name-pres and num-pres. By using CALLERID(pres)
+ for reading and writing, you touch the same combined value in the dialplan.
+ The same applies to CONNECTEDLINE(pres), REDIRECTING(orig-pres),
+ REDIRECTING(to-pres) and REDIRECTING(from-pres).
+
------------------------------------------------------------------------------
--- Functionality changes from Asterisk 13.5.0 to Asterisk 13.6.0 ------------
------------------------------------------------------------------------------
diff --git a/funcs/func_callerid.c b/funcs/func_callerid.c
index 1599349490..dee1977f4a 100644
--- a/funcs/func_callerid.c
+++ b/funcs/func_callerid.c
@@ -40,10 +40,11 @@ ASTERISK_REGISTER_FILE()
#include "asterisk/callerid.h"
/*
- * Do not document the CALLERID(pres) datatype.
- * The name and number now have their own presentation value. The pres
- * option will simply live on as a historical relic with as best
- * as can be managed backward compatible meaning.
+ * The CALLERID(pres) datatype is shorthand for getting/setting the
+ * combined value of name-pres and num-pres. Some channel drivers
+ * don't make a distinction, so it makes sense to only use one property
+ * to get/set it. The same applies to CONNECTEDLINE(pres),
+ * REDIRECTING(orig-pres), REDIRECTING(from-pres) and REDIRECTING(to-pres).
*
* Do not document the CALLERID(ton) datatype.
* It is an alias for num-plan.
@@ -55,11 +56,6 @@ ASTERISK_REGISTER_FILE()
* It has turned out to not be needed. The source value is really
* only useful as a possible tracing aid.
*
- * Do not document the CONNECTEDLINE(pres) datatype.
- * The name and number now have their own presentation value. The pres
- * option will simply live on as a historical relic with as best
- * as can be managed backward compatible meaning.
- *
* Do not document the CONNECTEDLINE(ton) datatype.
* It is an alias for num-plan.
*
@@ -69,12 +65,6 @@ ASTERISK_REGISTER_FILE()
* they are active at the same time. The plain pres option will simply
* live on as a historical relic.
*
- * Do not document the REDIRECTING(orig-pres), REDIRECTING(from-pres),
- * or REDIRECTING(to-pres) datatypes.
- * The name and number now have their own presentation value. The orig-pres,
- * from-pres, and to-pres options will simply live on as a historical relic
- * with as best as can be managed backward compatible meaning.
- *
* Do not document the REDIRECTING(orig-ton), REDIRECTING(from-ton),
* or REDIRECTING(to-ton) datatypes.
* They are aliases for orig-num-plan, from-num-plan, and to-num-plan
@@ -98,6 +88,7 @@ ASTERISK_REGISTER_FILE()
+
@@ -144,6 +135,9 @@ ASTERISK_REGISTER_FILE()
Gets or sets Caller*ID data on the channel. Uses channel callerid by
default or optional callerid, if specified.
+ The pres field gets/sets a combined value
+ for name-pres and
+ num-pres.
The allowable values for the name-charset
field are the following:
@@ -168,7 +162,8 @@ ASTERISK_REGISTER_FILE()
Gets or sets Caller*ID presentation on the channel.
This function is deprecated in favor of CALLERID(num-pres)
- and CALLERID(name-pres).
+ and CALLERID(name-pres) or CALLERID(pres) to get/set both
+ at once.
The following values are valid:
@@ -218,6 +213,7 @@ ASTERISK_REGISTER_FILE()
+
@@ -246,6 +242,9 @@ ASTERISK_REGISTER_FILE()
Gets or sets Connected Line data on the channel.
+ The pres field gets/sets a combined value
+ for name-pres and
+ num-pres.
The allowable values for the name-charset
field are the following:
@@ -279,6 +278,7 @@ ASTERISK_REGISTER_FILE()
+
@@ -294,6 +294,7 @@ ASTERISK_REGISTER_FILE()
+
@@ -308,6 +309,7 @@ ASTERISK_REGISTER_FILE()
+
@@ -366,6 +368,11 @@ ASTERISK_REGISTER_FILE()
Gets or sets Redirecting data on the channel.
+ The orig-pres,
+ from-pres and to-pres
+ fields get/set a combined value for the corresponding
+ ...-name-pres and ...-num-pres
+ fields.
The allowable values for the reason
and orig-reason fields are the following: