From: Jonathan Rose <jrose@digium.com>
Date: Mon, 24 Sep 2012 20:57:28 +0000 (+0000)
Subject: func_audiohookinherit: Document some missed sources.
X-Git-Tag: 1.8.18.0-rc1~40
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=1c200ea1b22bdb57f5a639820813a7ba7ea44a8b;p=thirdparty%2Fasterisk.git

func_audiohookinherit: Document some missed sources.

This patch also mentions that AUDIOHOOK_INHERIT can be used to
transfer MixMonitor audiohooks. There is also wiki that addresses
audiohooks and the use of AUDIOHOOK_INHERIT at the following link:
https://wiki.asterisk.org/wiki/display/AST/Audiohooks

(closes issue ASTERISK-18220)
Reported by: Ishfaq Malik



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

diff --git a/apps/app_mixmonitor.c b/apps/app_mixmonitor.c
index a574f79f22..45c4b720d7 100644
--- a/apps/app_mixmonitor.c
+++ b/apps/app_mixmonitor.c
@@ -105,6 +105,11 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			<para>Records the audio on the current channel to the specified file.</para>
 			<para>This application does not automatically answer and should be preceeded by
 			an application such as Answer or Progress().</para>
+			<note><para>MixMonitor runs as an audiohook. In order to keep it running through
+			a transfer, AUDIOHOOK_INHERIT must be set for the channel which ran mixmonitor.
+			For more information, including dialplan configuration set for using
+			AUDIOHOOK_INHERIT with MixMonitor, see the function documentation for
+			AUDIOHOOK_INHERIT.</para></note>
 			<variablelist>
 				<variable name="MIXMONITOR_FILENAME">
 					<para>Will contain the filename used to record.</para>
@@ -116,6 +121,7 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			<ref type="application">StopMixMonitor</ref>
 			<ref type="application">PauseMonitor</ref>
 			<ref type="application">UnpauseMonitor</ref>
+			<ref type="function">AUDIOHOOK_INHERIT</ref>
 		</see-also>
 	</application>
 	<application name="StopMixMonitor" language="en_US">
diff --git a/funcs/func_audiohookinherit.c b/funcs/func_audiohookinherit.c
index 59faa90198..f43310bbbc 100644
--- a/funcs/func_audiohookinherit.c
+++ b/funcs/func_audiohookinherit.c
@@ -53,7 +53,9 @@
 					<enum name="Chanspy" />
 					<enum name="Volume" />
 					<enum name="Speex" />
+					<enum name="pitch_shift" />
 					<enum name="JACK_HOOK" />
+					<enum name="Mute" />
 				</enumlist>
 				<para>Note that the names are not case-sensitive</para>
 			</parameter>