[Asterisk-doc] capi-application reference

[Daniel Heinzen]

hello to everyone,

this night i wrote a first CAPI application reference in docbook. Now the question is
whether to put it into the normal application reference or to make a
subsection for each channeltype-independent apps. Any suggestions would be
great. 


Here it goes:



<formalpara>
 <title>capiCD : Call Deflection</title>
<para>
 <function>capiCD(NumberToForwardTo)</function>
</para>
</formalpara>

<para>                                         
 Forwards an unanswered call to another party (does not rely on sservice
CD).
 It only works if the call is unanswered.
</para>
<para> 
        <informalexample>
        <programlisting>
exten=>s,1,Wait(1)
exten=>s,2,capiCD(5551234)
        </programlisting>
        </informalexample>
</para>


<formalpara>
 <title>capiHOLD : Put the call on HOLD</title>
<para>
 <function>capiHOLD()</function>
</para>
</formalpara>

<para>
 Puts an answered call on hold. This has nothing to do with asterisk's MOH
 It depends on which HOLD your telephony provider gives you. Never use the
 Wait application after capiHOLD. But it is possible to use the capiECT
 function to transfer the call to another party.
</para>
<para>
        <informalexample>
        <programlisting>
exten=>s,1,capiHOLD
        </programlisting>
        </informalexample>
</para>


<formalpara>
 <title>capiRETRIEVE : Retrieve the HOLDED call back.</title>
<para>
 <function>capiRETRIEVE()</function>
</para>
</formalpara>

<para>
 Get the HOLDED call back.
</para>
<para> 
        <informalexample>
        <programlisting> 
exten=>s,1,capiRETRIEVE()
        </programlisting>
        </informalexample>
</para>


<formalpara>
 <title>capiECT : Explicit Call Transfer</title>
<para>
 <function>capiECT(FromMSN:ToMSN|SayCalle(r/d)ID)</function>
</para>
</formalpara>

<para>
  Transfer a HOLDED call to another party using FromMSN as the
callerid/outgoing msn. This application is able to tell you on the phone which MSN is
calling you (SayCallerID) rsp. which was called (SayCalledID).
</para>
<para> 
        <informalexample>
        <programlisting> 
       exten => 1,1,Answer
       exten => 1,2,capiHOLD
       exten => 1,3,capiECT,555123:123555|SayCallerID
        </programlisting>
        </informalexample>  
</para>













-- 

   
  Daniel Heinzen

------------------------------

  New Age Systems
  Am Rosenberg 2
  56333 Winningen

  Kontakt:

  Tel  : +49 2606 9619-173
  Fax  : +49 2606 9619-421
  IAX  : 17005831550@iaxtel.com

  Mail : dh@new-age-systems.de
  Web  : www.new-age-systems.de

------------------------------