[asterisk-commits] jrose: branch 11 r381655 - /branches/11/funcs/func_presencestate.c

[SVN commits to the Asterisk project]

Author: jrose
Date: Mon Feb 18 13:43:10 2013
New Revision: 381655

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=381655
Log:
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/

Modified:
    branches/11/funcs/func_presencestate.c

Modified: branches/11/funcs/func_presencestate.c
URL: http://svnview.digium.com/svn/asterisk/branches/11/funcs/func_presencestate.c?view=diff&rev=381655&r1=381654&r2=381655
==============================================================================
--- branches/11/funcs/func_presencestate.c (original)
+++ branches/11/funcs/func_presencestate.c Mon Feb 18 13:43:10 2013
@@ -71,7 +71,8 @@
 			<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 @@
 			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>