@database RunBar
@master Work:Assembler/MyProgramDisk2/RunBar2.3/RunBar/RunBar.guide
@$VER: 2.3
@author "Sergej Kravchenko"
@(c) "Sergej Kravchenko"

@node "Main" "RunBar Guide"

                      /-----|                /-----|
                     /      /               /      /  
                    /      /               /      /            
                   /------/  /   / /--|   /------/  /---/  /---|
                  / |       /   / /   /  /      /  /   /  /
                 /   |     /   / /   /  /      /  /   /  /
                /     |   /___/ /   /  /______/  /___/_ /

                                Run Bar 2.3

                       (c) 1996 @{b}@{fg highlight}Sergej Kravcenko@{ub}@{fg text}

                    Date of release  --  8 September 1996


                                @{b}@{u}Contents@{ub}@{uu}

        @{i}@{fg highlight}Some info...@{ui}@{fg text}

           @{"Introduction" link "Introduction" 0}   -   What is it?
           @{"Distribution" link "Distribution" 0}   -   Distribution
           @{"This Release" link "Release" 0}   -   Info about this release.
           @{"Requirements" link "Requirements" 0}   -   System Requirements.
           @{"Registration" link "Registration" 0}   -   How to register.
           @{"Installation" link "Installation" 0}   -   Install it.

        @{i}@{fg highlight}Reference@{ui}@{fg text}

           @{"Windows     " link "Window" 0}   -   Windows operations.
           @{"Exchange    " link "Exchange" 0}   -   Programs control. 
           @{"Prefs       " link "Prefs" 0}   -   Prefs program.

        @{fg highlight}Info for programmers...@{fg text}

           @{"Support     " link "Support" 0}   -   Read this. 

        @{i}@{fg highlight}Other...@{ui}@{fg text}

           @{"Bugs&Errors " link "Bugs&Errors" 0}   -   Bugs and Errors.
           @{"History     " link "History" 0}   -   Changes.
           @{"Thanks      " link "Thanks" 0}   -   Thanks to...
           @{"Author      " link "Author" 0}   -   About me.
@endnode

@node "Thanks" "Thanks to..."

  @{b}@{u}Thanks to...@{ub}@{uu}

 @{fg highlight}Andrej Teleshov@{fg text}

    For my software testing and design help.

    E-Mail: @{i}@{fg highlight}antel@pub.osf.lt@{ui}@{fg text}

 @{fg highlight}Stefan Becker@{fg text}

    For @{b}GREAT@{ub} WBStart program.
@endnode

@node "History" "History of RunBar"


   @{fg highlight}Version 0.9@{fg text}

       First program version.

   @{fg highlight}Version 1.0@{fg text}

       Fixed bug associated with Drawers rename,remove and add.

   @{fg highlight}Version 1.1@{fg text}

       Commodity support added.Now you can Enable,Disable program or
       Quit from program using Exchange program.

       HotKey added (Default F1).When you press hotkey RunBar window
       will POPUP.

       GFX improvement.

   @{fg highlight}Version 1.2@{fg text}

       Removed little popup problem.

       Changed Find and Clock GFX.

       Added Find and Clock programs coded by me.

   @{fg highlight}Version 1.3@{fg text}

       Added popup delay.

       Now you can change spacing between items.

       Added Prefs program.

   @{fg highlight}Version 2.0@{fg text}

       Bildin Exchange program.Now you can control other programs from
       RunBar!!!!!

       Now if you change Prefs, it take effect immediately.

       Added error requesters.Now you can know why program won't run.

       When you press HotKey window popup under mouse pointer.

       Middle mouse button support as HotKey.(Only for Standart Amiga
       mouse!!!!!)

   @{fg highlight}Version 2.1@{fg text}

       Fixed menu layout bug.

       Improved screen management.

   @{fg highlight}Version 2.2@{fg text}

       Bug fixed. If you skip all commodities and try to popup RunBar
       program crash.

       Fixed few little bugs.

   @{fg highlight}Version 2.3@{fg text}

       New feature.In this version you can exclude files from Prefs menu.

       New feature.Configurable Utilities menu.
