[Asterisk-doc] docs extensions.xml,1.10,1.11

blitzrage asterisk-doc@lists.digium.com
Fri, 21 May 2004 19:41:30 +0000


Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv32670/docs

Modified Files:
	extensions.xml 
Log Message:
blitzrage
- Playback(), Answer() and Hangup()
Index: extensions.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/extensions.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** extensions.xml	21 May 2004 18:27:05 -0000	1.10
--- extensions.xml	21 May 2004 19:41:22 -0000	1.11
***************
*** 106,115 ****
--- 106,129 ----
  			<para>
  			[A brief explanation of the Answer() function.  Explain that although you don't always need to call Answer(), it's a good habit to get into.  (Playback() and a few other functions answer the call automatically if it hasn't already been answered.)]
+ 
+ 			The <function>Answer()</function> function is used to answer a channel which is ringing.  This does the initial establishing of
+ 			the call so that we can perform other functions.  A few functions don't necessarily require that we <function>Answer()</function>
+ 			the line first, such as <function>Playback()</function> and <function>Background()</function>, but it is a very good habit to
+ 			properly <function>Answer()</function> the channel before doing anything else.
  			</para>
  			<para>
  			[A brief explanation of the Playback() function.  Explain where it looks for files (maybe we should gloss over the language-specific part for now, but let's not forget to put it in somewhere.)]
+ 
+ 			The <function>Playback()</function> function is used for playing previously recorded files over a channel to the remote end.  When using
+ 			the <function>Playback()</function> function, input from the user while the file is being played is simply ignored.  If you need to
+ 			accept input during playback, use the <function>Background()</function> function.  Asterisk comes with many professionally recorded
+ 			sound files which can be found in <filename class='directory'>/var/lib/asterisk/sounds/</filename>.  <function>Playback()</function>
+ 			is used by specifying the filename without an extension as the argument.  For example, <function>Playback(filename)</function>.
  			</para>
  			<para>
  			[A very brief explanation of the Hangup() function.  This one should be really simple. :-) ]
+ 
+ 			The <function>Hangup()</function> does exactly as it's name implies; it hangs up an active channel.  You would use this
+ 			at the end of a context once you want to drop a caller who no longer needs to be conected to the system.
  			</para>
  		</sect2>