                            CAW_Local version 1.06
                            ~~~~~~~~~~~~~~~~~~~~~~

              **************************************************
              * READ THIS - THINGS HAVE CHANGED A FAIR BIT.... *
              **************************************************


What is it?
~~~~~~~~~~~
  CAW_Local (or CAVlocal) is a SysOp utility to provide a nice RISC OSish
  interface to CastAWote. It is to allow the SysOp to participate in voting
  without needing to log-on and load CastAWote. Ummm... Quite simple all in
  all. And eats much less memory.

  To make it totally clear, this is for the SYSOP to use, instead of the
  hassle of logging on and running CastAWote. This is NOT a localised version
  of CastAWote (though it could be used as that. <grin> ).



Dependencies:
~~~~~~~~~~~~~
  VoteModule 1.16 and !CastAWote (version 3+) with a database are required.
  RiscOS3 is also needed, though it should work under RISC OS 2 if the
  templates are tweaked a little.



How to configure it:
~~~~~~~~~~~~~~~~~~~~
  CAWlocal now has a configuration system. When you first use CAWlocal it will
  no doubt moan and open the configuration window.

  Here you enter your name as it is in the ArcBBS user log. You then enter the
  CastAWote "OURFIDOADDR" as shown in the CastAWote configuration file.

  Finally, if you are using NVP... Tick the NVP log thingy.

  There are some options down below:
    "Automatically {...}" does not yet work. It will interrogate CastAWote and
    the BBS server to try to build up a default configuration.

  "Reset to defaults" basically clears everything (but does not save to disc).

  "Restore from disc" reloads your stored configuration file, if you have one.

  "Accept this configuration" will save your settings to disc.


  Note that it is possible to pass a username as a CLI parameter. This will
  override any username configured, allowing you to use certain configurations
  for a variety of local users.



Using it:
~~~~~~~~~
  Assuming !CastAWote has been 'seen' by the filer, or that VoteModule is
  loaded...

  Double-click on !CAW_Local. A little icon will appear. A banner window will
  appear for three seconds. I'm quite proud of that window. It uses a sprite
  so fonts are not necessary.

  Click on the icon. A pseudo-menu will appear:

    Add a vote
      Disabled. This function is only available to registered users.

    Cast your vote
      Allows you to cast your vote. Simply read the window and click the
      required icon. You can use the 'pane' icons to move around. This pane
      tries to be 'intelligent' in that it can scan both directions for votes
      that you've not yet voted on... though it can be confused if you go out
      of your way.
      BTW, the pane is supposed to stop half-way off the screen.

    View results
      Allows you to view the results. Pretty isn't it? :-)
      Use the 'pane' icons to move around.
      BTW, the pane is supposed to stop half-way off the screen.

    Quit CastAWote
      Must I? Come on... You can suss this out!


Mumbles:
~~~~~~~~
  Bug reports to me, as usual...

  NVP support now added and suchlike. :-)
