[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>