DiaWebLog Installation
======================

1. Install Perl and the following modules:

	Net::IRC
	XML::Parser
	Unicode::String
	Unicode::Map8

  These are fairly common.  Packages for these modules are available
  for FreeBSD, Debian, and many other Unix distributions.

2. (Optional) Copy the DiaWebLog directory to the perl library
directory (usually /usr/local/lib/perl something) and the programs
dwl-* to the bin directory (usually /usr/local/bin).  Or, just run the
programs from this directory.

3. Create a .diaweblog directory in your home directory.  Copy
diaweblog.conf into the directory.  This is the example configuration
file.  Modify it as appropriate.  There are instructions in the file.

4. Now run dwl-bot, the bot program.  It should join the IRC channel
you specified in the configuration file.  If it complains about things
missing in the configuration file, fix them.  If it can't find perl,
modify the path on first line of dwl-bot.

5. If all else fails, go to #mesh on irc.openprojects.net and ask
dhelder for help.

dwl-archive builds the archive.  You can run it by hand occasionally
or have cron run it.

dwl-rotate rotates a log file.  You can use it to backup the
diaweblog.dwl file.


0.6 to 0.7 Migration
--------------------

DiaWebLog 0.7 now stores items in an XML file.  Version 0.6 stored
items in a MySQL database.  Run mysql2dwl to create a XML file from
the MySQL database.  Example:

	> mysql2dwl
	usage: mysql2dwl <db> <user> <pass>
	> mysql2dwl diaweblog diaweblog password > diaweblog.dwl


Net::IRC in FreeBSD Warning
---------------------------

If you are using FreeBSD ports, make sure you are using irc/p5-IRC
version 0.71.  Version 0.70 had a bug that caused parsing problems.


-----
Copyright (C) 2001 David Helder