add VM_MESSAGEFILE channel variable to hold path to message left by caller (bug #3926, plus doc update)

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

apps/app_voicemail.c

@@ -2139,6 +2139,10 @@ static int leave_voicemail(struct ast_channel *chan, char *ext, int silent, int
 				msgnum++;
 			} while (msgnum < MAXMSG);
 			if (msgnum < MAXMSG) {
+
+				/* assign a variable with the name of the voicemail file */	  
+				pbx_builtin_setvar_helper(chan, "VM_MESSAGEFILE", fn);
+
 				/* Store information */
 				snprintf(txtfile, sizeof(txtfile), "%s.txt", fn);
  				txt = fopen(txtfile, "w+");

doc/README.variables

@@ -357,18 +357,19 @@ ${MEETME_EXIT_CONTEXT} 		Context for exit out of meetme meeting
 ${MEETME_AGI_BACKGROUND} 	AGI script for Meetme (zap only)
 ${MEETMESECS} 			* Number of seconds a user participated in a MeetMe conference
 
-The voicemail() application uses the following variables:
+The VoiceMail() application uses the following variables:
 ---------------------------------------------------------
-${VM_CATEGORY}	Sets voicemail category
+${VM_CATEGORY}		Sets voicemail category
-${VM_NAME}	* Full name in voicemail
+${VM_NAME}		* Full name in voicemail
-${VM_DUR}	* Voicemail duration
+${VM_DUR}		* Voicemail duration
-${VM_MSGNUM}	* Number of voicemail message in mailbox
+${VM_MSGNUM}		* Number of voicemail message in mailbox
-${VM_CALLERID}	* Voicemail Caller ID (Person leaving vm)
+${VM_CALLERID}		* Voicemail Caller ID (Person leaving vm)
-${VM_CIDNAME}	* Voicemail Caller ID Name
+${VM_CIDNAME}		* Voicemail Caller ID Name
-${VM_CIDNUM}	* Voicemail Caller ID Number
+${VM_CIDNUM}		* Voicemail Caller ID Number
-${VM_DATE}	* Voicemail Date
+${VM_DATE}		* Voicemail Date
-
+${VM_MESSAGEFILE}	* Path to message left by caller
-The vmauthenticate() application uses the following variables:
+
+The VMAuthenticate() application uses the following variables:
 ---------------------------------------------------------
 ${AUTH_MAILBOX}	* Authenticated mailbox
 ${AUTH_CONTEXT}	* Authenticated mailbox context