home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / bbs / ff825.lha / FF825 / WComm / English / WComm.doc < prev    next >
Text File  |  2001-02-25  |  58KB  |  1,722 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 Documentation
  6.  
  7.                              WComm Version 1.80
  8.  
  9.                WComm the Window manipulation tool for the Amiga
  10.  
  11.  
  12. Index:
  13.  
  14.         What Is WComm
  15.         System Requirements
  16.         Legal Stuff
  17.         Installation and Start
  18.         CLI-Start
  19.         WBench-Start
  20.         HotKeys
  21.         List Of Functions
  22.         General
  23.         OS 2.04 Gadgets
  24.         The Main Window
  25.         The Exclusion Window
  26.         The Window Prefs Window
  27.         The Clock Prefs Window
  28.         The Palette Window
  29.         The Notify Window
  30.         The Clock Window
  31.         Error Handling
  32.         Technical
  33.         List Of Files
  34.         Address
  35.  
  36. What Is WComm:
  37.  
  38.     WComm is a standard commodity which enables you to manipulate windows
  39.     in different ways. WComm has 43 window manipulation functions. You are
  40.     able to:
  41.  
  42.         move,
  43.         enlarge,
  44.         minimize windows,
  45.         set windows to specified size and positions,
  46.         reset,
  47.         close,
  48.         zip,
  49.         tile,
  50.         cascade,
  51.         bring to front and back windows,
  52.         you can change to every screen and window,
  53.         etc..
  54.  
  55.     WComm has also the ability to notify the user about special dates.
  56.     Therefor you can insert the dates and times of this events in the
  57.     notify window. When the specified time is come, a requester will be
  58.     opened and an optional command can be started (EXECUTE, RUN or AREXX).
  59.  
  60.     WComm has also a user friendly clock with different kinds of date and
  61.     time formats. It has an alarm function and is fully user definable.
  62.  
  63.     WComm can exclude several given windows from some functions or even
  64.     include only some windows for this functions.
  65.  
  66.     WComm can set a window to a special position and size that can be given
  67.     by a settings list.
  68.  
  69.     WComm has a palette window which enables the user to manipulate the wbench
  70.     colours upto 256 colours.
  71.  
  72.     Each hotkey can be changed to the users needs.
  73.  
  74.     WComm can open a shell via hotkey which uses the path and stack which is
  75.     defined in the startup-sequence.
  76.  
  77.     WComm can kill windows which are left from other programs.
  78.  
  79.     WComm is a commodity and full controllable with exchange.
  80.  
  81.     WComm is full font independent. It sizes all windows and gadgets dependent
  82.     to the size of the current used wbench font. Also the tile and cascade
  83.     functions uses the height of the window title bars.
  84.  
  85.     You will see, WComm has a lot of features. So will not be surprised when
  86.     you hear WComm`s size is about 80 kb. But you can spare a lot of other
  87.     commodities if you are using WComm. Such as
  88.  
  89.         IntuiHelp,
  90.         clocks,
  91.         cron programs,
  92.         palette programs,
  93.         tilers and cascade programs,
  94.         window zappers etc...
  95.  
  96.  
  97.     WComm has a full gadtools user interface and enables the user to call
  98.     all functions with the mouse or even the keyboard.
  99.  
  100.     All windows and functions are fully asynchron that means all modifi-
  101.     cations of the settings will get visual immediate.
  102.  
  103.     WComm is controlled by several configuration files.
  104.     For each kind of functions exists a different configuration file. There
  105.     is an exclude, a window settings and a notify configuration file.
  106.  
  107.     All files have two default names which can be loaded automatically at
  108.     startup.
  109.  
  110.     Also WComm has aother configuration file which contains all values of
  111.     the hotkeys, window positions, clock settings etc...
  112.  
  113.     All configuration files can be modified, edited, loaded and saved from
  114.     the several windows.
  115.  
  116.     To get this more comfortable some configuration files can be edited
  117.     directly by the user with an text editor (see the sections about the
  118.     windows).
  119.  
  120.     Each hotkey can be changed and saved from the main window. The default
  121.     hotkey to open the main window is `control o`.
  122.  
  123.     More:
  124.  
  125.     WComm just supports some features of the new OS 3.0. So the palette window
  126.     is able to handle upto 256 different colours. WComm is able to recognize if
  127.     running on an OS 2.04 or OS 3.0 system.
  128.  
  129.     The design of some windows and gadget may be different under OS 3.0.
  130.  
  131.     The palette gadget owns no more indicator. The image of the currently
  132.     activated colour is displayed recessed.
  133.  
  134.     The listview gadgets doesn`t display a text gadget which indicateds the
  135.     currently selected entry. The selcted entry is indicated with an inverse
  136.     image.
  137.  
  138.  
  139. System Requirements:
  140.  
  141.     WComm needs OS 2.04 or better to run, because it is a standard commodity.
  142.     It is tested under OS 2.04 and 3.0 and runs (I hope so :-) with no errors.
  143.  
  144.     The memory usage of WComm is much dependent to the sizes of the several
  145.     lists. But it should run with no problems on Amigas with >= 1 MB memory.
  146.     To save although memory you can disable some functions, i.e. the notify,
  147.     and exclude functions. Also each hotkey which is disabled spares some
  148.     bytes, which will otherwise allocated by the system.
  149.  
  150.     WComm handles all resources and structures dynamically. That means: memory
  151.     will only be allocated when needed. If some structures will not be needed
  152.     anymore the memory for this will be given back to the system.
  153.  
  154.  
  155. Legal Stuff:
  156.  
  157.         This  program  and  all files come with it, also the docfiles, are
  158.         released as FREEWARE.
  159.  
  160.         this means:
  161.  
  162.             everybody may use WComm,
  163.  
  164.             everybody may copy WComm, if:
  165.  
  166.                 1. You copy all included files, see list at the end of the
  167.                    doc file.
  168.                 2. No changes are made,  this  means  the  program and all
  169.                    included files must stay in the original form.
  170.                    Exception: you  may  archive  it; but in this case you
  171.                               must also archive the whole package.
  172.                 3. If  you  decompile  it, you have to include a notice to
  173.                    the original author. If you also want to (re)distribute
  174.                    it in any new form, you have to send me a copy.
  175.                 4. You may not sell WComm.
  176.                    Execption: you`re  allowed  to  take  a  small copy fee,
  177.                               which should not extend 5US$.
  178.                 5. If you want to include WComm or one of the included files
  179.                    as a part of a commercial package, you must have  written
  180.                    permission from the author (address see below).
  181.  
  182.  
  183.         I take no warranty or guaranty for the function of this program.
  184.         The whole risk of using WComm stays only by the user.
  185.  
  186. Installation and Start:
  187.  
  188.  
  189.         Installation:
  190.  
  191.         The installation is very easy. First you have to copy all needed
  192.         configuration files of WComm to your envarc: drawer.
  193.  
  194.         1_> Copy #?.prefs ENVARC:
  195.  
  196.         Then the following file should be located in the envarc: drawer:
  197.  
  198.                 XWindow.prefs,
  199.                 ZWindow.prefs
  200.                 WComm.prefs
  201.                 Notify.prefs
  202.  
  203.         If you want to copy their icons too, you can type:
  204.  
  205.             1_> Copy #?.prefs.info ENVARC:
  206.  
  207.         You have to decide now if you want to run WComm at each startup
  208.         automatically or just sometimes. And if you want to start WComm
  209.         from wbench or cli.
  210.  
  211.         If you want to use WComm automatically after each startup you can
  212.         just drop its icon to your wbstartup drawer.
  213.         (see also section WBench-Start).
  214.  
  215.  
  216.         drawer. Check in this case if the `DONOTWAIT` tooltype is set.
  217.         Otherwise the WBench would wait until the program finishes.
  218.  
  219.         You can alternatively insert something like:
  220.  
  221.             Run >NIL: <NIL: WComm <arguments>
  222.  
  223.         into your User-Startup script.
  224.  
  225.         Alternatively you can insert a line into your user-startup file
  226.         i.e.:
  227.  
  228.             Run <path>WComm >NIL: <NIL:
  229.  
  230.         WComm understands also some cli arguments, you can pass to it at
  231.         startup. (See sections CLI-Start).
  232.  
  233.         If you want to use WComm just sometimes you could just drop its icon
  234.         into your commodities drawer.
  235.  
  236.         Alternatively you can copy WComm to your c: directory.
  237.  
  238.         1_> Copy WComm c:
  239.  
  240.         Start:
  241.  
  242.         WComm is a standard commodity. So if started the second time it will
  243.         be finished.
  244.  
  245.         If WComm is started it stays in the background and waits for receiving
  246.         messages. In this time no CPU time will be wasted, except the time for
  247.         the title clock.
  248.  
  249.         WComm can be controlled with the exchange tool. If you want to open
  250.         WComm`s main window and you have forgotten the hotkey you can use
  251.         exchange. You can also enable, disable and quit WComm with exchange.
  252.  
  253.  
  254. CLI-Start:
  255.  
  256.     When started from cli WComm supports the following arguments and
  257.     options:
  258.  
  259.     These arguments must follow this
  260.  
  261.     Syntax:
  262.  
  263.     WComm  [Config][CX_POPUP=P/S][WPrefs=W/K][EPrefs=E/K][CX_Priority=C/K/N]
  264.            [Nitify=N/K]
  265.  
  266.     Config
  267.  
  268.         this is name of the configuration file which should WComm load at
  269.         starttime. If you do not specify Config, WComm looks first for the
  270.         file `env:WComm.prefs` and then if not found for the
  271.              `envarc:WComm.prefs` file.
  272.  
  273.         If WComm cannot found the given or default configuration files, you
  274.         will get a requester which will inform you about this.
  275.  
  276.         The configuration file is a binary file and should not be edited
  277.         manually with a texteditor. Do not try this, or you will risk a
  278.         system crash.
  279.  
  280.     CX_POPUP
  281.  
  282.         This is a switch. If you specify it, WComm will open its main window
  283.         whenc started. The default is: do not open it.
  284.  
  285.     WPrefs
  286.  
  287.         This is the name of the window configuration file.
  288.         If you do not specify WPrefs, WComm looks first for the file
  289.         `env:ZWindow.prefs` and then if not found for the
  290.         `envarc:ZWindow.prefs` file.
  291.  
  292.         If WComm cannot found the given or default configuration files, you
  293.         will get a requester which will inform you about this.
  294.  
  295.         The window configuration file contains titles, positions and sizes
  296.         for some windows.
  297.         (See also section window settings window).
  298.  
  299.         This file contains only ascii characters and can be edited with a
  300.         texteditor. You have to use the following format:
  301.  
  302.         Each line represents one window,
  303.  
  304.         the window titles must not contain any whitespaces,
  305.  
  306.         AmigaDOS patterns in window titles are supported,
  307.  
  308.         after each value you have to insert a whitespace,
  309.  
  310.         no comments are allowed.
  311.  
  312.         Syntax: <window title> <X> <Y> <W> <H>
  313.  
  314.         WindowTitle: The window titel with optionally amigados wildcards.
  315.  
  316.         The pattern support enables WComm to recognize windows which titles
  317.         will be changed at any time such as wbench windows (when you copy or
  318.         delete something).
  319.  
  320.         Example:
  321.  
  322.                     RAM#?
  323.                             will match
  324.  
  325.                     Ram Disk 100% full 0 % free ...
  326.                     RAMDISK ...
  327.                     RaMDisK ...
  328.  
  329.         WComm will make no case sensitive difference. So RamDisK matches
  330.         RAMDISK and ramdisk etc.
  331.  
  332.         X:  This is the leftedge the window should be moved to.
  333.         Y:  This is the topedge the window should be moved to.
  334.         W:  This is the width the window should be resized to.
  335.         H:  This is the height the window should be resized to.
  336.  
  337.         This values can be activated with the function `Set to prefs`
  338.         (see List Of Functions). If the active window matches an entry
  339.         of this list, the window will be moved to the x and y positions and
  340.         resized to the w and h values.
  341.  
  342.         WComm can only move windows which contains a dragbar.
  343.  
  344.         WComm can only resize windows which contains a sizegadget.
  345.  
  346.         You can specify different settings for each window and save this to
  347.         disk.
  348.  
  349.         You can also specify a supergroup here. If you have some windows
  350.         with the same first chars and you want to change each one different
  351.         e.g.:
  352.  
  353.         for
  354.  
  355.         `Shell1`, `Shell2` and `Shell#?`, you can have an entry with
  356.         Shell1 and Shell2 and Shell. If you now got a window with title
  357.         `Shell4` the Shell#? entry will be used, instead Shell1 will only
  358.         use the `Shell1` entry.
  359.  
  360.  
  361.     EPrefs
  362.  
  363.         This is the name of the exclusion configuration file.
  364.         If you do not specify EPrefs, WComm looks first for the file
  365.         `env:XWindow.prefs` and then if not found for the
  366.         `envarc:XWindow.prefs` file.
  367.  
  368.         If WComm cannot found the given or default configuration files, you
  369.         will get a requester which will inform you about this.
  370.  
  371.         The exclude configuration file contains titles of windows which
  372.         should be excluded from some functions. So can e.g. exclude the
  373.         clock so its window will be ignored by the tiling and cascading
  374.         functions.(See also section Exclusion Window).
  375.  
  376.         This file contains only ascii characters and can be edited with a
  377.         texteditor. You have to use the following format:
  378.  
  379.         Syntax: <window title>
  380.  
  381.         Each line represents a new window. You may use AmigaDOS wildcards.
  382.         There must be no whitespaces.
  383.  
  384.     CX_Priority
  385.  
  386.         This is commodity priority which WComm should use. The default
  387.         priority is 0. If you have another commodity running which uses
  388.         a same hotkey combination, only the commodity with the higher
  389.         priority will get the message. The one with the lower priority
  390.         will still stay asleep.
  391.  
  392.         Do not use higher priorities than 5 and lower priorities than -5.
  393.  
  394.     Notify
  395.  
  396.         This is the name of the notify configuration file.
  397.         If you do not specify Notify, WComm looks first for the file
  398.         `env:Notify.prefs` and then if not found for the
  399.         `envarc:Notify.prefs` file.
  400.  
  401.         If WComm cannot found the given or default configuration files, you
  402.         will get a requester which will inform you about this.
  403.  
  404.         The Notify configuration file contains the notify dates and times
  405.         and the commands which should be started at the given dates.
  406.  
  407.         This file contains only ascii characters and can be edited with a
  408.         texteditor. Because of the complicated format I will suggest you to
  409.         edit this file only from the notify window.
  410.  
  411.         So I will not describe the syntax of this file.
  412.  
  413. WBench-Start:
  414.  
  415.  
  416.     If you want to start WComm from the wbench, you can instead of specifying
  417.     any cli argument, set some tooltypes.
  418.  
  419.     These are:
  420.  
  421.                CONFIG
  422.                CX_POPUP
  423.                WPREFS
  424.                EPREFS
  425.                CX_PRIORITY
  426.                NOTIFY
  427.  
  428.  
  429.     The arguments are equal to the cli arguments. You must take care
  430.     that the arguments are case sensitive.
  431.  
  432.     The syntax: (do not type the <>`s)
  433.  
  434.                 CONFIG=<name of the configuration file>
  435.  
  436.                 CX_POPUP=<YES|NO> this can only be either YES or NO.
  437.  
  438.                 WPREFS=<name of window configuration file>
  439.  
  440.                 EPREFS=<name of exclusion file>
  441.  
  442.                 CX_PRIORITY=<#> # must be a number
  443.  
  444.                 NOTIFY=<name of the notify file>
  445.  
  446.     for the system you can also use the following tooltypes
  447.  
  448.                TOOLPRI=<#> this is the priority the wbench should
  449.                            give to WComm, this is not the commodity
  450.                            priority.
  451.  
  452.                CLI         This has no argument. This asks the wbench
  453.                            to open its `command execute` window which
  454.                            lets you specify some CLI arguments. Then
  455.                            the wbench will run WComm as a cli program.
  456.  
  457.                DONOTWAIT   If you put WComm into your WBStartup drawer
  458.                            you have to specify this. This is quite equal
  459.                            to the Run >NIL <NIL cli command. If omitted
  460.                            the wbench will wait until WComm is finished.
  461.  
  462. HotKeys:
  463.  
  464.     For each function you can specify another hotkey combination.
  465.     A hotkey is a combination of a qualifier and a keycode.
  466.  
  467.     Qualifier means buttons such as shift, alt, control etc...
  468.  
  469.     Keycodes means all other buttons.
  470.  
  471.     A hotkey may consist of only a keycode but not only of a qualifier.
  472.  
  473.     Here is a list of available hotkeys:
  474.  
  475.     Available Qualifiers:
  476.  
  477.         lshift              : left shift
  478.         rshift              : right shift
  479.                               WComm.doc  Page 4
  480.         shift               : any shift
  481.         lalt                : left alt
  482.         ralt                : right alt
  483.         alt                 : any alt
  484.         lcommand            : left amiga
  485.         rcommand            : right amiga (take care for menu-shortcuts)
  486.         command             : any amiga
  487.         control             : control key
  488.  
  489.         lbutton             : pressing down the left mousebutton
  490.         rbutton             : pressing down the right mousebutton
  491.         midbutton           : pressing down the middle mousebutton (if you
  492.                               have some)
  493.         diskinserted        : inserting a disk
  494.         diskremove          : removing a disk
  495.  
  496.     Available Keycodes:
  497.  
  498.         a,b ... z           : any aphanumerical
  499.         0,1 ... 9           :  key
  500.         üäö?                : also umlauts
  501.         +-.,*/|\?...        : and other special keys
  502.         f1,f2 ... f10       : the function keys
  503.         space               : space key
  504.         backspace           : backspace key
  505.         up,down,left,right  : the cursor keys
  506.         esc                 : the escape key
  507.         del                 : the delete key
  508.         numericpad          : note: there is a differnce between the
  509.                             : keys on the standart keyboard and the
  510.                             : keys on the numericpad. If you want to
  511.                             : specify a key on the numericpad, you have
  512.                             : to type `numericpad #` where # is the
  513.                             : normal key. E.g. `numericpad 8` will only
  514.                             : fit the `8` on the numericpad and not the
  515.                             : `8` on the standart keyboard.
  516.         return              : the return key
  517.         esc                 : the escape key
  518.  
  519.     Examples:
  520.  
  521.  
  522.         shift control lbutton
  523.  
  524.         Wird die Shift- zusammen mit der Control- Taste gedrückt und dann
  525.         die linke Maustaste betätigt.
  526.  
  527.         f10
  528.  
  529.         Die Funktionstaste f10.
  530.  
  531.         ralt numericpad 9
  532.  
  533.         Die rechte Alt-Taste mit der 9 des Ziffernblocks.
  534.  
  535.  
  536. List Of Functions:
  537.  
  538.     Here is now a list of all supported functions and their default
  539.     hotkey combinations. For each new version of WComm this list will
  540.     be updated.
  541.     How to use the popup window and change the hotkeys will be described
  542.     later in this manual.
  543.  
  544.     There are some funtions especially the cascading and tiling functions which
  545.     will use a left and top offset to move the windows. The left and top offset
  546.     values depends on your system font. So I cannot tell you which value of
  547.     pixels will be used, because I don`t know you currently used font. I will
  548.     therefor refer to these values with LeftOffset and TopOffset.
  549.  
  550.  
  551.     POPUP: (default: `control o`)
  552.  
  553.         This opens the popup window of the WComm program. On this window you
  554.         change several settings. Load a new prefs file and save the current
  555.         settings, quit out WComm and so on ...
  556.         Alternatively you can use the exchange tool by clicking on the show
  557.         button.
  558.  
  559.     EXIT: (default: `control q`)
  560.  
  561.         This tells WComm to remove immediately from memory without any ask
  562.         requester. You can check this by calling the exchange program.
  563.  
  564.  
  565.     Close Window: (default: `control esc`)
  566.  
  567.         This hotkey tries to close the current activated window by sending
  568.         it an InputEvent with CLOSEWINDOW. This does only function with
  569.         windows with a CloseGadget.
  570.  
  571.     Enlarge Window: (default: `control f1`)
  572.  
  573.         This enlarges the current activated window to the MaxWidth and
  574.         MaxHeight settings of the window or to the screen borders. This
  575.         does not function with windows without any SizeGadget.
  576.  
  577.     Minimize Window: (default: `control f2`)
  578.  
  579.         This reduces the size of a window to its MinWidth and MinHeight
  580.         settings. This does not function with windows without any
  581.         SizeGadget.
  582.  
  583.     Reset Window: (default: `control f3`)
  584.  
  585.         When WComm first tries to manipulate a window (not with tiling and
  586.         cascading), it will save its current settings so you are able to
  587.         reset a window to the old place and size it has before WComm has
  588.         changed anything. This does only function when the window is
  589.         manipulated from WComm before.
  590.  
  591.     Zip Window: (default: `control f5`)
  592.  
  593.         Zooms a window. This does the same than click on the ZipGadget of a
  594.         window. The system zip function saves the place and size of a window
  595.         before you zip it. so zipping again brings the window to place and
  596.         size before the first zipping.
  597.  
  598.     Reduce Width: (default: shift alt left`)
  599.  
  600.         This reduces the width of a window by the LeftOffset
  601.  
  602.     Reduce Height: (default: shift alt up`)
  603.  
  604.         This reduces the height of a window by TopOffset.
  605.  
  606.     Reduce Both: (default: shift alt backspace`)
  607.  
  608.         This reduces the width of window by LeftOffset and the height by
  609.         TopOffset.
  610.  
  611.     Enlarge Width: (default: shift alt right`)
  612.  
  613.         This enlarges the width of a window by LeftOffset.
  614.  
  615.     Enlarge Height: (default: shift alt down`)
  616.  
  617.         This enlarges the height of a window by TopOffset.
  618.  
  619.     Enlarge Both: (default: shift alt space`)
  620.  
  621.         This enlarges the width of a window by 24 pixels and the height
  622.         by 12 pixels.
  623.  
  624.     Move Left Top: (default: `lalt numericpad 7`)
  625.  
  626.         This resizes the width of the window to the half width and height
  627.         of the screen and moves it to the left top of the screen.
  628.  
  629.     Move Right Top: (default: `lalt numericpad 9`)
  630.  
  631.         This resizes the width of the window to the half width and height
  632.         of the screen and moves it to the right top of the screen.
  633.  
  634.     Move Left Bottom: (default: `lalt numericpad 1`)
  635.  
  636.         This resizes the width of the window to the half width and height
  637.         of the screen and moves it to the left bottom of the screen.
  638.  
  639.     Move Right Bottom: (default: `lalt numericpad 3`)
  640.  
  641.         This resizes the width of the window to the half width and height
  642.         and moves it to the right bottom of the screen.
  643.  
  644.     Move To Center: (default: `lalt numericpad 5`)
  645.  
  646.         This resizes the width of the window to the half width and height
  647.         and moves it to center of the screen.
  648.  
  649.     Move Left Screen: (default: `lalt numericpad 4`)
  650.  
  651.         This resizes the width of the window to the half width and height
  652.         moves moves it vertically centered to the left edge of the screen.
  653.  
  654.     Move Right Screen: (default: `lalt numericpad 6`)
  655.  
  656.         This resizes the width of the window to the half width and height
  657.         and moves it vertically centered to the right edge of the screen.
  658.  
  659.     Move Top Screen: (default: `lalt numericpad 8`)
  660.  
  661.         This resizes the width of the window to the half width and height
  662.         and moves it horizontally centered to the top edge of the screen.
  663.  
  664.     Move Down Screen: (default: `lalt numericpad 4`)
  665.  
  666.         This resizes the width of the window to the half width and height
  667.         and moves it horizontally centered to the bottom edge of the screen.
  668.  
  669.     Move Up: (default: `shift control up`)
  670.  
  671.         This moves the window up by TopOffset.
  672.  
  673.     Move Left: (default: `shift control left`)
  674.  
  675.         This moves the window left by LeftOffset.
  676.  
  677.     Move Right: (default: `shift control right`)
  678.  
  679.         This moves the window right by LeftOffset.
  680.  
  681.     Move Down: (default: `shift control down`)
  682.  
  683.         This moves the window down by TopOffset.
  684.  
  685.     Set To Prefs: (default: `control f4`)
  686.  
  687.         This resets the window to the settings specified in the window
  688.         list. If there is no matching title this does nothing.
  689.  
  690.     Set To Right Limit: (default: `control f6`)
  691.  
  692.         This enlarges the width of the window to the right screen border.
  693.  
  694.     Set To Bottom Limit: (default: `shift control f6`)
  695.  
  696.         This enlarges the height of the window to the bottom screen border.
  697.  
  698.     Size To Limits: (default: `control f7`)
  699.  
  700.         This enlarges the width of the window to the right screen border
  701.         and the height to the bottom border.
  702.  
  703.     Tiling Windows: (default: `control f8`)
  704.  
  705.         By calling this functions, WComm tries to manipulates all windows
  706.         on the currently active screen in a way that there are no more
  707.         overlapped areas between the windows.
  708.         E.g. if you have 4 shell windows on the workbench screen and you
  709.         call this function, the windows will be sized to the half of the
  710.         screenwidth and height and placed in the upper left, upper right,
  711.         lower left and lower right edge of the screen. If you have instead
  712.         8 shell windows there, they will be resized to 1/8 th of the screen
  713.         height and width.
  714.         This functions handles upto 16 (!) window positions. I won`t say
  715.         too much, but ... , try and joy it.
  716.  
  717.         And ?
  718.  
  719.         You will see that all odd numbers of windows will fill up first
  720.         the upper rows of windows and then the lower ones.
  721.         If you have more then 16 windows the others will be managed in
  722.         the same way and positioned above the older.
  723.  
  724.         Tiling also brings the currently resized and repositioned window
  725.         to the front automatically. This is not standard and will not be
  726.         used by other tiling programs.
  727.  
  728.         An other aspect is, if you use a lot of windows (shells or drawers)
  729.         you can wait (under OS 2.xx) a lot of time until the refresh of
  730.         the windows has been finished. In this time a tiling functions
  731.         normally has to wait until this refresh process has been finished,
  732.         before it can go on to the next window. Imagine you have 10 shell
  733.         windows (or drawers ...) what time will be wasted when using a
  734.         standard Amiga. So I decided to increase the speed a little
  735.         (or more). Each processing window will be analyzed. If its a
  736.         SMART_REFRESH window its flags will be changed so the tiling
  737.         functions have no more to wait until the window has been refreshed.
  738.         The tiling process is speeded up a lot.
  739.         After the process the window gets its old flags again.
  740.  
  741.     Cascading Left To Right: (default: `shift control f8`)
  742.  
  743.         Here all windows will be cascaded positioned from the left upper
  744.         corner of the screen to right. Each window is positioned LeftOffset
  745.         more to the right.
  746.  
  747.     Cascading Top To Bottom: (default: `control f9`)
  748.  
  749.         Here all windows will be cascaded positioned from the left upper
  750.         corner of the screen to lower left. Each window is positioned
  751.         TopOffset under the previous.
  752.  
  753.     Cascading Hor&Vertically: (default: `shift control f9`)
  754.  
  755.         Here all windows will be cascaded positioned from the left upper
  756.         corner of the screen to lower right. Each window is positioned
  757.         LeftOffset more to the right and TopOffset under the previous.
  758.  
  759.     Cascading Bottom To Top: (default: `control f10`)
  760.  
  761.         Here all windows will be cascaded positioned from the lower right
  762.         corner of the screen to upper right. Each window is positioned
  763.         TopOffset above the previous.
  764.  
  765.     Previous Window: (default: `lcommand left`)
  766.  
  767.         This activates the previous window in the screen`s window list.
  768.         Here only windows will be used which`s titles are not specified
  769.         in the window exclusion list.
  770.  
  771.     Next Window: (default: `lcommand right`)
  772.  
  773.         This activates the next window in the screen`s window list.
  774.         Here only windows will be used which`s titles are not specified
  775.         in the window exclusion list.
  776.  
  777.     Prev Window To Front: (default: `shift lcommand left`)
  778.  
  779.         This activates the previous window in the screen`s window list
  780.         and brings it to the front. Here only windows will be used which`s
  781.         titles are not specified in the window exclusion list.
  782.  
  783.     Next Window To Front: (default: `shift lcommand right`)
  784.  
  785.         This activates the next window in the screen`s window list
  786.         and brings it to the front. Here only windows will be used which`s
  787.         titles are not specified in the window exclusion list.
  788.  
  789.     Window To Front: (default: `lcommand return`)
  790.  
  791.         This brings the currently active window to the front.
  792.  
  793.     Window To Back: (default: `lcommand esc`)
  794.  
  795.         This brings the currently active window to the back.
  796.  
  797.     Next Screen: (default: `lcommand up`)
  798.  
  799.         This cycles the frontmost screen behind the last screen.
  800.  
  801.     Kill Window: (default: `shift control esc`)
  802.  
  803.         This is a funtion, that gives you the ability to kill windows which
  804.         are left from other programs which had been terminated by a crash etc.
  805.         The currently activated window will be closed.
  806.  
  807.         Do not try to close windows from applications that are currently
  808.         running. In this case you will get a crash.
  809.  
  810.     Open Shell (default: `shift control s`)
  811.  
  812.         This just opens a newshell. The path and stack of the boot shell will be
  813.         used.
  814.  
  815.     Open Exclude Window (default: `shift control x`)
  816.  
  817.         Opens the exclude window without popping up the main window.
  818.  
  819.     Open Settings Window (default: `shift control l`)
  820.  
  821.         Opens the Windowlist window without popping up the main window.
  822.  
  823.     Open Clock Prefs Window (default: `shift control c`)
  824.  
  825.         Opens the Clockprefs window without popping up the main window.
  826.  
  827.     Open Palette Window (default: `shift control p`)
  828.  
  829.         Opens the Palette window without popping up the main window.
  830.  
  831.     Open Notify Window (default: `shift control n`)
  832.  
  833.          Opens the Notify window without popping up the main window.
  834.  
  835.     Summary:
  836.  
  837.         Moving functions will only affect windows which owns a DRAG_BAR.
  838.  
  839.         Sizing functions will only affect windows which owns a SIZE_GADGET.
  840.  
  841.         Zip function will only affect windows which owns a ZIP_GADGET.
  842.  
  843.         FRONT/BACK actions will only affect windows which are not backdrop
  844.         windows like the old 1.3 WBench window.
  845.  
  846.         Next/Prev, Cascading and Tiling actions will only affect windows
  847.         which are not included in the window exclusion list.
  848.  
  849.         The SetToPrefs function will only affect windows which are included
  850.         in the window settings list.
  851.  
  852.         The Reset function will only affect windows which has been
  853.         manipulated by WComm before (not the cascading and tiling functions)
  854.         you call this function.
  855.  
  856.         Tiling and Cascading will try to move and size windows. If one window
  857.         dosn`t contain a SizeGadget the window will only be moved. If a
  858.         window is a backdrop window, it will not be affected.
  859.  
  860.         The window settings list and window exclusion list files can specify
  861.         any window title by specifying the first word by amigados pattern
  862.         matching.
  863.  
  864.         You are also able to create `super groups`.
  865.  
  866.  
  867.  
  868. General:
  869.  
  870.     Before describing the windows I will first say something general about the
  871.     usage of the user interface.
  872.  
  873.  
  874.     For almost each gadget exists a key you can press alternatively instead
  875.     of using the mouse. This key is usually displayed underscored.
  876.     For some important functions this keyboard equivalent doesn`t exist.
  877.  
  878.     This is for security not to overwrite existing projects etc.
  879.     Also conflicts with hotkeys will not appear. (Note all hotkeys are
  880.     user definable).
  881.  
  882.     To click on a CloseGadgets means the same than use the quit or cancel
  883.     gadgets.
  884.  
  885.     All functions are available at any time. This means each window is
  886.     asyncronious. So you can modify a setting and you will immediately see the
  887.     success.
  888.  
  889. OS 2.04 Gadgets:
  890.  
  891.  
  892.     BUTTON_GADGET:
  893.  
  894.         This button will be displayed inversiv when you click on its
  895.         image with the left mousebutton. If you release the button on
  896.         its imaginary the function will be started.
  897.  
  898.     CHECKBOX_GADGET:
  899.  
  900.         This gadget have two states. If this gadget is activated the hook
  901.         is visual otherwise not.
  902.  
  903.     STRING_GADGET:
  904.  
  905.         This gadget enables you to easily edit a short text which is
  906.         displayed in the gadget box. After pressing the return key, the
  907.         editing is finished.
  908.  
  909.         If you press the underlined key the gadget becomes activated and
  910.         you can suddenly start to edit the text.
  911.  
  912.     CYCLE_GADGET:
  913.  
  914.         This kind of gadget displays one selection from a list.
  915.         By clicking on this gadget the next selection will be displayed.
  916.  
  917.         To press the underlined key is exactly the same than clicking
  918.         on this gadget. If you press the underlined key together with the
  919.         SHIFT key, the previous selection will be displayed instead.
  920.  
  921.     MX_Gadget:
  922.  
  923.         Here you can select also a selection. But you can see all
  924.         selections at the same time. If you activate one entry the
  925.         previously selected one will be automatically deselected.
  926.  
  927.     SLIDER_GADGET:
  928.  
  929.         The body of the gadget (mostly in black) displays the relation
  930.         between the total number of elements, to the currently displayed
  931.         number of elements. If you click under or above the body but in
  932.         the gadgetbox, you will scroll to the next (previous) page. If you
  933.         click on the body and hold down the mousebutton while moving the
  934.         mousepointer, you can get a continous moving.
  935.  
  936.         Also here does the underlined key together with the SHIFT key a
  937.         scroll back.
  938.  
  939.     LISTVIEW_GADGET:
  940.  
  941.         This gadget displays a list. Activating by clicking with thre left
  942.         mouse button.
  943.  
  944.         No keyboard support.
  945.  
  946.  
  947. The Main Window:
  948.  
  949.     If you use the hotkey for popping up (default: control o), the main
  950.     window will be opened. This window will also appear if you use the
  951.     exchange tool by activating the show gadget or if you specify CX_POPUP
  952.     at starttime.
  953.  
  954.     On this window you can edit, load or save the configuration file.
  955.     You can open all other windows and edit the hotkeys.
  956.  
  957.     LISTVIEW Gadget:
  958.  
  959.     The ListView gadget displays a list of all available functions of WComm.
  960.     You can use the arrow gadgets to scroll up and down through the list.
  961.     If you click on a line, the from this function used hotkey combination
  962.     will be displayed in the Current Text gadget under the ListView gadget.
  963.  
  964.     Edit:
  965.     New:
  966.  
  967.     If you click on the Edit gadget, the New string gadget becomes unghosted
  968.     and active. After specifying another hotkey code combination, the
  969.     combination will be used to replace the old one.
  970.     If the combination`s syntax is correct and can be allocated from the
  971.     system, the string gadget will get ghosted again and the used hotkey
  972.     will be displayed in the Current text gadget.
  973.     If you instead type in an incorrect combination, the program uses its
  974.     defaults and you will get the currently used one in the text and string
  975.     gadget.
  976.  
  977.     Under the ListView gadget there are still two more gadgets. If you have
  978.     selected a list entry you can click either on Enable or Disable to
  979.     enable/disable the selected hotkey. Of course you can only use disable,
  980.     if the hotkey is currently active and vice versa.
  981.  
  982.     The gadgets on the right handside of the window are:
  983.  
  984.     OPEN:
  985.     SELECT:
  986.     SAVE:
  987.     SAVEAS:
  988.  
  989.     The Open gadget lets you reload the default configuration file. The
  990.     select gadget lets you use the asl filerequester to select one.
  991.     The Save gadget lets you save the currently used hotkeys under the
  992.     default name `env:WComm.prefs`. The SaveAs gadget lets you use the asl
  993.     filerequester to select a name to save the config file to. Default file
  994.     is `envarc:WComm.prefs`.
  995.  
  996.     RESTORE
  997.     DEFAULT
  998.  
  999.     The Restore gadget does an undo for the currently selected hotkey,
  1000.     while the default, uses the default settings for all hotkeys and
  1001.     (re)activates them.
  1002.  
  1003.     Open Exclude Window:
  1004.  
  1005.     This brings up the Exclusion window, which will be described later in
  1006.     this manual.
  1007.  
  1008.     Open Settings Window:
  1009.  
  1010.     This brings up the Window Settings window, which will be described later
  1011.     in this manual.
  1012.  
  1013.     Open Clock Prefs Window:
  1014.  
  1015.     This brings up the Clock Prefs window, which will be also described
  1016.     later.
  1017.  
  1018.     Open Palette Window:
  1019.  
  1020.     This brings up the palette window which will be described later in this
  1021.     manual.
  1022.  
  1023.     HIDE:
  1024.     QUIT:
  1025.  
  1026.     With Hide you can close the window while WComm stays still active,
  1027.     instead Quit finishes the program. If you select Quit and you have
  1028.     changed the settings without saving you will get a requester which lets
  1029.     you chose if you want to save it first. Else you got a requester if you
  1030.     really want to quit WComm.
  1031.  
  1032.     The EXIT hotkey means mainly the same but if selected no confirmation
  1033.     requester will be opened.
  1034.  
  1035.  
  1036. The Exclusion Window:
  1037.  
  1038.     On this window you are able to change the currently used exclusion list.
  1039.     Also you can edit, save and load another one.
  1040.  
  1041.     This window can be opened from the main window or via hotkey.
  1042.  
  1043.     Windowtitles which matches the titles in this list will be excluded by
  1044.     some functions like
  1045.  
  1046.         tiling, cascading, next and previous activations etc.
  1047.  
  1048.     The list entries consists of amigados patterns with wildcards. Therefor
  1049.     you must take care not to insert redundant title entries. Because in
  1050.     this case only the first entry will be used.
  1051.  
  1052.     The gadgets on the window are:
  1053.  
  1054.     LISTVIEW:
  1055.  
  1056.         The listview gadget displays a list of all excluded window titles.
  1057.  
  1058.         If you select an entry this title is copyed into the string gadget
  1059.         and this gadget becomes active. Now you can edit the title.
  1060.         If you press return the new title will replace the old one.
  1061.  
  1062.     NEW:
  1063.  
  1064.         With new you can create a new entry in the exclusion list. This
  1065.         entry is initially called unnamed. The stringgadget becomes active
  1066.         and you can edit the new entry immediately.
  1067.  
  1068.     REM:
  1069.  
  1070.         With this button you are able to remove an entry from the
  1071.         current list. Take care that you should not use a name twice.
  1072.         Also whitespaces are not allowed.
  1073.         If you have two entries with the same name and you select Rem,
  1074.         the upper one will be removed.
  1075.  
  1076.     DISABLE:
  1077.  
  1078.         You can also disable and enable an entry. If you click on disable
  1079.         the currently selected entry will get an `>>` in front of the name.
  1080.         You can only disable entries which are currently enabled.
  1081.  
  1082.     ENABLE:
  1083.  
  1084.         If you click on enable the currently selected entry will be
  1085.         enabled again. You can only enable entries which are disabled
  1086.         before.
  1087.  
  1088.     OPEN:
  1089.  
  1090.         This lets WComm try to load the default exclusion list
  1091.         (`env:XWindow.prefs`,`envarc:XWindow.prefs`). If these could not
  1092.         be found you will get an error message.
  1093.  
  1094.     SELECT:
  1095.  
  1096.         This opens a filerequester which lets you select another exclusion
  1097.         file to load.
  1098.  
  1099.     SAVE:
  1100.  
  1101.         This saves the actual list to env:XWindow.prefs
  1102.  
  1103.     SAVEAS:
  1104.  
  1105.         This opens the filerequester which displays the second default
  1106.         exclusion file envarc:XWindow.prefs. Certainly you can also use
  1107.         another name than the default.
  1108.  
  1109.     USE:
  1110.  
  1111.         This closes the exclusion window.
  1112.  
  1113.     QUIT:
  1114.  
  1115.         This closes the exclusion window and ask you to quit the WComm
  1116.         program.
  1117.  
  1118.  
  1119.  
  1120.  
  1121. The Window Prefs Window:
  1122.  
  1123.  
  1124.     On this window you are able to change the currently used window settings
  1125.     list. Also you can save and load another one.
  1126.  
  1127.     You can specify here window titles and their default positions and sizes.
  1128.     This settings can be used with the `Set To Prefs` function.
  1129.  
  1130.     This window can be opened from the main window or via hotkey.
  1131.  
  1132.     The gadgets on the window are:
  1133.  
  1134.     LISTVIEW:
  1135.  
  1136.         The listview gadget displays a list of all known titles.
  1137.  
  1138.         If you select an entry the title will be copied into the string
  1139.         gadget and this gadget becomes active. The leftedge, topedge, width
  1140.         and height settings will be copied into the integer gadgets under
  1141.         the string gadget. Now you can edit all values.
  1142.  
  1143.     NEW:
  1144.  
  1145.         With new you can create a new entry in the settings list.
  1146.         This entry is initially named unnamed. The string gadget becomes
  1147.         active and you can edit the new entry immediately.
  1148.  
  1149.     REM:
  1150.  
  1151.         With this button you are able to remove an entry from the current
  1152.         list. Take care that you should not use a name twice. Also spaces
  1153.         in the titles are not allowed.
  1154.         If you have two entries with the same name and you select Rem, always
  1155.         the upper one will be removed.
  1156.  
  1157.     DISABLE:
  1158.  
  1159.         You can also disable and enable an entry. If you click on disable
  1160.         the currently selected entry will get an `>>` in front of the name.
  1161.         You can only disable entries which are currently enabled.
  1162.  
  1163.     ENABLE:
  1164.  
  1165.         If you click on enable the currently selected entry will be enabled
  1166.         again. You can only enable entries which are disabled before.
  1167.  
  1168.     LeftEdge, TopEdge, Width, Height:
  1169.  
  1170.         These integer gadgets accepts only numbers. They display the settings
  1171.         of the currently selected entry. To change a value, just type in
  1172.         another value and press return.
  1173.  
  1174.     OPEN:
  1175.  
  1176.         This lets WComm try to load the default window settings list
  1177.         (`env:ZWindow.prefs`,`envarc:ZWindow.prefs`). If these could not be
  1178.         found, you will get an error message.
  1179.  
  1180.     SELECT:
  1181.  
  1182.         This opens a filerequester which lets you select another settings
  1183.         file to load.
  1184.  
  1185.     SAVE:
  1186.  
  1187.         This saves the actual list to env:ZWindow.prefs
  1188.  
  1189.     SAVEAS...:
  1190.  
  1191.         This opens the filerequester which displays the second default
  1192.         settings file envarc:ZWindow.prefs. Certainly you can also use
  1193.         another name than the default.
  1194.  
  1195.     USE:
  1196.  
  1197.         This closes the window.
  1198.  
  1199.     QUIT:
  1200.  
  1201.         This closes the window and ask you to quit the WComm program.
  1202.  
  1203. The Clock Prefs Window:
  1204.  
  1205.     This window can be opened from the main window or directly via hotkey.
  1206.  
  1207.     On this window you can control the display and the settings of the clock
  1208.     window and modify them or even close the clock window.
  1209.  
  1210.     The default is to open the clock window. It displays not date and the
  1211.     time as hours:minutes.
  1212.  
  1213.  
  1214.     Now the description of the gadgets.
  1215.  
  1216.     Clock Type ('T' or 't')
  1217.  
  1218.         This controls wether the clock window should be opened or not.
  1219.         Default: ON.
  1220.  
  1221.     Time Format ('f' or 'F')
  1222.  
  1223.         This controls the format of the time display You may select one of
  1224.         theses:
  1225.  
  1226.             HH:MM       - Hours:Minutes (DEFAULT)
  1227.             HH:MM:SS    - Hours:Minutes:Seconds
  1228.            24H:MM       - 24-Hour clock Hours:Minutes
  1229.            24H:MI:SE    - 24-Hour clock Hours:Minutes:Seconds
  1230.  
  1231.     Date Type ('y' or 'Y')
  1232.  
  1233.         This controls the date display format. Available format
  1234.         types:
  1235.  
  1236.                     No Date - Display no date (default)
  1237.           WD Day-Month-Year - Weekday Day-Month-Jahr
  1238.        ShoWD Day-Month-Year - Short weekday Day-Moth-Year
  1239.              Day-Month-Year - No weekday Day-Month-Year
  1240.  
  1241.     Width ('w' or 'W')
  1242.  
  1243.         This is the width of the clock window. You may chose a value from
  1244.         150 to 450. default: 150.
  1245.  
  1246.     LeftEdge ('l' or 'L')
  1247.  
  1248.         This is the left position of the clock window.
  1249.         Default: 0.
  1250.  
  1251.     TopEdge ('o' or 'O')
  1252.  
  1253.         This is the upper position of the clock window.
  1254.         Default: 0.
  1255.  
  1256.     Alarm On ('n' or 'N')
  1257.  
  1258.         The clock has the ability to inform the user at a given time with an
  1259.         alarm (a screen flash). If this gadget is activated, the alarm is on.
  1260.         Default: OFF.
  1261.  
  1262.     Beep Each Hour ('p' or 'P')
  1263.  
  1264.         Also WComm may beep each hour. If this gadget is activated this
  1265.         funtion is activated.
  1266.         Default:OFF.
  1267.  
  1268.     Al Hour ('a' or 'A')
  1269.  
  1270.         This is the hour which should be used by the alarm function.
  1271.         Default: 0.
  1272.  
  1273.     Al Min ('m' or 'M')
  1274.  
  1275.         This is the minute which should be used by the alarm function.
  1276.         Default: 0.
  1277.  
  1278.     Use ('u' or 'U')
  1279.  
  1280.         The current settings will be used and the window will be closed.
  1281.  
  1282.     Cancel ('c' or 'C' or ESC)
  1283.  
  1284.         The current settings will not be used. Instead the values
  1285.         before opening the clock prefs window will be used.
  1286.         The window will be closed.
  1287.  
  1288.     All settings on this window can be saved into the configuration file.
  1289.     Each modification will change the display of the clock just by the next
  1290.     displaying second. If you close the clock window by using the CloseGadget,
  1291.     this will not affect the currently opened clock prefs window. If you
  1292.     close and reopen the clock prefs window you will notice that the clock
  1293.     type has been changed to `No Clock`.
  1294.  
  1295.  
  1296. The Palette Window:
  1297.  
  1298.     This window can be opened via gadget from the main window or directly
  1299.     via hotkey.
  1300.  
  1301.     All functions on this window handles the modifications of the
  1302.     wbench colours. Because you can use with OS 3.0 up to 256 colours for
  1303.     your wbench, you cannot use older palette programs. So this had been
  1304.     included.
  1305.  
  1306.     The functions will be shortly described. I think everybody knows such
  1307.     programs. Nevertheless here are the gadgets description:
  1308.  
  1309.  
  1310.     PALETTEN Gadget (RETURN)
  1311.  
  1312.     This selects the current colour for all modification functions.
  1313.     Under OS 2.04 you see an indicator left beneth the gadget.
  1314.  
  1315.     RED   ('r' or 'R')
  1316.     GREEN ('g' or 'G')
  1317.     BLUE  ('b' or 'B')
  1318.  
  1319.     These slider gadgets modify the red green and blue values of the
  1320.     current colour. Upto now I used only the usual 16 levels for compati-
  1321.     bility with OS 2.04. Newer versions may use all new 256 value levels.
  1322.  
  1323.     The lower case characters will increase the specific value while the
  1324.     upper ones will decrease it.
  1325.  
  1326.     Copy ('o')
  1327.  
  1328.     If you click on this gadget, the mousepointer will be changed into a TO.
  1329.     This means no activitation except a click on the palette gadget is now
  1330.     allowed. If you click on this palette gadget the mousepointer gets
  1331.     normal again and the older colour will be copied to the current one.
  1332.  
  1333.     Exchange ('e')
  1334.  
  1335.     This does quite the same, but the second colour will be exchanged with
  1336.     the first one.
  1337.  
  1338.     Undo ('d')
  1339.  
  1340.     If the Palette window will be first opened, WComm reads all colours. If
  1341.     you modify the colours and click then on Undo, the old values will be
  1342.     restored.
  1343.  
  1344.     Reset ('r')
  1345.  
  1346.     This restores only the current colour. This functions with each colour
  1347.     independent.
  1348.  
  1349.     Use ('u')
  1350.  
  1351.     Use all modifications and close the window.
  1352.  
  1353.     Cancel ('c')
  1354.  
  1355.     Use the old values and close the window.
  1356.  
  1357.  
  1358.     Note:     If you change the colours of your wbench screen, they will
  1359.               be only written to the viewport of the screen. If you start
  1360.               a tool like the palette wbench tool you get the old values
  1361.               back, before any modification. This is not a BUG.
  1362.  
  1363.  
  1364.  
  1365. The Notify Window:
  1366.  
  1367.     This window can be opened via gadget from the main window or directly
  1368.     via hotkey.
  1369.  
  1370.     All functions on this window handles the modifications of the notify
  1371.     list. You can also load and save the notify list.
  1372.  
  1373.     The list consists of a title, a message text, the date of the notify
  1374.     and an optional command which should be started.
  1375.     There are also three kinds of launching such a command. EXECUTE, RUN
  1376.     and AREXX.
  1377.  
  1378.     Notification requester will appear on the given date and time.
  1379.     Optionally the requester can start a whole commandline at this time.
  1380.     The requester can also be disabled and only the command will be
  1381.     executed. The date which should be used for the notifies can be set
  1382.     with specifying the hour, minute, month and day. Each of theses items
  1383.     may be activated or not. But one item must be activated otherwise
  1384.     this entry will be ignored. With this concept you are also able to
  1385.     start a given request each hour or only one at the given date. See
  1386.     also the examples section.
  1387.  
  1388.  
  1389.     Gadget Description:
  1390.  
  1391.     LISTVIEW Gadget:
  1392.  
  1393.     This gadget displays the titles of all entries of the notify list.
  1394.     This title will be displayed in the title of the request.
  1395.  
  1396.     NEW:
  1397.  
  1398.     This gadget adds a new entry to the end of the current notify list.
  1399.     This entry is initially empty and disabled.
  1400.  
  1401.     REM:
  1402.  
  1403.     This gadget removes the currently displayed entry from the list.
  1404.  
  1405.     ENABLE:
  1406.  
  1407.     This gadget enables the currently selected entry. You can only
  1408.     activate entries which are just disabled.
  1409.  
  1410.     DISABLE:
  1411.  
  1412.     This gadget disables the currently selected entry. You can only
  1413.     disable entries which are still enabled.
  1414.  
  1415.     REQUEST:
  1416.  
  1417.     This string gadget contains the title of the notify requester.
  1418.  
  1419.     MESSAGE:
  1420.  
  1421.     This string gadget contains the text of the requester. You can
  1422.     specify here multiple lines with an `|`. The string can be upto 256
  1423.     characters in length.
  1424.  
  1425.     COMMAND:
  1426.  
  1427.     If you want to start an command at the given time of the current
  1428.     notify, you can insert here the command. To activate the command of
  1429.     the notify you must activate also the action checkbox.
  1430.  
  1431.     REQUEST ON TIME/DATE:
  1432.  
  1433.     If this checkbox is activated, a requester will be displayed
  1434.     otherwise not.
  1435.  
  1436.     HOUR and 1:
  1437.  
  1438.     This is the hour, when the notify should be invoked. The value will
  1439.     only be used if the hour checkbox (`1`) is activated.
  1440.  
  1441.     MIN and 2:
  1442.  
  1443.     This is the minute, when the notify should be invoked. The value will
  1444.     only be used if the minute checkbox (`2`) is activated.
  1445.  
  1446.     MON and 3:
  1447.  
  1448.     This is the month, when the notify should be invoked. The value will
  1449.     only be used if the month checkbox (`3`) is activated.
  1450.  
  1451.     DAY and 4:
  1452.  
  1453.     This is the day, when the notify should be invoked. The value will
  1454.     only be used if the day checkbox (`4`) is activated.
  1455.  
  1456.  
  1457.     NOTE: At minimum one of this date and time checkboxes must be
  1458.     activated, otherwise the notify will be ignored.
  1459.  
  1460.     LAUNCH:
  1461.  
  1462.     This cycle gadget decides which type of command should be executed.
  1463.     There are three available kinds:
  1464.  
  1465.         EXECUTE
  1466.  
  1467.             This starts simply a program or cli command and waits until
  1468.             it has been finished. If the command produces any output this
  1469.             output will be copyed to a new opened shell window. Otherwise
  1470.             this window will still stay closed (AUTO SHELL).
  1471.  
  1472.         BACKGROUND
  1473.  
  1474.             This starts a program or command in the background. All in
  1475.             and outputs will be sent to NIL:.
  1476.  
  1477.         AREXX
  1478.  
  1479.             This will invoke RX with the given arexx script.
  1480.  
  1481.         Note: All types of commands will use the path and stack which had
  1482.         been set in the startup-seuqence.
  1483.  
  1484.  
  1485.     ONCE:
  1486.  
  1487.     If this checkbox is activated, the notify will be displayed only
  1488.     once. You are able to specify notifies which can popup each hour.
  1489.     If you do not want this, you can specify Once and the notify will be
  1490.     invoked only once. If Wcomm is starting the next time the request
  1491.     will be displayed again only once (See examples).
  1492.  
  1493.     ACTION:
  1494.  
  1495.     If this checkbox is activated, the notify envokes the given
  1496.     commandline otherwise not.
  1497.  
  1498.     OPEN
  1499.  
  1500.     This opens the default notify configuration file which is called
  1501.     `env:notify.prefs`. If this is not found the `envarc:notify.prefs`
  1502.     will be tried to load. If this cannot be loaded nothing happens.
  1503.  
  1504.     SELECT:
  1505.  
  1506.     This brings up the filerequester which lets you chose a new notify
  1507.     configuration file.
  1508.  
  1509.     SAVE:
  1510.  
  1511.     This saves the current notify list under the default names.
  1512.  
  1513.     SAVE AS:
  1514.  
  1515.     This bring up the filerequester to chose a name the notify list
  1516.     should be saved to.
  1517.  
  1518.     USE:
  1519.  
  1520.     This uses the notify setting and closes the window.
  1521.  
  1522.     QUIT:
  1523.  
  1524.     This ask the user to quit WComm and closes the window.
  1525.  
  1526.  
  1527.     EXAMPLES:
  1528.     =========
  1529.  
  1530.     Because its a little morre difficult, so I will give you here some
  1531.     (less) useful examples.
  1532.  
  1533.     1. You want that WComm notifies you at christmas. Only a requester
  1534.     should appear.:
  1535.  
  1536.         Request: !!! Merry Christmas !!!
  1537.  
  1538.         Message: I wish you a merry christmas|an hope you will get a lot|
  1539.                     of wonderful presents
  1540.  
  1541.         Mon: 12         3: activated
  1542.  
  1543.         Day: 24         4: activated
  1544.  
  1545.         Once: activated
  1546.  
  1547.     Here you will see the usage of the Once gadget. If not activated,
  1548.     you will get the requester each minute. So you will get the requester
  1549.     each 24-Dec each year, but only once on these days.
  1550.  
  1551.  
  1552.     2. You want to get a message each first quarter of an hour to notify
  1553.     you its time for a break.
  1554.  
  1555.         Request: !!! Break Time !!!
  1556.  
  1557.         Message: Okay Boy |Its now the time for a cup of coffe| or do you
  1558.         prefer tea ?
  1559.  
  1560.         Min: 15         2: activated
  1561.  
  1562.  
  1563.     3. You want to start a backup of your drive dh0: automatically each
  1564.     month on the 3rd day of the month. You will first receive a message
  1565.     to stop all other computer activities. Assuming you have the program
  1566.     backup into your current dos searchpath.
  1567.  
  1568.         Request: !!! Backup Time !!!
  1569.  
  1570.         Message: Okay Boy !| No it is the time to start a| new backup
  1571.  
  1572.         Command: Backup DH0:
  1573.  
  1574.         Day: 3         4: activated
  1575.  
  1576.         Once:   activated
  1577.         action: activated
  1578.  
  1579.  
  1580.     You can also put in all dates of the birthdays of all friends and you
  1581.     will never forget these dates anymore. Set the date one day before
  1582.     their birthday and you will not forget to buy a present.
  1583.  
  1584.  
  1585.  
  1586. The Clock Window:
  1587.  
  1588.     All settings of the display of this clock can be modified by using the
  1589.     Clock Prefs window.
  1590.  
  1591.     The Clock can be closed by pressing the CloseGadget. To reopen it again
  1592.     you must use the Clock Prefs window.
  1593.  
  1594.     You cannot move the Clock with the mouse. If you want to change the
  1595.     position of the clock, you must use the Clock Prefs window too.
  1596.  
  1597.     The display of the clock will be refreshes only 1 times per second.
  1598.     Between two refreshes the clock stays in the background and doesn`t
  1599.     waste any CPU time.
  1600.  
  1601.  
  1602. Error Handling:
  1603.  
  1604.     WComm has been created under OS 3.0. I used Enforcer and hope that there
  1605.     are no more enforcer hits left. But also with best control some bugs may
  1606.     be left. So I support some error handling functions.
  1607.  
  1608.     Most errors should occur by errors of the usage. Also wrong configura-
  1609.     tion files and formats or other not so system conform programs may lead
  1610.     WComm to an error.
  1611.  
  1612.     IN GENERAL:
  1613.  
  1614.     For each error WComm tries to inform the user about the reason.
  1615.     By some errors the user will be only informed by some more serious
  1616.     errors the user gets the decision to break WComm or to proceed. If any
  1617.     very fatal error occures WComm have to terminate. But in all cases the
  1618.     user should get full informations about any reason.
  1619.  
  1620.     SOFT ERRORS:
  1621.  
  1622.     With soft errors the user will be only informed. After answering the
  1623.     requester, WComm proceeds.
  1624.  
  1625.     SERIOUS ERRORS:
  1626.  
  1627.     With more serious errors the user can decide if he wish to proceed or
  1628.     to stop WComm.
  1629.  
  1630.     I will suggest you: always finish WComm or you will get the risk that
  1631.     WComm cannot function well.
  1632.  
  1633.     FATAL ERRORS:
  1634.  
  1635.     With fatal errors WComm is not able to proceed. So when the user answers
  1636.     the requester, WComm have to terminate.
  1637.  
  1638.     UNKNOWN ERRORS:
  1639.  
  1640.     If any unknown error occures, you should check whether WComm is correctly
  1641.     installed and if you have also the following libraries in your libs
  1642.     drawer:
  1643.  
  1644.         asl.library
  1645.         commodities.library
  1646.  
  1647.     If you cannot find the error, you should first use the manual to look for
  1648.     further details. If you cannot find the answer, you can write me a letter.
  1649.     I will do my best to answer all questions as good as possible.
  1650.     But do not forget to tell me correctly
  1651.     the error, all running background processes, your type of computer,
  1652.     your OS version, your expansions, memory and the version of WComm.
  1653.  
  1654.     So it will be much easier to find the reason.
  1655.  
  1656.  
  1657. Technical:
  1658.  
  1659.     WComm is a standard commodity. It has all abilities and functions a
  1660.     comodity should have. Exchange gives you full control about the
  1661.     behaviour of WComm.
  1662.  
  1663.     WComm was written and created with the help of the following programs:
  1664.  
  1665.         AztecC Compiler Version 5.2a (® MANX),
  1666.         TurboText (® OXXI),
  1667.         SnoopDos (® Eddi Carroll)
  1668.         GadToolsBox (® Jaba Development),
  1669.         Enforcer (® Michael Sinz),
  1670.         DMake (® Matt Dillon)
  1671.  
  1672.     My best thanks to the programmers of these very good programs.
  1673.  
  1674.     My best thanks also to Mark Weisheit for giving me suggestions and help
  1675.     me to remove some errors.
  1676.  
  1677.     Instead of using the delivered standard startup routins from Aztec I
  1678.     used other ones that do not use the old 1.3 features which has been
  1679.     replaced with new OS 2.04 (37++) ones. This saves a lot of code size.
  1680.     Although WComm is got relatively big. The size of all used structures is
  1681.     only dependent to the free memory. All structures will be handled
  1682.     dynamically.
  1683.  
  1684. List Of Files:
  1685.  
  1686.     WComm               :  english binary
  1687.     WComm.info          :
  1688.     WComm_G             :  german binary
  1689.     WComm_G.info        :
  1690.     WComm.doc           :  english documentation
  1691.     WComm.doc.info      :
  1692.     WComm.dok           :  german documentation
  1693.     WComm.dok.info      :
  1694.     WComm.guide         :  english AmigaGuide ® file
  1695.     WComm.guide.info    :
  1696.     WComm_G.guide       :  german AmigaGuide ® file
  1697.     WComm_G.guide.info  :
  1698.     History.log         :  history log file
  1699.     History.log.info    :
  1700.     WComm.prefs         :  example configuration file
  1701.     ZWindow.prefs       :  example window list file
  1702.     XWindow.prefs       :  example exclusion list
  1703.     Notify.prefs        :  example notify file
  1704.     WComm.prefs.info    :
  1705.     ZWindow.prefs.info  :
  1706.     XWindow.prefs.info  :
  1707.     Notify.prefs.info   :
  1708.  
  1709.  Have Fun ...
  1710.  
  1711.  
  1712. Address:
  1713.  
  1714.     For all mail and messages, bugs, gifts, and our critics ...
  1715.  
  1716.         Hans-Peter Guenther
  1717.         Gruener Weg 5
  1718.         W-3501 Fuldatal 2
  1719.         GERMANY
  1720.  
  1721.     your H.P.G
  1722.