			       WapIRC 0.2
			A wap<->irc gateway tool.


License
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  Due to patent restrictions on WAP in the USA this software is not licensed
  for use within the United States of America, its dependancies, embassies
  or other jurisdictions
 
Installation
  Edit "config.h". Adjust the parameters as needed. The wapirc socket must
  be in a local (non NFS) directory, owned by the uid that will run wapircd
  with a path under 128 bytes long. (AF_UNIX socket restriction)

  Generally your webserver will run as nobody or a specific web server user
  (httpd or apache).

Authentication
  WapIRCD does not do authentication. It relies on the existing .htaccess
  support and web server to do this. 

Operation
  Run wapircd in the background as a suitable (*non root*) user. The daemon
  exists at all times and maintains the session state as well as the irc
  connection. To reduce resource usage on the irc server it will connect
  to the server when a user first uses wapirc, and disconnect on any server
  or client initiated disconnect, or on exceeding its internal buffer. Note
  that wapircd is a wap to irc daemon, it is not of itself an irc server.

  wapirc is designed to live in cgi-bin. It connects to the wapircd to
  retrieve queued messages and also to send new data out to the irc server.
  As wapirc is stateless you can lose and resume your wap connection without
  losing the irc session providing you don't take too long about it.

Supporting Pages
  All wapirc needs is a link of the form

	<a title="IRC" href="http://my.box/cgi-bin/wapirc">WapIRC</a><br/>

  and appropriate .htaccess setup. It will do the rest of the page
  generation itself.

To Do
  Multi user support (multiple wapircd's or even a single multi user daemon
  if someone really wants thousands of sessions on their box)

  Better support for /describe, /ctcp, /me etc. 

  SMS gateway support for forwarding selected /msg and user arrival messages
  to the users phone asynchronously.
 
  Internal authentication setup for large sites

  IRC is only one of the applications of this tool. WAP based Linux command
  line access is another interesting option. 

Support
  This software comes with no support. If you are using this open source 
  software in an environment and you want support contracts or enhancements
  please contact us.