@endnode

@node "Requirements" "System Requirements"


 To run RunBar you need to have some hardware and software:


   @{fg highlight}*@{fg text} OS 3.0+ (V39+)

   @{fg highlight}*@{fg text} MagicWB colors.

   @{fg highlight}*@{fg text} wbstart.library
     (c) 1991-1996 Stefan Becker. (Included into archive)
     Also you can find archive on Aminet util/libs/WBStart2_1.lha.

   @{fg highlight}*@{fg text} XHelvetica.font (Comes with MagicWB).
     Please use only standart XHelvetica fonts!!!!!

   @{fg highlight}*@{fg text} MUI (c) Stefan Stuntz. (Only for Find and Prefs programs).
@endnode

@node "Introduction" "Introduction"

 @{fg highlight}Introduction@{fg text}

  This program is replacement for ToolManager. Using this you can
  easy run your programs,tools,prefs,ARexx scripts and etc...

  You'll have fast access to programs,just few mouse click!!!!!!
@endnode

@node "Release" "This Release"

 Attention

  This is fourth program release to Aminet!
  No errors found in Version 2.2
  But if you find a bug send bug report to
  @{"Author" link "Author" 0}
@endnode

@node "Registration" "Registration"

 @{b}Registering RunBar@{ub}

  @{i}@{fg highlight}RunBar Registered Software License Agreement@{ui}@{fg text}

   RunBar is Copyright (c) 1996 by Sergej Kravcehenko.

   RunBar program is released as shareware.This means:

   1) If you use this program you should register it.
      (I will send to you personal keyfile.)

   2) With this key file RunBar will not popup shareware request.

   3) Keyfile will work with latest Versions of program.

  @{i}@{fg highlight}Payment@{ui}@{fg text}

   Registering RunBar costs US $15.

   You will can receive your keyfile only by e-mail.(I have no time
   for diskettes p&p).

   Please send only @{b}@{u}BANKNOTES CASH@{ub}@{uu} and @{b}@{u}US$@{ub}@{uu} , not other cash is
    @{b}@{u}SUPPORTED@{ub}@{uu}.

  @{i}@{fg highlight}If you want to register , lets go...@{ui}@{fg text}

   1) Please wrap your banknotes in a sheet of paper so they are not
      visible from outside.Insert cash to envelope and
      send it to me.

   2) Also you must include this information:

      Name: ____________________

      Country:__________________

      E-Mail:___________________

      Amiga model:______________

   3) Wait for UU-ENCODED keyfile via e-mail.
@endnode

@node "Installation" "Installation"

 @{i}@{fg highlight}Installing RunBar@{ui}@{fg text}

  An Installer script is included in the archive, which makes
  installation easy.You must have AT Installer program in C:
  drawer for this script.
@endnode

@node "Distribution" "Distribution"

 RunBar is Copyright (c) 1996 @{fg highlight}Sergej Kravcenko@{fg text}
           All rights reserved

  You can freely distribute it, IF:

    @{fg highlight}*@{fg text} No files in archive is changed

    @{fg highlight}*@{fg text} The distribution is not part of a commercial product.
      (Contact author for more info.)

    @{fg highlight}*@{fg text} Personal key file @{b}@{u}NOT INCLUDED@{ub}@{uu} into archive.

  No guarantee given, use program on your own risk.

  You can freely distribute @{b}Find@{ub} and @{b}Clock@{ub} programs, it FREEWARE.
@endnode

@node "Author" "About Author"
 Please if you find a bug send to me all possible information about your
hardware and software config ,including paths and operations using in
program.

By E-Mail: @{i}@{fg highlight}dlife@pub.osf.lt@{ui}@{fg text}

By   Mail: Sergej Kravchenko
           Gelvonu 58-7
           2010 Vilnius
           Lithuania

Also you can find me on IRC:

   Efnet - #insector, nickname - DLife
   Undernet - #AmigaCafe, nickname - DLife
