[Asterisk-java-cvs] CVS: asterisk-java/xdocs index.xml,NONE,1.1

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/asterisk-java/asterisk-java/xdocs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16881/xdocs

Added Files:
	index.xml 
Log Message:
migrated old index.html to xdocs

--- NEW FILE: index.xml ---
<?xml version="1.0"?>
<document>
  <properties>
    <author email="srt at users.sourceforge.net">Stefan Reuter</author> 
    <title>The asterisk-java Library</title>
  </properties>
  <meta name="keyword" content="asterisk,java,pbx,manager api,library"/>
  <body>
    <section name="Asterisk Java">
      <subsection name="What is asterisk-java?">
        <p>The asterisk-java package consists of a set of Java classes that
        allow you to connect to an
        <a href="http://www.asterisk.org/">Asterisk PBX Server</a> via
        <a href="http://www.voip-info.org/wiki-Asterisk+manager+API">Asterisk's
        Manager API</a> from any Java application.</p>

        <p>It supports receiving events from the Asterisk server (e.g. call
        progess, registered peers, channel state) and sending actions to
        Asterisk (e.g. originate call, agent login/logoff, start/stop voice
        recording).</p>
        
        <p>A complete list of the available
        <a href="apidocs/net/sf/asterisk/manager/event/package-summary.html">events</a>
        and
        <a href="apidocs/net/sf/asterisk/manager/action/package-summary.html">actions</a>
        is available in the <a href="apidocs/index.html">javadocs</a>.</p>
      </subsection>

      <subsection name="License">
        <p>Asterisk-java is provided under the terms of the
        <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
        License, Version 2.0</a>.</p>
      </subsection>

      <subsection name="Status">
        <p>Currently asterisk-java supports the actions and events provided by
        the standard installation of Asterisk.  Future releases will add the
        ability to easily extend them by user provided events and actions.</p>
        
        <p>Ideas for the future include a stateful higher level API that
        supports operations like "get list of currently active calls" or "place
        call" with objects like "Call" or "Channel" that are transparently
        updated as the state of the corresponding object within the asterisk
        server changes.</p>
      </subsection>

      <subsection name="Download">
        <p>Asterisk-java is currently available via cvs only.</p>
<pre>
cvs -d:pserver:ano...@cv...:/cvsroot/asterisk-java login
cvs -z3 -d:pserver:ano...@cv...:/cvsroot/asterisk-java co asterisk-java
</pre>
        <p>When prompted for a password for <i>anonymous</i>, simply press the
        Enter key.</p>

        <p>More information is available on the
        <a href="http://sourceforge.net/projects/asterisk-java/">sourceforge
        project page</a>.</p>
      </subsection>

      <subsection name="Related Projects">
        <p>_dw has developed a similar kind of software for Python called
        <a href="http://www.botanicus.net/dw/py-asterisk.php">py-Asterisk</a>.
        </p>

        <p><a href="http://sourceforge.net/projects/jasterisk/">JAsterisk</a>
        is a set of JNI classes providing direct access
        to Asterisk PBX functionality from Java. It is not a
        socket-level interface into the Asterisk manager app (like
        asterisk-java) but a true Java-Asterisk integration at the Thread
        level.</p>

        <p><a href="http://www.voip-info.org/wiki-JAGIServer">JAGIServer</a> a
        100% Pure Java application server for Asterisk using the FastAGI
        protocol, which is a TCP/IP wrapper around the Asterisk Gateway
        Interface AGI protocol for call handling and processing caller
        input.</p>
      </subsection>

      <subsection name="Contact">
        <p>You can reach me at
        <code>srt</code> at <code>reucon</code> dot <code>net</code></p>.
      </subsection>

    </section>
  </body>
</document>