README
changeset 5 fcc1eac04772
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Wed May 07 23:56:26 2008 -0400
@@ -0,0 +1,77 @@
+EnanoBot - the Enano CMS IRC bot
+Copyright (c) 2008 Dan Fuhry
+
+    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
+
+EnanoBot is a bot I wrote for the Enano CMS IRC channel in #enano on freenode. It's
+written in CLI PHP and you need to have shell access, a MySQL server, and a host
+with a very permissive TOU or a reliable home connection to run this bot.
+
+FEATURES
+--------------------
+
+   - Basic logging
+   - Privileged users - automatically opped and can speak through the bot, among
+     other things
+   - Snippets - use for automated help
+   - Web-based log viewer
+   - Web-based snippet manager
+
+REQUIREMENTS
+--------------------
+
+  - MySQL server
+  - SSH access
+  - PHP on your shell server
+  - Working Enano installation
+  - The MySQL user Enano uses needs to have access to EnanoBot's database if it's
+    not the same one that you're using for Enano
+
+NOTE ON ISP RESTRICTIONS
+--------------------
+
+A lot of ISPs (webhosts) prohibit running IRC bots from your shell account. Check
+with their terms of use before you enable this thing. Because this project is under
+the GPL there is of course no warranty for it, and nobody from the Enano Project
+can be responsible for your use of this bot. So make sure it's OK before you try to
+run it.
+
+INSTALLING
+--------------------
+
+Copy config-sample.php to config.php and edit it. Then put irclogs.php and
+snippets.php wherever your Enano installation is. You could probably modify snippets
+to not use Enano pretty easily but securing it would be your job. Edit both irclogs
+and snippets to set the EnanoBot root directory (where your config and enanobot.php
+are). DO NOT put enanobot.php and config.php in your document root - you WILL get
+hacked.
+
+To start it, run:
+
+  $ php enanobot.php
+
+You may find it useful to make sure that it restarts if it dies. Once you've started
+the bot and confirmed that it works, do something like: (and this is really hackish)
+
+  $ while true; do php enanobot.php; done &
+
+This all assumes that you're on a Unix-based server. Things will be different on
+Windows.
+
+AUTHOR
+--------------------
+
+Dan Fuhry <dan@enanocms.org>
+