@DATABASE CxBar.guide @MASTER "HELP:english/CxBar.guide" @$VER: CxBar_english.guide 37.20 (26.04.97) by Thomas Igracki @AUTHOR Thomas Igracki @(c) by Thomas Igracki @WIDTH 78 @NODE Main "CxBar Documentation" @{b}/@{ub} @{b}@{fg shine}CxBar@{fg text} v1.51 /@{ub} by Thomas Igracki _______________@{b}/@{ub} @{" AFD - C O P Y R I G H T " link AFD-COPYRIGHT/Main} @{" What should be in the archive? " link Archiv } @{" The history of the program " link History} @{" What is it for? " link WhatItIs } @{" How to contact me? " link Me } @{" How to start? " link HowToStart} @{" How to register? " link Register} @{" Description of the menus " link Menus } @{" How to get Updates? " link Updates} @{" Description of the arexx commands " link ARexx } @{" The Magic-User-Interface " link MUI } @{b}---------------------@{ub} @{fg shine} This software is subject to the "Standard Amiga FD-Software Copyright Note" It is @{"SHAREWARE" link AFD-COPYRIGHT/Main 99} as defined in paragraph 4s. [...] For more information please read "AFD-COPYRIGHT" (Version 1 or higher). @{fg text} @ENDNODE @NODE Archiv "CxBar/What should be in the archive?" The following files should be in the archiv: @{LINDENT 3} @{b}tools/VPI@{ub} --> a viewer for Product-Info files @{b}env/mui/CXBAR.prefs@{ub} --> mui prefs file for CxBar @{b}env/mui/CXBAR.cfg@{ub} --> my config file for CxBar I highly suggest you to copy this to your @{b}ENV:MUI/@{ub}, cause this is the way I wanted @{b}CxBar@{ub} to look like! @{b}catalogs/deutsch/CxBar.catalog@{ub} --> german catalog @{b}catalogs/deutsch/CxBar_D.ct@{ub} --> german catalog-translation @{b}catalogs/CxBar_blank.ct@{ub} --> blank catalog-translation @{b}help/deutsch/CxBar.guide@{ub} --> german documentation, AmigaGuide-Format @{b}help/deutsch/AFD-COPYRIGHT.de@{ub} --> german COPYRIGHT-Note @{b}help/english/CxBar.guide@{ub} --> english documentation, AmigaGuide-Format @{b}help/english/AFD-COPYRIGHT@{ub} --> english COPYRIGHT-Note @{b}Registration.txt@{ub} --> english registration formular @{b}Registrierung.txt@{ub} --> german registration formular @{b}Product-Info@{ub} --> product info @{b}Preview.gif@{ub} --> preview picture of @{b}CxBar@{ub} @{b}CxBar.readme@{ub} --> short english doc, ASCII @{b}CxBar.liesmich@{ub} --> short german doc, ASCII @{b}CxBar@{ub} --> the program @{b}CxBar.info@{ub} --> icon for the program @ENDNODE @NODE WhatItIs "CxBar/What is this program for?" @{LINDENT 3} This program controls all commodities in your system. It is an alternative for the normal Exchange and uses the @{" MagicUserInterface " link MUI} by Stefan Stuntz. The difference between C='s (or AT's) Exchange and @{b}CxBar@{ub} is that @{b}CxBar@{ub} displays the commodities as buttons (cycles) in a horizontical or vertical (switchable!), one-line (bar) or one-row virtual group. Every button has a help-bubble which shows the title and the description of the commodity and informs you if it has a window which can be shown and hidden ("GUI: YES" or "GUI: NO"). Also you can turn on a @{"size-gadget" link Menus} to size the window and a drag- gadget to change the window's position. The size-gadget appears on the right or bottom and the @{"drag-gadget" link Menus} on the left or top. You can also have the window the normal/intuition windowborder incl. all @{"bordergadgets" link Menus}. @{b}CxBar@{ub} has also some @{"arexx commands" link ARexx} to control the commodities via arexx and is localizied! The help-bubble of @{b}CxBar@{ub} looks like this: ____________________________________ / \\ | CxBar 37.20 (26.04.97) by T. Igracki | | A new Exchange clone. | | | | GUI: YES | \\___ _______________________________/ \\ \\ \\ \\ \\/ If you click on a button (left mouse) a popupmenu will be shown where you can select one of the following commands/actions: ---------- | Remove | -> remove/kill the commodity (w/o requester!) | Disable | -> deactivate the commodity | Enable | -> activate the commodity | Hide | -> hide the commodity/window | Show | -> show/popup the commodity/window | Exchange | -> the name of the commodity, no function ---------- If the menu entry @{"Options/Toggle Activity?" link Menus} is selected, then the popupmenu looks like this: ---------- | Remove | | Toggle | -> toggle the activity | Hide | | Show | | Exchange | ---------- If a commodity didn't has a window/GUI to popup/hide the entries @{b}Hide@{ub} and @{b}Show@{ub} won't be there! If a commodity is inactive the name will be shown in italic style. Hint: If you have a three-button-mouse, you can use the middle button to scroll the buttons to the left or right! If not set @{"Option/Scrollbar?" link Menus}. @ENDNODE @NODE HowToStart "CxBar/How to start" @{LINDENT 3} @{b}Start from a shell:@{ub} [Run] [<>NIL:] @{b}CxBar@{ub} @{b}Start from Workbench:@{ub} Just double-click the icon. Its the best, if you copy @{b}CxBar@{ub} to the WBStartup-Dir or start it in User-Startup. @ENDNODE @NODE Menus "CxBar/Description of the menus" Project About... ? - Some infos about CxBar About MUI... - Some infos about MUI -------------- Hide H - Hide CxBar's window. -------------- Quit Q - Quit CxBar immediately. Options Window position >> - A submenu to quickly set the position of the window to the top (under the titlebar), bottom, left or right of the screen. Snapshot - Snapshot the windows position and size (just like the item in the windows popup-menu) UnSnapshot - UnSnapshot the windows position and size (just like the item in the windows popup-menu) ------------------ Scrollbar? 1 - Should there be a scrollbar? Its for scrolling the virtualgroup if you don't have a 3-button-mouse else you can use the middle button for scrolling! Vertical? 2 - Vertical or horizontal buttons? Iconify gadget? 3 - Should there be an iconify gadget? Same as Project/Hide. Presented by a button with an "I" at the left or top. The hotkey is "numpad *". Drag gadget? 4 - Should there be a drag gadget to drag the window? Presented by a blank button on the left or top to set the position of the window. Size gadget? 5 - Should there be a size gadget to size the window? Presented by a blank button on the right or bottom to change the size of the window. Window gadgets? 6 - Windowborders incl. all bordergadgets? Toggle Activity? 7 - One or two commands for changing the activity? ------------------ MUI... 0 - Set MUI-specific settings ------------------ Use - Use settings Save - Save settings @ENDNODE @NODE ARexx "CxBar/Description of the arexx commands" Here the output of MUI's ARexxCommand HELP to show you which commands @{b}CxBar@{ub} understands: @{LINDENT 3} Standard-Commands: Command Template ------- -------- quit FORCE/S hide deactivate show activate info ITEM/A help FILE/A Commands for application "Exchange": Command Template ------- -------- CX NAME/A,SHOW/S,HIDE/S,ON=ENABLE/S,OFF=DISABLE/S,KILL=REMOVE/S CxList VERBOSE/S CxGet NAME,TITLE/S,DESCR/S,ENTRIES/S @{LINDENT 0} For the standard commands please see the mui docs. Commands for application "Exchange": CX NAME/A,SHOW/S,HIDE/S,ON=ENABLE/S,OFF=DISABLE/S,KILL=REMOVE/S --------------------------------------------------------------- @{LINDENT 3} The command @{b}CX@{ub} send the commodity specified by the parameter @{b}NAME@{ub} one of the following commands: SHOW : pop up the window (if it has one) HIDE : hide the window ON or ENABLE : enable the commodity OFF or DISABLE : disable the commodity KILL or REMOVE : remove the commodity If more then on of these parameters are given, then only the first (in the above order) will be used! NAME can contain AmigaDOS-Pattern, and all matching names will receive the command! The name is compared with no case and if it has spaces you have to quote the name or use wildcards! If an error occured, maybe you forgot the NAME or the NAME doesn't exists, the ARexx variable RC will contain a number unlike 0. Examples: CX exchange show --> popup @{b}CxBar@{ub}s window CX #? show --> popup the window of all commodities! CX #? hide --> hide the window of all commodities! CX #? off --> disable all commodities! CX exch#? show kill --> only popup the window of all commodities matching this pattern. They don't get killed, cause SHOW will be checked first! @{LINDENT 0} CxList VERBOSE/S ---------------- @{LINDENT 3} The command @{b}CxList@{ub} is used to get a list of all currently running commodities. If the parameter @{b}VERBOSE@{ub} is specified, then the list will contain more infos, not only the names. The names will be also quoted. The ARexx variable RESULT (only if you called "OPTIONS RESULTS" before!) will contain the result of the command. Examples: Here is the output of @{b}CxList@{ub} on my system: Directory Opus 5 EasyCED Exchange Executive Magic Menu MCP ModePro OMouse OMouse.gui OOL Scout ScreenClock YACE And this is the output of @{b}CxList VERBOSE@{ub}: "Directory Opus 5" GUI Active "EasyCED" NoGUI Active "Exchange" GUI Active "Executive" NoGUI Active "Magic Menu" GUI Active "MCP" GUI Active "ModePro" GUI Active "OMouse" GUI Active "OMouse.gui" GUI Active "OOL" GUI Active "Scout" GUI Active "ScreenClock" GUI Active "YACE" GUI Active @{LINDENT 0} CxGet NAME,TITLE/S,DESCR/S,ENTRIES/S ------------------------------------ @{LINDENT 3} The command @{b}CxGet@{ub} returns the TITLE or DESCRiption from one specified commodity or the number of ENTRIES of all commodities in your system. NAME can contain AmigaDOS-Pattern, and all matching names will receive the command! The name is compared with no case and if it has spaces you have to quote the name or use wildcards! This option has to be specified if you use the option TITLE/S or DESCR/S! The ARexx variable RESULT (only if you called "OPTIONS RESULTS" before!) will contain the result of the command. Examples: @{b}CxGet Exchange TITLE@{ub} --> CxBar 37.20 (26.04.97) by T. Igracki @{b}CxGet "exc*" TITLE@{ub} --> CxBar 37.20 (26.04.97) by T. Igracki @{b}CxGet "exc*" DESCR@{ub} --> A new Exchange clone. @{b}CxGet "*opus*" TITLE@{ub} --> İ1996 Jonathan Potter & GPSoftware @{b}CxGet ENTRIES@{ub} --> 13 @ENDNODE @NODE Register "CxBar/Registering" @{LINDENT 3} You only have to fill out the @{"register formular" link Registration.txt} and send it to me. @{"Via eMail or snail mail" link Me}. You can also register direct on my homepage @{b}http://home.pages.de/~lokai/amiga/RegisterE.html@{ub}! The share for @{b}CxBar@{ub} is $10, 10DM or the appropriate amount of your countries money. @{"You can transfer it to my bank-account or send it in cash." link Me} In the @{b}unregistered@{ub} version there appears a requester from time to time which should remind you to pay the share! If you register @{b}CxBar@{ub}, you'll get a keyfile, which turns off the reminder-requesters. @ENDNODE @NODE Registration.txt "CxBar/Registration.txt" To: Please register me for "CxBar" Thomas Igracki Siegener Str. 34 13583 Berlin Germany _ FirstName: Name: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Street: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ZIP,City: Country: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ EMail: Phone: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Config: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Where do you get this programm? [ ] Aminet CD No. ŻŻŻŻ [ ] from my Homepage http://home.pages.de/~lokai/ [ ] ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Payment by: [ ] Cash (please don't send coins) [ ] $10 (US dollar) [ ] 10 DM (Deutsche Mark) [ ] Money transfer of 10 DM to this account: Thomas Igracki Sparkasse Berlin Account 860 169 138 BLZ 100 500 00 Write a little note (who you are etc) on the transferformular! Comment: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ (City, Date) (Signature) Thank you for registering CxBar! @ENDNODE @NODE Updates "CxBar/Updates" @{LINDENT 3} You can get updates/new versions directly by me via eMail (if you are registered) or from my homepage @{b}http://home.pages.de/~lokai/amiga/myprogs.html@{ub}! They can also be found in Aminet (util/cdity/CxBar.lha). I have also a Support-Mailbox here in Berlin/Germany! Its the JANA-Mailbox: +49 030/75702649. Go to the board /SUPPORT/IGRACKI/CXBAR. @ENDNODE @NODE History "CxBar/Programhistory" @{LINDENT 3} @{b}Release 1.51 (26.04.97):@{ub} Revision 37.20 1997/04/26 21:09:04 Fix: If "Menu/Options/Toggle Activity" is on, then "toggle" acts like "enable". @{b}Release 1.5 (22.04.97):@{ub} Revision 37.19 1997/04/22 19:36:17 New: ARexxCommand: CxGet NAME,TITLE/S,DESCR/S,ENTRIES/S Revision 37.18 1997/04/18 19:15:26 Fix: The (custom) drag- and sizegadgets were sometimes drawn as if the window is active, if CxBar just started. Revision 37.17 1997/04/12 23:23:10 Chg: Menu/Options/WindowPos turns to Menu/Window/Position New: Menu/Options/Toggle State? Do you want to "toggle" state of activity or "enable/disable"? @{b}Release 1.4 (19.02.97):@{ub} Revision 37.16 1997/02/19 20:52:36 New: HELP opens the AmigaGuide-Help. Revision 37.15 1997/02/18 15:37:59 Fix: Fixed a typo in RegisterText: This is an unregistered... New: menu/options/(Un)Snapshot to (un)snapshot the windows position and size. Fix: The virtual frame is now configurable. Chg: The Register-Reminder-Requester won't come up that often;-) Chg: If you start CxBar, when CxBar is already started the second CxBar will wait 2 seconds instead 1 second for the first CxBar to quit. @{b}Release 1.3 (30.09.96):@{ub} Revision 37.14 1996/09/30 16:00:20 New: Localizied strings. Arc: Included my Product-Info viewer "VPI", if you don't have it! Arc: Made the icons usable;-) @{b}Release 1.2 (22.09.96):@{ub} Revision 37.13 1996/09/21 18:47:49 Fix: Changed "Releas" in the About-Req. to "Release" Fix: SingleTask set to TRUE, so the MUI-Name of CxBar isn't CXBAR.1 anymore. It is now CXBAR. New: A ARexx-Command (CX) to control the commodities via arexx! New: A ARexx-Command (CxList) to get a list of the commodities via arexx! Chg: Replaced the command "toggle" by "enable" and "disable". @{b}Release 1.1:@{ub} Revision 37.11 1996/08/10 21:59:42 Fix: Set aInner(Left|Right|Top|Bottom) of the own drag/size gads to 0. Chg: The window doesn't closes&reopened if the Scrollbar should dissappear. Chg: The width of the drag&size gadget is a little bit smaller. Chg: Name of Menu-Settings "Move&Size window" to "Set window pos." New: Added Menu: Settings/Move Window to the/left. (here should start v37.12, but I forgot the CheckIn;-( New: Menu/Options/Move&Size window -> add intuition drag-/sizegadgets and border. New: Menu/Options/Window position/Top,Bottom,Right -> Move the window to the ... Chg: During creating/updating the buttons (eg. a new cx added) the application is put to sleep, I hope this will fix the startup problems. Revision 37.10 1996/07/30 17:30:58 New: Optional Drag- and Size-Gadget! New: The window's pos & size can be optionaly remembered. New: Switchable between vertical and horizontal buttons. Revision 37.9 1996/07/29 13:24:06 Fix: Now CxBar recognises if you (or a commodity self) change (s) the (his) activity (enable/disable). @{b}Release 1.0:@{ub} Revision 37.8 1996/07/20 13:40:48 tig Fix: Could crash on startup, if many commodities were started while CxBar is started. Started to use RCS. 37.7 (16.07.96): Chg: Changed hotkey "numpad *" to aControlChar "*" Chg: Changed some internal things 37.6 (15.07.96): New: Numpad * for iconify. New: Added Keyfile stuff. New: Added a scrollbar option, for 2-button-mouse owner. 37.5 (08.07.96): Chg: internal changes, extracted CxClass to own module New: Menu/Options/Iconify Gadget? New: Menu/Options/Use|Save New: If a cx is inactive, it will be displayed italic else normal 37.4 (05.07.96): Fix: On startup, some CxLstChgs wasn't received. 37.3 (02.07.96): New: Added CycleChain. Fix: Finally fixed problems with aShortHelp. New: Kill a running 'Exchange', if present at startup. New: If brokerList changes the virtGroup doesn't 'jumps' to left Now, it works like it should! 37.2 (01.07.96): Chg: Change the buttons from TextSubclass to CycleSubclass. Chg: Removed ContextMenus, choose commands from the Cycles. 37.1 (30.06.96): New: Added ContextMenus to call the brokercommands (show,hide..) 37.0 (29.06.96): New: First try, not fully functional. @{b}@{u}Abbreviations:@{uu}@{ub} New: Something new added. Chg: Something has changed. Fix: Some bugs removed. Doc: Documentation changed/improved. Arc: Added something to the archive (f.e. icons) @ENDNODE @NODE Me "CxBar/How to contact me?" @{LINDENT 3} If you have suggestions, bug reports or any question you can reach me by the following addresses, e-mail preferred! Z-Netz: T.Igracki@Jana.berlinet.de UseNet: lokai@cs.tu-berlin.de -or- T.Igracki@Jana.berlinet.de (preferred!) URL : http://home.pages.de/~lokai/ Mail : Thomas Igracki, Siegener Str. 34, Germany-13583 Berlin The share for @{b}CxBar@{ub} is $10, 10DM or the appropriate amount of your countries money. You can send it by cash or transfer it to the following bank-account: Receiver : Thomas Igracki Account : 860 169 138 BLZ : 100 500 00 (what is 'Bankleitzahl' in english???) Institut : Sparkasse Berlin Note : Share for CxBar If you send me an email, I will notify you if a new version is out and send it to you if desired! At least you should write me an email if like my program! Have fun with my program! @ENDNODE @NODE MUI "The Magic-User-Interface" @{LINDENT 3} This application uses MUI - MagicUserInterface (c) Copyright 1993/94 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @ENDNODE