DiaWebLog Commands
------------------

DiaWebLog is an interface between IRC and a weblog.  Members of the
IRC channel interact with a bot to create a community weblog.  The
DiaWebLog consists of *items*.  An item consists of a title, url, and
comments.  Items are posted and edited by member of the IRC channel by
interacting with the DiaWebLog bot.

Members interact with the bot using commands.  Commands are either
said aloud (e.g., "command"), told directly to the bot (e.g., "bot:
command"), or told privately to the bot (e.g., "/msg bot command").
(These examples assume the bot's nick is "bot".)  Commands are
case-insensitive.


* Posting items

There are many ways to post a new item:

  Say <url>               (e.g., http://www.example.com)
  Say <title>, <url>      (e.g., Swell examples, http://www.example.com)
  Say @ITEM <title>       (e.g., @ITEM Party today at my house)

When an item is added, the bot will say "K: <title> [#N]".  N is the
number ID of the item and K is the letter ID.  The number ID is
permanent, but the letter ID is not.


* Adding comments

K: <comment> adds the comment <comment> to an item.  Within the
comment, you can do the following:

  *word*   	    Makes <word> italicized
  <url>		    Makes <url> a link
  +<url>	    Makes <url> an image
  [<title>, <url>]  Makes <url> a link with title <title>
  <title>, <url>    Makes <url> a link with title <title> (the whole line)

Example comments:
  check *this* out
  Did you see http://www.example.com
  Here's the new logo: +http://www.example.com/logo.gif
  Check out the [Diaweblog, http://www.diaweblog.org]
  You should email dhelder@umich.edu

You can only comment on the 50 most recent items.

K, <comment> and K; <comment> also work.  Commas and semicolons can
always be used instead of colons.  This is useful if your IRC client
has nickname auto-completion and it attempts to auto-complete your DWL
commands.


* Editing items

K: <command> performs <command> on item K.  The K: commands are:

  K:			View item K (title, URL, poster, comments)
  K: TITLE <title>	Set K's title to <title>
  K: URL <url>		Set K's URL to <url>
  K: HIDE		Hide item K
  K: SHOW		Show item K

An item's poster can TITLE, URL, HIDE, or SHOW the item until there is
a newer item.  Admins can TITLE, URL, SHOW, or HIDE at any time.
Anyone can view an item at any time, even if it is hidden.


* Other commands

You can tell the bot these commands or say "@<command>:

  HELP			 print URL of this document
  ITEM (or @) <title>	 add item with <title>
  VIEW			 print summaries of the last 5 items
  VIEW <number>		 print summaries of the last <number> items
  SEARCH <word>		 search for <word> in titles and urls
  SEARCH <word> <number> search for <word>, show at most <number> items
  UPDATE		 update the weblog [admins only]
  RESTART		 restart the bot [admins only]


* Hints

- Msg the bot to view items and search.  This can be done publicly
too, but it can ignore the other users.  It will ignore most other
commands.

- The letter "k" is skipped as letter ID.  You can safely say "k, i
will do that" without adding a comment to some item.


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