Merged revisions 336716 via svnmerge from

https://origsvn.digium.com/svn/asterisk/branches/1.8

........
  r336716 | jrose | 2011-09-19 15:07:36 -0500 (Mon, 19 Sep 2011) | 7 lines
  
  Document applications that play audio and do not answer unanswered calls.
  
  This patch is part of an effort to document early media and its usage. If you are
  interested in contributing to this documentation effort, there are probably other
  applications worth documenting as well as an Asterisk wiki article at
  https://wiki.asterisk.org/wiki/display/AST/Early+Media+and+the+Progress+Application
........


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

apps/app_echo.c

@@ -46,6 +46,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 		<description>
 			<para>Echos back any audio, video or DTMF frames read from the calling 
 			channel back to itself. Note: If '#' detected application exits</para>
+			<para>This application does not automatically answer and should be
+			preceeded by an application such as Answer() or Progress().</para>
 		</description>
 	</application>
  ***/

apps/app_mixmonitor.c

@@ -117,6 +117,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 		</syntax>
 		<description>
 			<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>
 			<variablelist>
 				<variable name="MIXMONITOR_FILENAME">
 					<para>Will contain the filename used to record.</para>

apps/app_morsecode.c

@@ -50,7 +50,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 		</syntax>
 		<description>
 			<para>Plays the Morse code equivalent of the passed string.</para>
-
+			<para>This application does not automatically answer and should be preceeded by
+			an application such as Answer() or Progress().</para>
 			<para>This application uses the following variables:</para>
 			<variablelist>
 				<variable name="MORSEDITLEN">

apps/app_mp3.c

@@ -65,9 +65,11 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 		<description>
 			<para>Executes mpg123 to play the given location, which typically would be a mp3 filename
 			or m3u playlist filename or a URL. Please read http://en.wikipedia.org/wiki/M3U
-			to see how M3U playlist file format is like, Example usage would be 
+			to see how M3U playlist file format is like, Example usage would be
 			exten => 1234,1,MP3Player(/var/lib/asterisk/playlist.m3u)
 			User can exit by pressing any key on the dialpad, or by hanging up.</para>
+			<para>This application does not automatically answer and should be preceeded by an
+			application such as Answer() or Progress().</para>
 		</description>
 	</application>
 

apps/app_queue.c

@@ -224,6 +224,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			up by another user.</para>
 			<para>This application will return to the dialplan if the queue does not exist, or
 			any of the join options cause the caller to not enter the queue.</para>
+			<para>This application does not automatically answer and should be preceeded
+			by an application such as Answer(), Progress(), or Ringing().</para>
 			<para>This application sets the following channel variable upon completion:</para>
 			<variablelist>
 				<variable name="QUEUESTATUS">

apps/app_saycounted.c

@@ -62,6 +62,8 @@
 			file name is never seen by the end user, there is no need to
 			implement complicated spelling rules.  We simply record the word
 			"men" in the sound file named "mans".</para>
+			<para>This application does not automatically answer and should be
+			preceeded by an application such as Answer() or Progress.</para>
 		</description>
 		<see-also>
 			<ref type="application">SayCountedAdj</ref>
@@ -99,6 +101,9 @@
 			will play sound file "newa" (containing the word "novaya"), but
 			SayCountedAdj(5,new,f) will play sound file "newx" (containing the
 			word "novikh").</para>
+			<para>This application does not automatically answer and should be
+			preceeded by an application such as Answer(), Progress(), or
+			Proceeding().</para>
 		</description>
 		<see-also>
 			<ref type="application">SayCountedNoun</ref>

res/res_musiconhold.c

@@ -86,6 +86,8 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 			Set(CHANNEL(musicclass)=...). If duration is given, hold music will be played
 			specified number of seconds. If duration is ommited, music plays indefinitely.
 			Returns <literal>0</literal> when done, <literal>-1</literal> on hangup.</para>
+			<para>This application does not automatically answer and should be preceeded by
+			an application such as Answer() or Progress().</para>
 		</description>
 	</application>
 	<application name="WaitMusicOnHold" language="en_US">