MACD 4

home *** CD-ROM | disk | FTP | other *** search

/ MACD 4 / MACD4.iso / cdity / wc37_53.lha / WinCommodity / WinCommodity_eng.DOC < prev next >

Wrap

Text File | 1996-10-13 | 18.7 KB | 541 lines

WinCommodity 37.52 WinCommodity ©1996 by «Michael Gollmick» This documentation describes the program WinCommodity, the useful utility for the dayly work with your Amiga. WinCommodity requires at least version 2.04 of the AmigaOS. - GENERAL - « Introduction » « Installation and start » « About the program » - BASICS - « Usage » « Preferences » - FUNCTIONS - « Function overview » - APENDIX - « Known Bugs » « The future » « History » About the Program Actual version: 37.52 This program is «MAILWARE» (see «Distribution»). WinCommodity has prooven to be stable in everyday use WinCommodity was written in AmigaE and compiled using AmigaE v3.2e. WinCommodity provides 7 functions this time: «CenterWins » - centring the active Window «ParentWin » - move window below its previous one «ZipWin » - minimize/maximize the active window «CloseWin » - close the active window «CloseWBWins» - close all workbenchwindows «ToggleWins » - activates the next window «TopLeft » - move window to left upper corner of screen This functions may be installed, but do not need to be installed at all. Preferences The preference-settings are really simple. Mark the WinCommodity-Icon by clicking on it once with your mouse. Call the menuitem 'Pictogram/Information'. Now you can edit the Icon-Tooltypes. The included Icon has all possible Tooltypes entered, you need only to change them for your wishes, if necessary. So, if you want to change a Hotkey, it need to be named it the following format: <CX_FUNCTIONNAME=rawkey> + your keycombination Here you have TO enter standard workbench-key-names! (i.e. 'lalt' FOR the left Alt key, 'lcommand' FOR the left Amiga key). IF you have SET all preferences, click on the Gadget 'Save' AND the changes will take effect at next start of WinCommodity. The installed key-combinations may be shown while WinCommodity is running. Herefore you have to call the GUI of WinCommodity. Since there is no Hotkey for the GUI you have to do this via the Commodity-Control-Program 'Exchange'. (In my opinion there is no sense in making a hotkey for a gui, I may need once a month, if I would need as often...) IF this GUI is called, a requester appears, which shows all disposable functions AND its hotkeys. IF a hotkey has not been accepted by the program, the function is not disposable AND the requester says 'NOT INSTALLED' FOR this feature. Example-Configuration: «CX_CENTERKEY » -- F1 «CX_CLOSEACTIVEWIN» -- Control w «CX_CLOSEWBWINS » -- Control LAmiga w «CX_PARENTKEY » -- F2 «CX_PRIORITY » -- 0 «CX_TOGGLEKEY » -- LAlt Tabulator «CX_ZIPKEY » -- F3 «CX_TOPLEFTKEY » -- Control F2 TopLeft This function moves the active window to the left top border of its screen. But WinCommodity does not choose the physical 0,0-position of the screen, it chooses the position directly below the ScreenBar. ToggleWins This function toggles between the windows. If called, the next window in screens window-structure will be activated an popped to front. WinCommodity cares about borderless or backdrop-windows and does not activate them. (This funtion has been adapted from X-Windows) CloseWBWins This function is nearly similar to «CloseWins», except that WinCommodity does only close Workbench-Windows and does close all it can find (not only the active one). Workbench's main window will not be closed. The Idea of this function is old, it has been adapted from the MacOS not only once. But I newer before saw such a unction, which does not try TO close the Workbench-main-window. --> Here it is necessary TO do a remark. This function is fast! But it may become timeful if you do open too much windows, since it first scans all windows and then it starts closing the Workbenchwindows, beginning with the most back one. Herefore it has to allocate memory for each window (for programmers: this is a recursive function). Do, if you have too many windows open, layers.library starts to become slow, because of the lot windows and WinCommodity has to wait for each window to be closed. This can take a lot of time. Example: On my machine, an A1200 with 28MHz 68020 processor and 10MB it took around 6 mins to close 60 Workbenchwindows! (But how often do you open more than 60 Workbenchwindows???) CloseWin This function does the same as a click on the CloseGadget of a window. 1) In PageStream3, there is a non-standard system of Inuition-Message-handling. Therefore PageStream3-View-Windows will not be closed - they will be minimized! ...Not my fault. CenterWins This function centers the active window on its screen. The screenbar is ignored in the calculation. ParentWin This function moves the avtive window below the window-topborder of its parentwindow. This function is really useful, if you want to have some arrangemant in your directory-structure. IF there is no parentwindow, the window will be placed below the screenbar, just like with «TopLeft». ZipWin This function does the same as a click on the Zip-Gadget of a window: The window will be sized to minimum/maximum size -CX_CENTERKEY: Here you enter the keycombination FOR the windowcentering. IF you want TO change the presetted value, you have TO enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' FOR Ctrl + ESC keys) General information «Copyright » WinCommodity is MAILWARE! «Disclaimer » Warranty «Requirements» an Amiga :-) «Arisement » Wie kam's dazu? «Thanks » Arisement As other users, I was a bit angry for a long time about some misse dfeatures in the AmigaOS, I knew from other platforms. One day I got a small program, promising a bit help. It brought me one of the missed functions AND this one was not really good codet, so I got Problems using this program. Therefore I decided TO give my very best in coding this FOR my own AND also implement all the other features. Some problems at start were solved AND so the program growed. There was only one more Problem: The documentation. But one day I had a readable Doc (in german) putted it together AND publicated it. THEN I continued developing AND this is exactly what you can see now! So I wish you the very best with my program AND I hope I fill the gap, the AmigaOS had FOR me, also FOR you. Distribution ------8<------------------------------------------------------------------- This software is subject to the "Standard Amiga FD-Software Copyright Note" It is <type_of_software> as defined in paragraph 4b. If you like it and use it regularly, please send an E-mail or postcard to «me». For more information please read «AFD-COPYRIGHT» (Version 1 or higher). ------8<------------------------------------------------------------------- With other words: This program is freely distributable and should be copied to nearly almost everyone you know! If this program is included into any PD-collection i strongly please for a short notification/request, since there is possibly a more actual version finished and I also want to be on the run about the publications of my software. «Disclaimer» Requirements You only require Kickstart 2.04 or higher for running WinCommodity The following System-Libraries will be also required: icon.library v36 intuition.library v37 commodities.library v37 intuition.library v37 dos.library v37 This librarires are already inside your Amiga, so don't panic if you can't find them in LIBS: (they are in the Kickstart-ROM). Usage WinCommodity is a Commodity. It may be put into the directory SYS:WBStartup, and will then be loaded after each reset. WinCommodity provides its functions via Hotkeys. This Hotkeys are «configurable». It is useful TO choose this Hotkeys in a easy TO reach AND also logical way. The included Icon has a demo-configuration, which has the following presets: «CX_CENTERKEY » -- F1 «CX_CLOSEACTIVEWIN» -- Control w «CX_CLOSEWBWINS » -- Control LAmiga w «CX_PARENTKEY » -- F2 «CX_PRIORITY » -- 0 «CX_TOGGLEKEY » -- LAlt Tabulator «CX_ZIPKEY » -- F3 «CX_TOPLEFTKEY » -- Control F2 As a Commodity, WinCommodity is accesable via the 'Exchange'-Utility. Here you also can activate the GUI of WinCommodity. With 'Exchange' you can quit WinCommodity, if this would ever be necessary. WinCommodity also quits for itself if you start it twice. (without any notice!) Calling the functions is really easy after starting WinCommodity: Press the Hotkey-combination of your choice AND its function will be called. Example: FOR centering the active window, press 'F1'. The window will be centered right now. Now there should be no more problem using WinCommodity -CX_PRIORITY: The priority, the Commodity will get in the AmigaOS. It is presetted TO '0'. IF you can't HANDLE the term 'priority', be aware of this value! -CX_CENTERKEY: Here you enter the Hotkey FOR window centering. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) -CX_PARENTKEY: Here you enter the Hotkey FOR the windowmoving below its parenwindow. The parentwindow is the window which is directly parent TO the active one, so it need'nt TO be the physical parent one IF you want TO change the presetted value, you have TO enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' FOR Ctrl + ESC keys) -CX_ZIPKEY: Here you enter the Hotkey FOR Ziping the window. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) -CX_TOGGLEKEY: Here you enter the Hotkey FOR toggling between the windows. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) -CX_CLOSEWBWINS Here you enter the Hotkey FOR closing all Workbench-windows. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) -CX_CLOSEACTIVEWIN Here you enter the Hotkey FOR closing the active window. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) -CX_TOPLEFT Here you enter the Hotkey FOR moving the window on the left border below the screenbar. If you want to change the presetted value, you have to enter the followin: rawkey, followed by the keys, you want tho activate this function. (i.e. 'rawkey ctrl esc' for Ctrl + ESC keys) Installation Simply use the Installer-Script, I hardly tried to create one which is perfect for the first installation as also for updates. (You will need the 'Commodore Installer' FOR this script) If you really don't want to use this Script, you should put the Program to the directory you want to have it to and put the file 'WinCommodity_eng.Guide' to your documentation-directory (usually this is 'HELP:') There are some files in the directory which will not be copied, but may be interesting for you: - 'CHANGES' a german textfile withe the last changes in the program - '.HISTORY' the full history of WinCommodity (in english) If you are a programmer, the 'dev/' directory may be interesting for you. There are includes for AmigaE in 68000, 68020 and 68040-version and also autodocs in AmigaGuide© format. Bugs At the moment I don't know any Bug. WinCommodity does really work fine on my machine. IF you do get problems using WinCommodity OR IF you have any idea FOR it OR IF you want TO do a translation, contact «me». The fastest way is as ever an e-mail, but a letter will also do it. IF you want TO get the latest version WinCommodity, put the the amount of 5,-DM (german marks) in your currency into the letter AND it TO me with some lines I will send you a disk with the latest version of WinCommodity AND other software of mine. (This money is only FOR saving my own costs) The future The future of WinCommodity belongs to you. If I will get enough feedback and some new ideas, I will continue developing. If there are any bugreports, I will fix that bugs and make a new version. WinCommodity is MAILWARE AND will stay MAILWARE. It will not become Shareware at any time! If you have any idea for WinCommodity, send it to «me»! Credits Many thanks to: Rene Kotte - who hardly worked on getting an include for me, which was lost on my system kelly.uni-paderborn.de - the ftp-server, which had this include Pascal Behrend - which gave me a really good tip for closing a window via Intution.library-notification Commodore - for the best computer in the world EsCOM - which got bancrupty for my dearest Computer :-)) VisCorp - which could get the bancrupty-rests in the last moment and hopefully will do a bit more with it as EsCOM Wouter van Oortmerssen - for his genious AmigaE History The historical notes are listed here in the sort of its publication. A full history is available in the archive in '.HISTORY'. 22 Sep 1996 : 037.052 : functions will now only be installed IF they are named in the icon, else they are shown as 'NOT INSTALLED' in Config-Window about() is overworked now - shows config internal optimization and a new feature addet: lefttop() - window will be moved to the left top corner, 040 version is now compiled as a true 040 version (has been a mix from 020 and 040 version before 06 Sep 1996 : 037.045 : about() addet, broker is is now mounted as one with GUI, code optimized, ERROR now BEEPS the screen, better Kickstart-Checking, Installer-Script addet, now 020 an 040 Versions 02 Sep 1996 : 037.040 : ToggleWins() does not activate BackdropWindows anymore. Borderless- Nonmovable and Backdrop- windows will not be centered nor moved anymore 01 Sep 1996 : 037.035 : WBenchMainWin will not be closed anymore 21 Aug 1996 : 037.025 : initial release Adresse: Michael Gollmick Lepsiusstraße 6 06618 Naumburg/Saale Germany e-Mail: wir94dgk@zaix340.rz.uni-leipzig.de IRC nickname: qualle channels: #leipzig, #amigager ..not available at the moment - sorry! to contact me use my «address». __ __ *====================================* __ __ / // / * Standard Amiga FD-Software * / // / / // / * Copyright Note (TM) * / // / / // / *====================================* / // / __ __ / // / * * __ __ / // / \ \\ \/ // / * Version 1.1 - English * \ \\ \/ // / \ \\/ // / * 27-Feb-1995 * \ \\/ // / \ / // / * * \ / // / """ "" *====================================* """ "" 0. INTRODUCTION =============== If you are a user I hope you like this Standard Copyright Note for Free Dis- tributable Amiga Software you only have to read once instead of individual notes. There are translated versions of this document available on Aminet named: /pub/aminet/docs/misc/AFD-Files1-xx.lha (xx = number of languages). If you are a software developer and want to include this document in your own FD package then please read it carefully first, especially chapter 5 "DEVELOPERS INFORMATION". Thank you for your support. 1. COPYRIGHT ============ a. This software is copyrighted by its developer(s). That means that you are NOT ALLOWED to modify the program(s) and documentation in any way. Especially you MUST NOT REMOVE the documentation or this text file. b. You are NOT allowed to use this software or any part of it for any other purpose than that one mentioned in its documentation, this also includes any fonts, images or samples. If the developer(s) did NOT include the source code of the program(s) in this package you are NOT allowed to de- compile any part of it. 2. DISTRIBUTION =============== This package is freely distributable. That means you are allowed to re- distribute this package as long as you follow these points: a. Any re-distribution has to include all files in this archive, including this "AFD-COPYRIGHT" file, without any modifications. You are NOT allowed to add any files to the archive. b. This package may be freely distributed via BBSs, InterNet/UseNet, software libraries such as Fred Fish's and Aminet CD-ROM, and other similar electronic channels. c. Disk magazines and services that charge extra for file transfers may NOT distribute it without written permission by the developer(s)! 3. DISCLAIMER ============= By using this product, you accept the FULL responsibility for any damage or loss that might occur through its use or the inability to use it. The developer(s) of the software and the author and the translators of this "Copyright Note" can NOT be held responsible. IMPORTANT: The author and the translators of this "Copyright Note" do NOT give any guarantee for the quality and usefulness of ANY products that are subject to this note!!! 4. RETURN SERVICE ================= "Free distributable" only says that you do not have to pay for copying or re- distributing the software. You are allowed to test this product for 30 days. If you like it and decide to use the product regularly, most of the develo- pers want something in return for their efforts. The documentation of this software contains one classification out of these: a. Freeware - You are allowed to use this software FREE. b. Mailware - You have to send the developer(s) a MESSAGE (by email or snailmail). c. Cardware - You have to send the developer(s) a POSTCARD. d. Donationware - You have to make a DONATION to an organisation as stated in the documentation to this product. g. Giftware - You are requested to send the developer(s) a GIFT, for example: - some candy or - a package of disks or - a copy of a self-made program or - some money or - an Amiga 5000 PowerTower ;-) s. Shareware - You have to send the developer(s) the amount of MONEY demanded in the documentation.