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: