From: Jonathan Rose <jrose@digium.com>
Date: Mon, 18 Feb 2013 19:48:47 +0000 (+0000)
Subject: PRESENCE_STATE: Provide better documentation for the 'e' option.
X-Git-Tag: 13.0.0-beta1~2080
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d7a616c945a7e02f292bf60fd60de0f6dea06601;p=thirdparty%2Fasterisk.git

PRESENCE_STATE: Provide better documentation for the 'e' option.

Notes that the 'e' option actually decodes data when used as a write function
such as with the SET application while it encodes data when used to read.

Review: https://reviewboard.asterisk.org/r/2335/
........

Merged revisions 381655 from http://svn.asterisk.org/svn/asterisk/branches/11


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@381656 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---

diff --git a/funcs/func_presencestate.c b/funcs/func_presencestate.c
index 51df750982..66a3f2ef5b 100644
--- a/funcs/func_presencestate.c
+++ b/funcs/func_presencestate.c
@@ -71,7 +71,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			<parameter name="options" required="false">
 			  <optionlist>
 			    <option name="e">
-				  <para>Base-64 encode the data.</para>
+				  <para>On Write - Use this option when the subtype and message provided are Base64
+					encoded. On Read - Retrieves message/subtype in Base64 encoded form.</para>
 				</option>
 			  </optionlist>
 			</parameter>
@@ -85,6 +86,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			the dialplan.  The <literal>CustomPresence:</literal> prefix must be used. For example:</para>
 			<para>Set(PRESENCE_STATE(CustomPresence:lamp1)=away,temporary,Out to lunch)</para>
 			<para>Set(PRESENCE_STATE(CustomPresence:lamp2)=dnd,,Trying to get work done)</para>
+			<para>Set(PRESENCE_STATE(CustomPresence:lamp3)=xa,T24gdmFjYXRpb24=,,e)</para>
+			<para>Set(BASE64_LAMP3_PRESENCE=${PRESENCE_STATE(CustomPresence:lamp3,subtype,e)})</para>
 			<para>You can subscribe to the status of a custom presence state using a hint in
 			the dialplan:</para>
 			<para>exten => 1234,hint,CustomPresence:lamp1</para>