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,7 +357,7 @@ ${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_NAME}		* Full name in voicemail
@@ -367,8 +367,9 @@ ${VM_CALLERID}	* Voicemail Caller ID (Person leaving vm)
 ${VM_CIDNAME}		* Voicemail Caller ID Name
 ${VM_CIDNUM}		* Voicemail Caller ID Number
 ${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