@endnode

@node "Window" "Window"


  POPUP RunBar window:

    Move mouse pointer to bottom of workbench screen,RunBar window
    appears there.Press Start button to POPUP main window.

    Also you can popup window with Hotkey (default F1.
    If you want to change HotKey then edit ToolType list in
    RunBar icon. You can find it in SYS:WBStartup directory)

    Select menu items by moving mouse poiner over it.

  ShutDown:

    Move mouse pointer right and popup second window.From it you can
    select:

      Quit - Exit.

      Reboot - reboot computer.

  Command:

    Execute command string.

  Utilities:

    Now two utilities are supported.

      Clock - clock.

      Find - file finder. (At this time I have no time to write my own
                           find utility.Rename any find utility to "Find"
                           and copy it to SYS:Utilities directory.)

  Prefs:

    This is directory SYS:Prefs mirror.You can start from here prefs
    programs.

  Programs:

    From this window you can start your programs.

    At first program run this window don't contain any item.
    To add item move mouse pointer right, and popup window with
    "Empty" item. Move mouse over this window, press right mouse
    button and keep it pressed, Select one of four options:

    Add Drawer:  Add drawer to current window.

    Rename: Rename current highlighted item or drawer.

    Remove: Remove current item or drawer:

    Add File: Add programs to current window.
              (New window will open. Drop program icon into this window
               and select program type.Then press OK button).
@endnode

@node "Bugs&Errors" "Bugs&Errors"

 @{fg highlight}Bugs@{fg text}

  No bugs found at this time.
@endnode

@node "Prefs" "Prefs       "


   From this program you can setup this options:

  @{fg highlight}Global...@{fg text}

    CX Priority - Commodity priority.

    Popup delay - Delay before popup 1 delay is 1/5 seconds.

    HotKey      - Hot key to popup window.(Use only valid Hotkeys,
                  otherwise program don't run.

    Screen      - RunBar popup screen.
 
    Spacing     - Spacing between items.

    Middle b.p. - If set you can use Middle mouse button as HotKey.

  @{fg highlight}Commodities...@{fg text}

    You can remove commodities from RunBar.

    Example: In my system I have commodity MultiCX and I don't want
             to see it in RunBar.Then, I add it to "skip list" and
             it makes not visible from RunBar.

    To add commdity here, simple add commodity name (like "MultiCX")
     to list.

    New         - Add new name.

    Remove      - Remove name from list.

  @{fg highlight}Prefs...@{fg text}

    You can skip Prefs from Prefs menu like commodities.

    Double click to first list to add Prefs to skip list.

    Double click to second list to remove item from skip list.

  @{fg highlight}Utilities...@{fg text}

    You can add up to five your own Utilities in program.

    To add Utility press on checkbox, then you can input Utility
    name and select program.
@endnode

@node "Exchange" "Exchange    "

  Using RunBar you can control programs like from standart WB
  Exchange program.


  Move mouse pointer to bottom of screen.RunBar window popup and
  if in your system exists some commodities you will can see buttons
  with commodity names.

  @{fg highlight}Operations with buttons...@{fg text}

    Press button - You send standart "Show Interface" to current program.

    Press and hold right mouse button over commodity button - Little
     command window popup from here you can select commands:

     Hide - Standart "Hide Interface" command.

     Activate/Deactivate - Standart Activate/Deactivate commands.

     Quit - Standart "Remove" command.
@endnode

@node "Support" "Support     "



  If you want make RunBar support in your program, you must know!!


  1) You must create Commodity port in your program.

  2) When you recive CXCMD_KILL you must quit from program.

  3) When you recive CXCMD_DISAPPEAR you must close all window
          and wait for CXCMD_APPEAR.(It possible to recive
          CXCMD_DISAPPEAR when your program is already hidden).

  4) When you recive CXCMD_APPEAR you must open all window.
          (It possible to recive CXCMD_APPEAR when your program is
          not hidden).

  5) CXCMD_DISABLE/CXCMD_ENABLE you can use as you want.
@endnode

