
  News System v3 for eggdrop 1.1
  by Ernst <baschneo@trick.informatik.uni-stuttgart.de> 17/7/97

  Based on a script by Robey.  Development passed through eden
  <brookes@cs.uq.edu.au>, |eXiLe| <exile@perplex.eagle.ovik.se>, FireD
  <goofyguy@genitek.com> and now myself.

Versions:

  v0           Robey
  v0.5         eden    <brookes@cs.uq.edu.au>
               |eXiLe| <exile@perplex.eagle.ovik.se>
  v2   6/12/96 FireD   <goofyguy@genitek.com>
  v3   17/7/97 Ernst   <baschneo@trick.informatik.uni-stuttgart.de>

Changes in v3:

  Multiple channel support, easy configuration through news3.conf, lots of
  options to control reading/writing/expiration of news etc.  This is only for
  1.1 eggdrops!

About multi-channel support:

  Being now multi-channel, a problem appears about what channel news to
  manipulate when someone does a '/msg bot news' command.  The first sollution
  is to be able to explicitly specify what channel in the command, as in '/msg
  bot news #channel read'.  But you can also use the old style commands,
  without indicating the channel.  Then this is the method the script finds
  out what channel to use:

  If an user has a default news channel set (see bellow, the '/msg bot news
  default' command), this will be the channel used.  If this isn't the case
  (which will be most cases) the script will make a "best guess" of what
  channel news to show: Use the last channel the user joined, and if still
  none is avaliable, use the first configured news channel.

  If the user manipulates the news from the party-line and hasn't indicated
  which channel to use in the command (e.g .news delete 3), his default news
  channel is used, and if not avaliable, the current console channel.

  If all this seems too complicated for you, just ignore it, and enjoy! :)

Installation:

  1) Copy the files news3.tcl and news3.conf to your bots scripts directory.
  2) Add the news3.tcl to your bots config (source scripts/news3.tcl)
  3) Edit the news3.conf file to your needings
  4) To install the internal news help:
     - Create a directory under your bots help dir:	...eggdrop/help/dcc/news
     - Copy all files in the news3/help directory to this new directory
  5) .rehash or .restart your bot and news will be up and running. Watch
     your log for any errors that might be encountered while reading your
     configuration

  All configuration is done in news3.conf! You don't need to edit anything in
  the news3.tcl file, unless you want to!

MSG and DCC news commands avaliable:

  Type '.news help' to get a brief help.  If you copied the help files to your
  eggdrops help system, access this help with '.help news', '.help news add'
  etc.

  You don't have to specify the '#channel' in any command, this is optinal!
  For dcc commands, prefix "news" with a dot (e.g '.news #channel add bla').
  To use them on IRC via MSG, use '/msg bot' (e.g 'msg bot news #channel add
  bla').

  news #channel add <message...>
    Adds a message to the news file of one channel on the bot.

  news #channel erase <number>
    Erases the message number <number> from the news file.  Only the user who
    put the message there may erase it, except for masters (global or channel
    specific for that channel), who can erase any message.

  news #channel read
  news #channel read <number>
  news #channel read all
    Shows the newsfile of a channel.  If no parameter is given, show only new
    news (if user is known).  If a <number> is given, shows only that item.
    "all" makes bot show all news items stored.

  news #channel check
    Sends a private notice to a user telling them how much news there is.
    This is optionally done automatically when user joins the channel (or
    party-line).

  news default #channel
  news default none
  news default
    If channel is given, changes default news channel for this user.  If there
    is no parameter, shows current setting.  If parameter is "none", erases
    the default channel.

  news #channel reset
    (requires global +m or channel +m in given channel)
    Resets the counter associated with the news system of a channel but does
    not modify the news file itself.  Shouldn't be necessary in an ideal
    world.  :)

  news #channel clear
    (requires global +m or channel +m in given channel)
    Erases all news in a channels news file and resets the counter.

