


                           QuickBBS ST User Editor
                                    v1.00

                   Copyright  1990 by DeltaVision Systems

            For disclaimer, copyright info and distribution rules
                     see the QuickBBS ST documentation.


     General
     =======

     The enhanced user editor,  v1.00, has not been fully tested. If you 
     encounter any bugs, let me know!

     All  you ever wanted in a user editor is ready for you to use  with 
     UserEdit 1.00. Apart from the 'normal' user editting you now have a 
     tool which generates reports, upgrades users and lots lots more.

     Differences
     ===========
     
     The  'old' user editor required you to press the Return key  before 
     you could change a field. With v1.00 you can wander around with the 
     cursor, and change anything you like at any time.

     The 'old' version was very slow.  I've tried to make v1.00 as  fast 
     as  possible,  but still use as little memory as I can (so you  can 
     run it while shelling under Quick).

     V1.00 has lots of juicy features for you to try out,  which  should 
     make your life as a SysOp slightly more endurable 8-)

     Edit Screen
     ===========

     The main edit screen is the first thing you see.  If you previously 
     didn't have a user base most fields will be blank (or contain dummy 
     entries).  In  that case a file for the LastRead pointers  is  also 
     created.

     At  the top of the screen you see the user record number,  and  the 
     total number of users. The last user in the userbase is loaded when 
     you start up the editor.

     Under the user number you will see the user info.  The cursor  keys 
     move  the cursor (gee!),  use Shift + cursor keys to  move  through 
     your users.  Press Home to go to the top field,  or ^Z to wizz down 
     to the bottom.

     While  editting a field you can use Delete to delete the  character 
     under the cursor,  Insert to insert a space and ^Delete to zap  the 
     whole field.

     The  Escape  key  exits  (and saves the  user  record,  if  it  was 
     changed),  the Undo key aborts any changes to the current user  (it 
     does not exit). And don't panic, just press Help.

     Alt-J  shells  to  DOS  (starts up the  program  you  specified  in 
     QConfig).

     Function Keys
     =============

     The function keys are displayed at the bottom of the  screen.  When 
     you  press  Shift you'll see a second set of  keys,  which  can  be 
     accessed by pressing - you guessed it - Shift plus a function key.

     From left to right, and from 1 to 14, they are...

     F1   GoTo      use this to enter a record number to jump to.

     F2   Add       adds a user to the end of the user base.  Some  info 
                    is   filled   in  (the  editor  gets   it   out   of 
                    QCONFIG.BBS).

     F3   Search    allows  you  to  enter a text.  This  text  is  then 
                    searched in the user names.  Case is not  important. 
                    The  user  base is searched starting with  the  next 
                    user (forward).  As soon as the string is found that 
                    user is displayed.

     F4   List      shows a list of all users.  Use the cursor keys etc. 
                    to page up and down.  Press Return on a user to load 
                    that  record,  or  Escape to keep the  current  user 
                    record.

     F5   Upgrade   see the section about 'Upgrading Users'.

     F6   Global    not  yet  implemented.  Will  allow  global  flag  & 
                    security changes (=for all users).

     F7   Report    outputs  a report to printer,  screen or  file.  The 
                    report contains the user fields you specify. Use the 
                    cursor  keys to move through the fields,  and  press 
                    Return to switch a field on or off.

     F8   Answers   scans  through  the  New User Log  for  the  current 
                    users,  and  displays the info that the user  typed. 
                    You  can specify what the questions were  using  the 
                    configuration option (below).

     F10  Config    see the section about 'Configuration'.

     F11  Print     (shift+F10)  prints  out the  current  user  record, 
                    nearly  the  same  way as it  is  displayed  on  the 
                    screen.  If  you have an IBM compatible printer  you 
                    will get box graphics and highlights too.

     F12  Pack      not yet implemented. Will allow you to pack the user 
                    base,  removing deleted users and users who  haven't 
                    called for a specified number of days.

     F13  Sort      not yet implemented. Will sort the user base by name 
                    or security level.  The first record (you) will  not 
                    be  changed.  Perhaps  USERnnn files  will  also  be 
                    sorted, I'll have to think about that...

     F14  Stats     displays a whole list of statistics,  averages  etc. 
                    More to come!

     Configuration
     =============

     Press F10 to get into the configuration screen.  The  configuration 
     of  UserEdit  is  stored in the  .PRG  file  itself.  Although  the 
     program performs a number of checks on the program file, you should 
     not  save  your configuration to your only  copy  of  UserEdit.  If 
     UserEdit can't find itself it will ask you to help it.

     The first two options are New User Security and New User Flag. They 
     are  used to determine whether a user is a new one or not.  To  use 
     the upgrade mechanism your new users must have a flag set (you  can 
     do this with option 3 of QConfig).

     Next  are the Upgrade Security Level and Upgrade  Flags.  When  you 
     upgrade a user he will get this security level,  and his flags  are 
     also changed. With the Upgrade Flags using 'OR' option you can make 
     sure  flags which are already set are not cleared.  A  binary  'OR' 
     operation is performed instead of an 'AND'.

     When  you upgrade users or view their answers (F5 and F8)  UserEdit 
     can display will display the answers to the questions asked to  new 
     users. These questions (max. 10) can be specified here.

     Flags can have comments in the new version! Use F1 to edit the flag 
     comments.  Then, when you move your cursor over a flag, the comment 
     is displayed next to it.  So,  if you use A1 to indicate new users, 
     the A1 comment may be something like 'New User Flag'.

     Upgrading Users
     ===============

     To upgrade users go to the last user in the user base and press F5. 
     UserEdit will now scan backwards,  looking for new users. New users 
     should have a flag set, which can be specified in the configuration 
     screen, and must have a certain security too.

     When  UserEdit  finds a new user you can either  delete  the  user, 
     upgrade him, edit the record or do nothing.

     The new users name,  phone numbers,  answers to questions etc.  are 
     displayed.  The  questions  can be specified in  the  configuration 
     screen.

     If you choose to upgrade the user,  his security level will be  set 
     to  the 'upgrade security level',  and his flags will be  modified. 
     The new user flag will be switched off,  and the flags will  either 
     be ANDded or ORred,  depending on your setting in the configuration 
     screen.

     What's next?
     ============

     1) Implementation of the 'not yet implemented' features,
     2) Implementation of the accounting system. This already works in a 
        version of Quick I have here,  but the compiler complains. Looks 
        like I'm stretching it too far.
     3) Perhaps  a next version will detect whether a user  is  on-line, 
        and  if  so jump directly to that user record and let  you  mess 
        around  with it.  Quick could then re-read (part of) the  record 
        and use the new settings. Comments plz.
     4) Some more nice stuff for the Statistics screens:  messages  read 
        per  area,  new  messages per area per  day,  download  protocol 
        statistics & efficiency,  top-10 screens & files  etc.  Feedback 
        welcome here too.

     Enough for now. Enjoy, and let me know if something goes wrong...

     Electronic Greetings!                                       - Jon -

