@database RunBar @master RunBar.guide @$VER: 3.1 @author "Sergej Kravchenko" @(c) "Sergej Kravchenko" @remark RunBar @node "Main" "RunBar Guide" /-----| /-----| / / / / / / / / /------/ / / /--| /------/ /---/ /---| / | / / / / / / / / / / | / / / / / / / / / / | /___/ / / /______/ /___/_ / Run Bar 3.1 (c) 1996 @{b}@{fg highlight}Sergej Kravcenko@{ub}@{fg text} Date of release -- 24 November 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 @{"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. @{"Programs    " link "Programs" 0} - Ultimate programs control port. @{"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. @{fg highlight}Henri Veistera@{fg text} For RunBar images. @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. @{fg highlight}Version 2.4@{fg text} Configurable images. ASL requester in Command window. Fixed Command execute bug. Changed clock font. Prefs caching. Add,Remove,NewDrawer,Command windows now font sensitive. New menus access method. @{fg highlight}Version 3.0@{fg text} Full font and images sensetive. Anim on/off. Prefs state remember. Show prefs only with icons.(Optional) 100% standard code.(No hacks and etc.) Windows control.(No only commodities) Keyboard control. Items Add and Edit improvement. @{fg highlight}Version 3.1@{fg text} New ULTIMATE program control Port. (SDK included). Turn off - safe computer turn off (Unmount all devices). Different window borders. Recessed items selection. Removed keyboard control bug. Quit,Turn off,Reboot,Remove requesters. @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_2.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 "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. 2) Then you get YOUR OWN Full version. @{i}@{fg highlight}Payment@{ui}@{fg text} Registering RunBar costs US $15 or 25DM or 10£. You will can receive your update 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}. Because I hve some problems with cash changing, please send only @{b}NEW@{ub} or not @{b}LONG USED@{ub} banknotes. @{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 update 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} You can distribute only @{b}@{u}DEMO VERSION@{ub}@{uu}, not @{b}@{u}FULL@{ub}@{uu}. 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@post.5ci.lt@{ui}@{fg text} or @{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: 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 is F1.) or with middle mouse button ,if this function enabled. Select menu items by moving mouse poiner over it. If you want open second menus move mouse pointer to right of current menu or press left mouse button ,or wait time delay if you use Time Delay access method. ShutDown: Quit - Exit. Reboot - reboot computer. Turn Off - Unmount all volumes and you can safe turn off computer. Command: Execute command string. Utilities: Now seven 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.) Also you can add up to 5 your own Utilities. 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). Windows control: When RunBar popup you can see buttons with windows names.Press on this buttons if you want move this window to front and make it active. @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} Popup delay - Delay before popup 1 delay is 0.2 seconds. HotKey - Hot key to popup window.(Use only valid Hotkeys, otherwise program don't run. Screen - RunBar popup screen. Control - You can control Commodities&Windows, only Commodities or only Windows. Border - Window border type. Access menus time delay - Delay before open second menu. 1 delay is 0.1 second. 12hour clock- You can select 12/24 clock system. Middle b.p. - If set you can use Middle mouse button as HotKey. Prefs Caching - Use prefs caching. Show Anim - Anim on/off. @{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. Remember prefs position - Remember last prefs menu position. Prefs only with icons - Show prefs only with icons. @{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. @{fg highlight}Layout...@{fg text} Images - Images width selector. Font - Menu font. Spacing - Adding extra 2 point between items. Recessed - Recessed items selection. @{fg highlight}Images...@{fg text} Width - Images width. Height - Images height. Load Images - Load Images from IFF ILBM file and convert it to RunBar format with current selected width and height. (Example file is included). View Images - View current images. @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). If window already open, then you must Activate it and pop to front. 5) CXCMD_DISABLE/CXCMD_ENABLE you can use as you want. 6) If you want create RunBar plugins, see Develop dir for more info. @endnode @node "Programs" "Programs" Now RunBar have new feature - programs control port. In archive included two programs FilterControl and CpuControl. When you run this programs, around RunBar clock you can see small pictures, press and hold right mouse button over it. Now select needed function and release right mouse button. If you want support that RunBar feature in your program, see Develop dir for more info. @endnode