home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / cdity / sunwindow / english / sunwindow.doc < prev    next >
Text File  |  1993-12-28  |  58KB  |  1,310 lines
  1.                                SunWindow V2.0
  2.  
  3.  
  4.    This file documents SunWindow, a sweet little tool for enhancing the
  5. use of windows and public screens.
  6.  
  7.    Copyright (C) 1993 Bernhard Scholz.
  8.  
  9.    This is the second edition of the SunWindow documentation.
  10.  
  11.    Permission is granted to make and distribute verbatim copies of this
  12. manual provided the copyright notice and this permission notice are
  13. preserved on all copies.
  14.  
  15.    Permission is granted to copy and distribute modified versions of
  16. this manual under the conditions for verbatim copying, provided that
  17. the entire resulting derived work is distributed under the terms of a
  18. permission notice identical to this one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that this permission notice may be stated in a
  23. translation approved by Bernhard Scholz.
  24.  
  25.  
  26. SunWindow
  27. *********
  28.  
  29.    SunWindow is a commodity tool for the Commodore Amiga with at least
  30. an OS-Version of 2.0 or higher. It allows the user to control the
  31. graphical user environment (GUI) in a more intuitive way as usual. In
  32. short, SunWindow simplifies the usage of windows and screens, by adding
  33. keyboard shortcuts for most of the window operations, usually only
  34. accessable via the mouse. It is also capable of controlling big
  35. autoscrolling screens with a new method on the Amiga platforms.
  36.  
  37.    This is Edition 2 of the SunWindow documentation,  for SunWindow
  38. Version 2.
  39.  
  40.    WARNING: The information described in this manual may contain errors
  41. or bugs, and may not function as described. All information is subject
  42. to enhancement or upgrade for any reason including to fix bugs, add
  43. features, or change performance. As with all software upgrades, full
  44. compatibility, although a goal, cannot be guaranteed, and is in fact
  45. unlikely.
  46.  
  47.    Amiga is a registered trademark of Commodore-Amiga, Inc. Amiga 1000,
  48. AmigaDOS, Amiga Workbench, Amiga Kickstart, AmigaGuide are trademarks
  49. of Commodore. Commodore is a registered trademark of Commodore
  50. Electronics Limited.
  51.  
  52.  
  53. SunWindow Copying Conditions
  54. ****************************
  55.  
  56.    SunWindow is copyrighted by Bernhard Scholz. The program currently
  57. distributed includes portions of the ReqTools package (C) by Nico
  58. Francois. For more informations on the ReqTools package, please read the
  59. `REQTOOLS.readme' file on the distribution disk.
  60.  
  61.    SunWindow is distributed under the concepts of "SHAREWARE". This
  62. means: If you are using SunWindow frequently (I understand a period of
  63. time, not longer than four weeks), you have to be registered as a user
  64. of SunWindow by Bernhard Scholz.
  65.  
  66.    Permission is granted to make verbatim copies of SunWindow of the
  67. whole package, and process it with any packer.
  68.  
  69.    Permission is granted to distribute SunWindow in a non commercial
  70. (this includes other "SHAREWARE" products) way provided the copyright
  71. notice and this permission notice are preserved in all copies under the
  72. conditions of verbatim copying.
  73.  
  74.    Permission is granted to distribute SunWindow on public electronic
  75. networks, on public mailboxes or disk based PD-series, without profit
  76. for the distributor, and the conditions of verbatim copying providing
  77. the copyright notice and this permission notice are preserved.
  78.  
  79.  
  80. Introduction To SunWindow
  81. *************************
  82.  
  83.    In this chapter the concept of SunWindow is described in brief. You
  84. find informations about whether you can use the program or not, what
  85. are the benefits and other useful things, you might want to know, to
  86. get a fast impression of what SunWindow is capable to do.
  87.  
  88.  
  89. The Concept Of SunWindow
  90. ========================
  91.  
  92.    The user interface the Amiga offers to an user is very nice and was
  93. something revolutionary when the Amiga started its career. The "
  94. Workbench" is the main working area, and Intuition -- a part of the
  95. operating system -- serves for the graphical-user-interface (GUI).
  96.  
  97.    Many years have gone now, since the first release of the Amiga's GUI,
  98. but only since release V2.0 of the OS some great enhancements to the
  99. GUI were added, but most of them refer to the lookout of the graphics.
  100. Also new features were added: the public screens (screens, where any
  101. programm can open its windows) and autoscrolling screens (screens, which
  102. are bigger than the visible size will scroll with the mouse to make
  103. other parts of such a big screen visible). Although these two features
  104. are really great, they are not used very often. To make the use a
  105. little bit easier and intuitive to the user, and nearby enhance the
  106. control over the GUI, SunWindow was born.
  107.  
  108.    SunWindow offers several things to make the life easier with your
  109. daily work. Some of these features are now described:
  110.  
  111.    * SunWindow offers several *hotkeys* for controlling windows and
  112.      screens, therefore it serves as a kind of replacement for FKey (by
  113.      Commodore). Windows can be moved, sized, zipped and closed by
  114.      hotkeys. Sizing has been enhanced in a way which makes it now
  115.      possible to size a window in any direction. Screens can be moved
  116.      and shuffled, as you would do it with the mouse.
  117.  
  118.    * *Public screens* are automatically under SunWindow's control (and
  119.      they are the *only* kind of screens on which all of SunWindow's
  120.      screen and window operations will take affect). If such a screen
  121.      is bigger than the displayable area of your monitor, SunWindow
  122.      offers you the possibility to display the whole screen as a
  123.      thumbnail display in a seperate small window. On this display all
  124.      of the screen's windows are redisplayed, and you can perform
  125.      several actions on these windows, like bringing a window to front,
  126.      making a selected window visible or just moving the windows around
  127.      to get the screen cleaned up.
  128.  
  129.    * SunWindow offers you a *SunMouse* feature. This means, if your
  130.      mouse stops over a part of a window, the window will become the
  131.      active window, could be made visible or just brought to front.
  132.  
  133.    * SunWindow offers you also the unique possibility to *remember* up
  134.      to ten different positions of your mouse (also on different
  135.      screens). With just a fingertip on a hotkey you can jump back to
  136.      any or these remembered positions, without looking through
  137.      different screens and searching around a big screen to find the
  138.      desired window/position.
  139.  
  140.    * On big public screens new windows may not be visible, when they
  141.      are opened. This can be controlled by SunWindow, so that the user
  142.      will notice every new window, by just centering the display around
  143.      every new window (this means making the window visible). In
  144.      addition, if the last active window becomes the active one after a
  145.      window is closed, the former window can be made visible by
  146.      SunWindow.
  147.  
  148.    Again, to offer you a example of the SunWindow's thumbnail display
  149. option of a big public screen, here's a small graphic:
  150.  
  151.      < ----  visible area of the  ----> < -- only reachable with   -- >
  152.                 public screen                 autoscroll feature
  153.      
  154.      ------------------------------------------------------------------
  155.      |=== Tool-                       :                               | /\
  156.      || | manager                     :                               | v
  157.      || | window                      :  ==========================   | i
  158.      || |                             :  |                        |   | s
  159.      || |                             :  |     Workbench          |   | i
  160.      || |                             :  |                        |   | b
  161.      |---                             :  |       Window           |   | l
  162.      |                                :  |                        |   | e
  163.      |                                :  |                        |   |
  164.      |                                :  |                        |   | a
  165.      |                       ----------  |                        |   | r
  166.      |                 Sun-  |§     ##|  |                        |   | e
  167.      |                 Window|      ##|  |                        |   | a
  168.      |                       |        |  |                        |   |
  169.      |                       |%%%     |  |                        |   |
  170.      |                       |        |  --------------------------   |
  171.      |.......................----------                               | \/
  172.      |                                                                | /\
  173.      |                                                                | r
  174.      |                                                                | e
  175.      |                                                                | s
  176.      |                                                                | t
  177.      | ==============================                                 |
  178.      | |                            |                                 | o
  179.      | |          Shell             |                                 | f
  180.      | |                            |                                 |
  181.      | |                            |                                 | s
  182.      | ------------------------------                                 | c
  183.      |                                                                | r
  184.      |                                                                | e
  185.      |                                                                | e
  186.      |                                                                | n
  187.      |                                                                | \/
  188.      ------------------------------------------------------------------
  189.  
  190.    In this example SunWindow opens you a small display window in the
  191. right bottom of the displayed area of the screen. Now you can control
  192. the whole screen via this small display by just clicking on a window or
  193. the background to go to the desired window or screen area. Also the
  194. windows can be moved, brought to front or made visible.
  195.  
  196.  
  197. System Requirements
  198. ===================
  199.  
  200.    SunWindow uses some new features introduced by version 2 of the
  201. Amiga's OS. Therefore of course Kickstart 2.0 or higher are required.
  202. User of Kickstart 3.0 will notice some small enhancements in the
  203. preference program of SunWindow.
  204.  
  205.    If you are using the *<opaque movement>* feature of SunWindow, a
  206. fast processor and graphic display are recommanded.
  207.  
  208.    SunWindow and the preference programm will take advantage of the
  209. `reqtools.library' (C) by Nico Francois. Please read the supplied
  210. document on this library in the distribution package.
  211.  
  212.  
  213. How To Install SunWindow
  214. ========================
  215.  
  216.    Before you run SunWindow for the first time, you should consider the
  217. following things:
  218.  
  219.    * You need the `reqtools.library' in your `LIBS:' drawer (V37 or
  220.      higher).
  221.  
  222.    * You need a valid preference file in your `ENV:' drawer. The
  223.      preference file usually resides in your `ENVARC:' drawer and is
  224.      called `SunWindow.prefs'. If the preference file is placed in the
  225.      `ENVARC:' drawer, it'll be automatically copied to the `ENV:'
  226.      drawer during booting.
  227.  
  228.    * The SunWindow's preference program should have been run, and the
  229.      options should have been saved once before the first use of
  230.      SunWindow. This ensures that the path of the preference program is
  231.      valid and therefore the preference program is accessable via a
  232.      hotkey.
  233.  
  234.    * And of course you should have read the manual!
  235.  
  236.    If you are familar to your Amiga, I am sure you will know how to
  237. setup your system correctly for the first use. If not, follow these
  238. steps:
  239.  
  240.    * Enter a shell by double clicking the shell's icon at your `Tools'
  241.      drawer on the Workbench disk which comes with your Amiga.
  242.  
  243.    * Insert the SunWindow distribution disk in diskdrive *df0:*. (This
  244.      is normally the internal drive.)
  245.  
  246.    * Now type the following lines in your shell, and press "RETURN"
  247.      after each line:
  248.  
  249.               cd DF0:
  250.               copy SunWindow#? SYS:Utilities
  251.               copy SWPrefs#? SYS:Prefs
  252.               copy LIBS/reqtools.library LIBS:
  253.               copy ENV/#? ENVARC:
  254.  
  255.      The first line switches to the disk drive. The following lines
  256.      copy the files you need to run SunWindow. Therefore these lines
  257.      will copy SunWindow to the `Utilities' drawer of your SYS: drive
  258.      (usually the disk with which you booted, or the hardisk partition
  259.      which includes the Workbench). You may want to alter this line to
  260.      place SunWindow into the `WBStartup' drawer, to have SunWindow
  261.      available each time you startup your system. Just replace
  262.      `Utilities' with `WBStartup'. Also the preference program
  263.      `SWPrefs' is copied to the `Prefs' drawer of your SYS: drive. Of
  264.      course this path may also be changed, to your prefered destination
  265.      drawer. Be sure to copy the ENV: drawer. If you won't do so, you
  266.      might have to do a *lot* of initializations in the preference
  267.      program.
  268.  
  269.    * If you are using Kickstart 3.0 or higher, you perhapes like the
  270.      only documentation available. If so, just add the following line:
  271.      `copy LANGUAGE/SunWindow.guide HELP: LANGUAGE' where LANGUAGE is a
  272.      replacement for the language you prefer actually only `English'
  273.      and `Deutsch' are available). Please read the chapter about
  274.      MULTIVIEW in your system documentation for further informations.
  275.  
  276.    * Now close the shell, it's no longer needed.
  277.  
  278.    * Enter your `Prefs' drawer, or the drawer where you copied the
  279.      preference program, and start the preference program of SunWindow,
  280.      called `SWPrefs'.
  281.  
  282.    * Apply some changes to the options you want to alter or just do
  283.      nothing. Leave the program by pressing the "SAVE" button. This
  284.      saves the options in both, the `ENVARC:' and `ENV:' drawer. Also
  285.      it ensures, that the path for the preference program is setup
  286.      correctly and usable for a quick startup of the preference program
  287.      via a hotkey.
  288.  
  289.    * Now you are ready to run SunWindow. Just double click on its icon
  290.      in the drawer where you have copied it. (Usually the `Utilities'
  291.      drawer, as shown above, or the `WBStartup' drawer.)
  292.  
  293.  
  294. The Features And Usage Of SunWindow
  295. ***********************************
  296.  
  297.    This chapter covers the usage and features of SunWindow. First, the
  298. usage is discussed and then all the features are explained. Because
  299. there are so many different features, the chapter is devided into
  300. several sections. The options are all set by the preference program
  301. `SWPrefs'. Read the chapter about `SWPrefs', to learn more about its
  302. usage.
  303.  
  304.  
  305.  
  306. The Usage Of SunWindow
  307. ======================
  308.  
  309.    SunWindow is very easy to use. To start SunWindow, just do a double
  310. click on its icon. If you are a Shell/CLI fan you can also start
  311. SunWindow via a Shell/CLI. Note that SunWindow won't start a background
  312. task, if started from a Shell/CLI. All general tooltype values are
  313. accepted as well as by a start from Workbench or CLI. Read your system
  314. manual for more information about general tooltypes. Normally no
  315. tooltype values are required, because every option is set by the
  316. preference program. Anyway, tooltype values have a higher priority over
  317. the values set by SWPrefs. If you want to run SunWindow at system
  318. startup, please place SunWindow in your `WBStartup' drawer and add a
  319. "DONOTWAIT" tooltype to the tooltypes of SunWindow's icon.
  320.  
  321.    There are several ways of quitting SunWindow. The easiest way is to
  322. press the middle mousebutton of a three button mouse, while the
  323. thumbnail display is the active window. Of course not many user own a
  324. three button mouse and therefore there are three other possibilities of
  325. quitting SunWindow. First you can use the `Exchange' program supplied
  326. by Commodore to quit SunWindow, second, you can send a CTRL-C signal, by
  327. pressing CTRL-C, if you started SunWindow via a Shell/CLI and third,
  328. you can rerun SunWindow. All quitting methods will popup a requester
  329. where you should confirm.
  330.  
  331.    Mostly you don't want SunWindow to quit, but just stop working. Use
  332. the hotkey for disabling SunWindow or the previously named `Exchange'
  333. program. Because SunWindow is a commodity, all of the standard
  334. commodity functions can be controlled with ` Exchange'. Another
  335. circumstance of commodities in general is that if you close its window,
  336. the commodity is *not* quitted, instead it's only disabled. Read your
  337. system documentation, to learn more about the internal functionality of
  338. commodities.
  339.  
  340.    All other functions of SunWindow can be controlled by hotkeys or the
  341. preference program of SunWindow: SWPrefs. Go on reading the next
  342. sections, to learn more about these functions.
  343.  
  344.  
  345. SunWindow and windows
  346. =====================
  347.  
  348.    With SunWindow you get a greater control over windows. The following
  349. options can be set in the preference program, to get the desired
  350. behaviour of SunWindow. All of the "window" options are located in the
  351. "screen actions" group of the preference program, because of their
  352. connection to a plain usage of SunWindow (this means, running
  353. SunWindow, without the thumbnail display).
  354.  
  355.    * *<center activated>* This option tells SunWindow to make the
  356.      active window visible on a screen by centering the display around
  357.      this window. Therefore every time a window becomes active, it will
  358.      be automatically made visible.
  359.  
  360.    * *<center opened>* This option tells SunWindow to center a newly
  361.      opened window. Every time a window opens on the screen, which
  362.      SunWindow is just controlling (normally this is the
  363.      active/frontmost screen), it will be centered.
  364.  
  365.    * *<center closed>* This option tells SunWindow, that if a window is
  366.      closed and the last active window becomes active, it will be
  367.      centered. Of course setting this option is needless if you have
  368.      just selected the *<center activated>* option.
  369.  
  370.    * *<active to front>* Setting this option causes every active window
  371.      to become the topmost window.
  372.  
  373.  
  374. Screen features
  375. ===============
  376.  
  377.    SunWindow only controls public screens. This means, that you can't
  378. use any feature of SunWindow on a non public screen. This is not
  379. because it might be a programming problem, but it is a problem of other
  380. software integraty. If a program opens a non public screen, it just
  381. doesn't want any other software's windows or other software's control
  382. on its screen. Therefore SunWindow was considered not to control these
  383. screens.
  384.  
  385.    But how operates SunWindow with screens? Actually nearly not. Most
  386. of SunWindow's screen control features can be reached via hotkeys,
  387. described in the second next section. There is only to mention, that
  388. SunWindow automatically "jumps" to and from screens to reach the topmost
  389. screen. Using SunWindow always causes the topmost screen to become the
  390. active screen, by activating the last active window of this screen!
  391. This is normally *not* handled by Intuition! Take care that this
  392. circumstance is different to the normal behaviour of your GUI.
  393.  
  394.  
  395. The thumbnail display
  396. =====================
  397.  
  398.    As explained in the introduction, SunWindow is able to display the
  399. whole screen in a little window. This window is called the thumbnail
  400. display. In the thumbnail display all windows are displayed as they are
  401. positioned on the screen. With this thumbnail display you can nearly do
  402. everything to windows, as you would do it on the real screen. Therefore
  403. the thumbnail display acts as a kind of remote control for you.
  404.  
  405.    If you want a specific window made visible, just click on the window
  406. in the thumbnail display. If you want the window moved to somewhere
  407. else, just click and move the window. These are only some examples, how
  408. you could use this thumbnail display. More complex actions can be
  409. performed by selecting one or more of the following options.
  410.  
  411.    Several options may be set to the behaviour of this thumbnail
  412. display. But always keep in mind that all the actions you perform on
  413. the thumbnail display are also performed on the screen (of course) and
  414. therefore the options which you chose to work on windows will also
  415. affect the action! The options which you might choose for the display
  416. are listed in the preference program in the ""Display actions"" group
  417. and they are:
  418.  
  419.    * *<activate window>* Every time you click on a window this window
  420.      will become the active window with this option set.
  421.  
  422.    * *<window to front>* A window you selected by clicking on it will
  423.      automatically be brought to front.
  424.  
  425.    * *<center window>* This might be the most useful option. Just click
  426.      on a window and this window will be immediately made visible for
  427.      you and centered on your monitor display.
  428.  
  429.    * *<opaque movement>* You might want to set this option, if you have
  430.      a fast processor paired with a fast graphics display! This option
  431.      causes all window movements to be processed in realtime, this
  432.      means that you will immediatly see, where the window is moved to.
  433.  
  434.    * *<handle backdrops>* Normally there is no difference between
  435.      backdrop windows and non backdrop windows. Backdrop windows are a
  436.      special feature of the OS. If you set this option, you can't make
  437.      backdrop windows visible by clicking on them. Instead the area
  438.      around the mousepointer is made visible! This is very useful by
  439.      using the "Workbench" window as a backdrop window.
  440.  
  441.    * *<display titles>* When this option is set the titles of the
  442.      windows are also displayed in the thumbnail display. Unortunately
  443.      sometimes the titles can't be displayed because of a space
  444.      problem, then simply nothing happens.
  445.  
  446.    The following options and settings affect the lookout of the
  447. thumbnail display and are therefore located in the ""Display settings""
  448. group of the preference program.
  449.  
  450.    * *<3D-Look>* With this option set, the windows are displayed as
  451.      buttons. Normally they are displayed as plain coloured boxes.
  452.  
  453.    * *<View border>* Set this option if you want a dotted line being
  454.      drawn in the thumbnail display, to indicate you the actual
  455.      displayed clip.
  456.  
  457.    * *<Close gadget>* With this option set, a close gadget is attached
  458.      to the thumbnail display window. The close gadget doesn't cause
  459.      SunWindow to end (SunWindow is a commodity!), it just causes the
  460.      display to be closed! Of course, also a dragbar is added, but you
  461.      can't move the display with it.
  462.  
  463.    * *<drag bar>* Set this option if you want a dragbar attached to the
  464.      thumbnail display. Now you can move the window anywhere you like,
  465.      and it will stay at this relative position, everytime you move the
  466.      screen, instead of the default position.
  467.  
  468.    * *<keep aspect>* Normally you can specify the width and height of
  469.      the thumbnail display in pixels. If you set this option, you can
  470.      only specify the width of the display, the height is calculated,
  471.      to give you the best impression of the real proportions of the
  472.      screen, SunWindow is just controlling.
  473.  
  474.    * *<X-Coord>* This value specifies the relative x-coordinate of the
  475.      left top edge of the thumbnail display.
  476.  
  477.    * *<Y-Coord>* This value specifies the relative y-coordinate of the
  478.      left top edge of the thumbnail display.
  479.  
  480.    * *<width>* This value specifies the width of the thumbnail display.
  481.  
  482.    * *<height>* This value specifies the height of the thumbnail
  483.      display.
  484.  
  485.    * *<Placement>* Choose the default location of the thumbnail display.
  486.      Setting "Individual" will take the values of *<X-coord>* and
  487.      *<Y-coord>* to take affect. Setting one of the four corners will
  488.      cause SunWindow to open the thumbnail 1 pixel away of the selected
  489.      corner, so you can reach a possible hidden gadget. (Mostly the
  490.      size, screen cycle or close gadget).
  491.  
  492.  
  493. Hotkey features
  494. ===============
  495.  
  496.    Hotkeys? What is a hotkey? A hotkey is a keyboard shortcut for a
  497. specific function. This means, that if you are using a hotkey for a
  498. function you can choose, which key presses of your keyboard will act
  499. for/start this function. Therefore a hotkey is a shortcut for
  500. operations or functions which are normally only hard to get or
  501. sometimes impossible to get.
  502.  
  503.    With the hotkey feature of SunWindow you get a kind of control over
  504. screens and windows you might have dreamed of. Because there are so
  505. many hotkeys available, they are again described in several subsections.
  506.  
  507.  
  508. Hotkeys For Window Operations.
  509. ------------------------------
  510.  
  511.    Below is a list of all the hotkeys of SunWindow which allow you to
  512. manipulate your windows in a way (or even better) which is normally
  513. only possible with a mouse. The first expression after an item bullet
  514. is the name of the hotkey as it would appear in the hotkey list of the
  515. preference program.
  516.  
  517.    * *<recenter window>* Imagine this: you have just activated a
  518.      Shell/CLI and want to type something in it. Now you have looked up
  519.      some information in a window you can't see, because it's somewhere
  520.      else on the screen. You only looked up this information, but didn't
  521.      activate the informative window, so you only moved the screen.
  522.      O.k., now you know your information, but where is the shell? Just
  523.      use this hotkey to make the active window visible again, if you
  524.      moved the screen.
  525.  
  526.    * *<window cycle forward>* With this hotkey you can cycle through
  527.      all the windows of the active (topmost) screen in "forward"
  528.      direction. If you selected some other features of SunWindow, this
  529.      window might be made visible, brought to front or/and made
  530.      activated.
  531.  
  532.    * *<window cycle backwards>* The hotkey with the same functionality
  533.      as *<window cycle forward>*, but of course in reverse direction.
  534.  
  535.    * *<enlarge window...>* There are eight hotkeys for enlarging a
  536.      window. With the hotkeys of SunWindow a window can be enlarged in
  537.      every direction. The direction is always written in brackets. For
  538.      example the hotkey for enlarging a window to its left bottom is
  539.      labeled *<enlarge window (left bottom)>* in the hotkeys list.
  540.  
  541.    * *<reduce window...>* Again eight hotkeys for the reverse action of
  542.      enlarging a window. See hotkey description for: *<enlarge
  543.      window...>*.
  544.  
  545.    * *<move window...>* And again eight hotkeys for just moving a
  546.      window around the screen. See also the hotkey description for:
  547.      *<enlarge window...>*
  548.  
  549.    * *<toggle zip state of window>* This hotkey has the same
  550.      functionality as pressing the zip gadget of a window. Of course,
  551.      if there is no zip gadget, you can't toggle the zip state of a
  552.      window.
  553.  
  554.    * *<maximize window>* By pressing this hotkey you enlarge the window
  555.      to its maximum dimensions. Notice, that this dimension is
  556.      controlled by the program, which opened the window, and not by
  557.      SunWindow.
  558.  
  559.    * *<minimize window>* This is the reverse action to *<maximize
  560.      window>*.
  561.  
  562.    * *<window to front>* Just press this hotkey to bring a hidden,
  563.      active window to front.
  564.  
  565.    * *<window to back>* Again a reverse action. See *<window to front>*.
  566.  
  567.    * *<close window>* This hotkey has the same affect as pressing the
  568.      close gadget of a window. Of course: if there is no close gadget,
  569.      you can't close the window! Notice that a window is only closed,
  570.      if the program controlling the window allows the window to be
  571.      closed!
  572.  
  573.  
  574. Hotkeys For Screen Operations.
  575. ------------------------------
  576.  
  577.    Below is a list of all the hotkeys of SunWindow which allow you to
  578. manipulate your screen in a way (or even better) which is normally only
  579. possible with a mouse. The first expression after an item bullet is the
  580. name of the hotkey as it would appear in the hotkey list of the
  581. preference program.
  582.  
  583.    * *<move screen...>* There are eight hotkeys for moving a screen.
  584.      With the hotkeys of SunWindow a screen can be moved in every
  585.      direction. The direction is always followed after the *<move
  586.      screen>* keyword. For example the hotkey for moving a screen left
  587.      down is labeled *<move screen left down>* in the hotkeys list.
  588.  
  589.    * *<cycle screens backward>* With this hotkey you can switch a
  590.      screen to the back. The new topmost screen will become the active
  591.      screen by activating its last active window.
  592.  
  593.    * *<cycle screens forward>* The reverse action to *<cycle screens
  594.      backward>*.
  595.  
  596.  
  597. Hotkeys For Miscellaneous Operations.
  598. -------------------------------------
  599.  
  600.    Below is a list of all the hotkeys of SunWindow which offer you a
  601. greater power for your system -- or are just standard hotkeys. The
  602. first expression after an item bullet is the name of the hotkey as it
  603. would appear in the hotkey list of the preference program.
  604.  
  605.    * *<call preferences>* This hotkey allows you to start the
  606.      preference program of SunWindow with a simple keypress.
  607.  
  608.    * *<show/close view>* This hotkey opens or closes the thumbnail
  609.      display of the screen. This is useful if you only want to use the
  610.      hotkey features, or some other features of SunWindow, which don't
  611.      rely on this display.
  612.  
  613.    * *<enable/disbale>* This hotkey enables or disables all of
  614.      SunWindow's functions. This is always needed, if you want to
  615.      change the screen mode of a screen! It is not enough, to only
  616.      close the thumbnail display!
  617.  
  618.    * *<remember position xx>* There are ten hotkeys for remembering a
  619.      specific position of the mouse on a screen with the active window!
  620.      The *xx* indicates the number (1-10) of the position you want to
  621.      remember.
  622.  
  623.    * *<jump to position xx>* These are the ten hotkeys for jumping to a
  624.      previously remembered position with the *<remember position xx>*
  625.      hotkeys. The *xx* indicates a number (1-10). The remembered screen
  626.      is brought to front, the mouse is repositioned to the remembered
  627.      position and the remember window is activated. If the screen is
  628.      gone, nothing happens, if the window is gone, only the mouse is
  629.      repositioned.
  630.  
  631.  
  632. Installation Of Hotkeys.
  633. ------------------------
  634.  
  635.    Hokeys are installed very easily with the preference program of
  636. SunWindow. Just select the hotkey which you want to install and specify
  637. a keyboard shortcut for it. After exiting the preference program, the
  638. hotkey should be ready for usage. If the keyboard shortcut definition
  639. is wrong, a requester will popup, where you can correct the hotkey or
  640. simply alter its definition. But this requester is just a short
  641. solution! Don't forget to correct/alter your definition in the
  642. preference program, too!
  643.  
  644.    NOTE: a requester will also popup with a *correct* definition, if
  645. another hotkey with the same definition is already in use!
  646.  
  647.    But how is the syntax for defining a hotkey? It's very easy and
  648. intuitive:
  649.  
  650.    * first decide, wether you want a hotkey connected with a keyboard
  651.      shortcut or with the mouse. If you choose the keyboard go on
  652.      reading the next item, else write done "rawmouse" as the first
  653.      item in the definition string.
  654.  
  655.    * now chose one or more qualifiers for your shortcut. A qualifier is
  656.      one of the following items:
  657.         - *lshift* for the left shift key on the keyboard.
  658.  
  659.         - *rshift* for the right shift key on the keyboard.
  660.  
  661.         - *capslock* for the "Caps Lock" key.
  662.  
  663.         - *control* for the control key labeled "Ctrl"
  664.  
  665.         - *lalt* for the left "Alt" key on the keyboard.
  666.  
  667.         - *ralt* for the right "Alt" key on the keyboard.
  668.  
  669.         - *lcommand* for the amiga key labeled "A", left to the space
  670.           bar.
  671.  
  672.         - *rcommand* for the amiga key labeled "A", right to the space
  673.           bar.
  674.  
  675.         - *numericpad* for a key on the numericpad (if accessable).
  676.  
  677.         - *repeat* for key repeat (if you hold down a key long enough).
  678.  
  679.         - *lbutton* for the left mouse button.
  680.  
  681.         - *rbutton* for the right mouse button.
  682.  
  683.         - *midbutton* for the middle mouse button, if available.
  684.  
  685.      You can also just specify a group of qualifiers:
  686.         - *shift* for any shift key.
  687.  
  688.         - *alt* for any "Alt" key.
  689.  
  690.         - *command* for any Amiga key (next to the space bar).
  691.  
  692.      Now write down this qualifier(s) in your hotkey definition string.
  693.      Add a minus before those qualifiers you want to be ignored when
  694.      pressed.
  695.  
  696.    * Now choose wether you want upstrokes or not or both. Just ad
  697.      "upstroke" to your definition string, if you want only upstrokes.
  698.      Leave it, if you want only downstrokes. Add it with a preceding
  699.      minus if you want both. Adding "upstroke" is optional.
  700.  
  701.    * Add a highmap keycode, or an ANSI-Code to your definition string.
  702.      This is also optional. A highmap keycode is one of the following
  703.      items:
  704.         - *space* for the space bar.
  705.  
  706.         - *backspace* for the backspace key. ("<-")
  707.  
  708.         - *f1 ... f10* for one of the "F-Keys".
  709.  
  710.         - *esc* for the key labeled "Esc".
  711.  
  712.         - *tab* for the tabulator key. (above the "Ctrl" key).
  713.  
  714.         - *enter* for the key labeled "Enter".
  715.  
  716.         - *return* for the return key.
  717.  
  718.         - *del* for the key labeled "Del".
  719.  
  720.         - *help* for the key labeled "Help".
  721.  
  722.         - *up, down, left, right* for one of the direction keys.
  723.  
  724.      An ANSI-Code is just the character you get by pressing a "normal"
  725.      key. (e.g. "a").
  726.  
  727.    Now you did everything which is needed, for a complete hotkey
  728. definition. Here some examples, which might explain it a little bit
  729. better:
  730.  
  731.    * *lshift alt f2*: press the left shift key with any "Alt" key and
  732.      the "F2" key simultaniously.
  733.  
  734.    * *-shift control a*: press the control key and the key which
  735.      "produces" the "a" simultaniously. If you want you can also press
  736.      any shift key.
  737.  
  738.    NOTICE: There is a bug in Kickstart 2, which prevents you using the
  739. mousebuttons. In version 3 of the Kickstart, this bug is fixed.
  740.  
  741.  
  742. Miscellaneous Features
  743. ======================
  744.  
  745.    There are some features left, which didn't fit into one of the
  746. previous sections. They are therefore placed in the ""Miscellaneous""
  747. group of the SunWindow preference program (except for the *<SunMouse>*
  748. options, which are placed in the ""Screen actions"" group, because they
  749. take only affect screens.)
  750.  
  751.    The features are:
  752.  
  753.    * *<startup window>* This option causes the preference program to be
  754.      run at startup of SunWindow, where you can do quick changes.
  755.  
  756.    * *<T:>* This is a shortcut for the task priority of SunWindow.
  757.      Normally different programs are run at task priority level 0.
  758.      Workbench runs at level 1 (so it get's more CPU-time in very busy
  759.      situations). Background tasks may want to run at level -1, which
  760.      causes them to loose the CPU in busy situations. Choose the
  761.      priority you prefer.
  762.  
  763.    * *<C:>* This is a shortcut for the commodity priority. Commodities
  764.      use the same information data stream. Usually the commodity with
  765.      the highest priority will get the information first. A commodity
  766.      with low priority later. This may cause some lost of informations,
  767.      because commodities are allowed to strip informations from the
  768.      information stream. The default priority should be 0.
  769.  
  770.    * *<U:>* This is a shortcut for the update time of SunWindow in 1/10
  771.      of a second. This will only affect the time, how fast SunWindow
  772.      will react to changes on the screen, and this value may be
  773.      strongly influenced by the task priority of SunWindow. A value of
  774.      3 is a nice try to start.
  775.  
  776.    * *<SunMouse feature>* This option enables the SunMouse feature of
  777.      SunWindow, if set. SunMouse feature means, that always the window
  778.      under the mouse will be activated.
  779.  
  780.    * *<SunMouse delayed>* If this option is set, the window will only
  781.      be activated, if the mouse stopped over a window, for a specified
  782.      amount of time. You may only set this option if you have already
  783.      enabled the *<SunMouse feature>* option.
  784.  
  785.    * *<SunMouse reaction...>* This is the time value for the *<SunMouse
  786.      delayed>* option in 1/10 of a second. A value of 4 is a good delay
  787.      time.
  788.  
  789.  
  790. The Preference Program: SWPrefs
  791. *******************************
  792.  
  793.    When you correctly installed SunWindow, you'll find a program called
  794. "SWPrefs" in the "Prefs" drawer of your startup disk/hardisk partition.
  795. This is the preference program for SunWindow. With this program you can
  796. set all the options SunWindow offers you. When you start SWPrefs you
  797. find a lot of options divided into four groups, concerning their
  798. functionality. There is a "Display actions", a "Screen actions", a
  799. "Display settings" and a "Miscellaneous" group (from top left to right
  800. bottom), additionally to the most right is a control panel attached.
  801. Each group is now explained:
  802.  
  803.    The "Display actions" group contains all those options which concern
  804. the thumbnail display of SunWindow. The different options are descriped
  805. in the "Usage" chapter, section "Display".
  806.  
  807.    The "Screen actions" group contains all those options which concern
  808. the screen directly, this means that this options can be used without
  809. the thumbnail display. The different options are described in the
  810. chapter "Usage", section "Window", "Screen" and "Miscellaneous".
  811.  
  812.    The "Display settings" group contains, of course, the settings for
  813. the thumbnail display. The different settings are described in the
  814. "Usage" chapter, section "Display".
  815.  
  816.    The "Miscellaneous" group contains some settings which contain the
  817. internal functionality of SunWindow, here you can set priorities, etc.
  818. There is also a button labeled "Keys..." which takes you to the hotkey
  819. definition window. The different options in this group are described in
  820. the "Usage" chapter, section "Miscellaneous". The hotkey definition
  821. window is described below.
  822.  
  823.    The control panel on the right of the display has seven buttons.
  824. They are now explained from top to down:
  825.  
  826.    * *About*: This button opens a little window with information of this
  827.      version of SunWindow. The version number, revision number and
  828.      registered user is displayed here, as well as a copyright notice.
  829.  
  830.    * *Load*: This button reloads the last saved settings from the
  831.      ENVARC: drawer.
  832.  
  833.    * *Load as ...*: This button let's you choose a differnt settings
  834.      file, previously saved with the *Save as ...* button.
  835.  
  836.    * *Save*: This button saves the settings in the ENVARC: drawer as
  837.      well as in the ENV: drawer. SunWindow will get notified about the
  838.      new settings. SWPrefs ends after saveing the settings.
  839.  
  840.    * *Save as ...*: This button let's you save the settings to a
  841.      different place of your choice. SunWindow won't get notified about
  842.      this settings, until they are placed in the ENV: drawer. SWPrefs
  843.      ends after saveing the settings.
  844.  
  845.    * *OK*: This button saves the settings only in the ENV: drawer. This
  846.      means, no permanent changes are done to the settings file saved on
  847.      disk in the ENVARC: drawer. SWPrefs ends after saving the settings.
  848.  
  849.    * *CANCEL*: This button quits SWPrefs and leaves all settings
  850.      untouched.
  851.  
  852.    NOTICE: Closing the preference's window has the same effect as
  853. pressing the *OK* button. It saves the settings in the ENV: drawer and
  854. quit's SWPrefs.
  855.  
  856.    By pressing the "Keys..." button in the "Miscellaneous" group,
  857. another window opens with a big list view, containing all the hotkeys
  858. SunWindow offers you. Below this list view is a string gadget, where
  859. the actual defintion of a hotkey is displayed and can be edited. Two
  860. buttons labeled "OK" and "Cancel" are attached to the bottom of the
  861. window. If you want to change a hotkey just select it from the list
  862. view, by either using the mouse or the h key (unshifted scrolls down,
  863. shifted scrolls up). The definition is then displayed in the string
  864. gadget. Activate the string gadget with the mouse or by pressing e and
  865. edit the defintion. Press RETURN when finished. Go on with all the
  866. other hotkeys you want to change. When finished, press the "OK" button
  867. to overtake the new definitions (or just close the window), press
  868. "CANCEL" if you think you were doing something wrong.
  869.  
  870.    NOTICE: The hotkeys' definitions are *not* checked, wether they are
  871. correct or not. Only if you save the settings, SunWindow will check
  872. them, and popup a requester for the wrong definitions. Please correct
  873. them in the requester *and* with SWPrefs!
  874.  
  875.    NOTICE: If you want to disable a hotkey, just enter nothing, or
  876. clear the actual definition.
  877.  
  878.  
  879. Other Things You Want To Know
  880. *****************************
  881.  
  882.    This chapter is devided into several sections with additional
  883. informations.
  884.  
  885.  
  886. How to register
  887. ===============
  888.  
  889.    SunWindow was now developed over one year during my study on
  890. University. Because I had to invest a lot of time, and can't just work
  891. for fun, SunWindow was decided to be SHAREWARE. This means, that you
  892. can test SunWindow for a period of time (I understand up to four weeks)
  893. and if you like it you are recommanded to register, to get access to
  894. the fully working version.
  895.  
  896.    A registered user will receive a keyfile. This keyfile is placed in
  897. the DEVS: drawer. With this keyfile you can use this version of
  898. SunWindow and any other version/revisions becoming available.
  899.  
  900.    To register for SunWindow just fill in the following registration
  901. form, and send it to the supplied address. Your registration will be
  902. handled within a week, outside Germany registrations may take a longer
  903. time.
  904.  
  905.                                 REGISTRATION FORM
  906.      
  907.         I want to register for SunWindow. I am currently usin Version ____
  908.         Revision _____ . I received this version by/from _________________
  909.         The registration fee is US$ 20 (outside Germany) or DM 20 (inside
  910.         Germany).
  911.      
  912.         My address:
  913.         __________________________________________________________________
  914.         __________________________________________________________________
  915.         __________________________________________________________________
  916.         __________________________________________________________________
  917.      
  918.         EMail: ___________________________________________________________
  919.      
  920.         ( ) Please register me as a group. Ich want to use additional ___
  921.             copies of SunWindow in my group. I will therefore receive these
  922.             copies for the special group price of 5 US$ / 5DM for each
  923.             additional copy (*)
  924.      
  925.         ( ) I already registered. Please send me the latest version
  926.             of SunWindow. I will wait up to ___ weeks, if a new version
  927.             or revision is just under development. The sharing of expenses
  928.             is US$ 5 (outside Germany) / DM 5 (Germany only). There is
  929.             NO fee for updates sent to you via e-mail.
  930.      
  931.         ( ) I want to receive my copy as fast as possible. Please send it
  932.             to me by e-mail. (about 290kB. lha-File uuencoded)
  933.      
  934.         This mail includes US$/DM _______  in the form of
  935.         ( ) plain money    ( ) EuroCheck
  936.                  *** SPECIAL COUNTRY CHECKS ARE NOT ACCEPTED! ***
  937.      
  938.         I am using an Amiga: ___________   Processor: 680__0
  939.         Kickstart:  ( )1.2  ( )1.3  ( )2.0  ( )3.0  ( ) ___
  940.         RAM: ___ MB Fast, ___ MB Chip
  941.         graphic card: ____________________________________________________
  942.         additional special hardware: _____________________________________
  943.      
  944.         Additional informations, comments and enhancement ideas:
  945.         __________________________________________________________________
  946.         __________________________________________________________________
  947.         __________________________________________________________________
  948.         __________________________________________________________________
  949.         __________________________________________________________________
  950.         __________________________________________________________________
  951.      
  952.         (*) please add the adress/name of the group.
  953.      
  954.         Date: _______________  Signature: ________________________________
  955.  
  956.    Please send this registration form to:
  957.  
  958.         Bernhard Scholz
  959.         Steinbruchstr. 9
  960.         82398 Polling
  961.      
  962.         Germany
  963.  
  964.  
  965. How To Receive Updates
  966. ======================
  967.  
  968.    As a registered user you will recieve a copy of the latest version
  969. of SunWindow, including a keyfile. With this keyfile you get
  970. independent from direct sendings of the author, instead you can use the
  971. actual distributed version on the aminet, or some PD-series.
  972.  
  973.    If you don't have access to the aminet or PD-series, of course you
  974. will get updates directly from the author on request. For the first
  975. time an update is available, every registered user will get an
  976. information about it. If you don't take advantage of this new version,
  977. no further informations are sent. Of course every new version will be
  978. released on several PD-Series, and most revisions will be released in
  979. electronic form on the aminet, therefore users will get notified about
  980. the further development of SunWindow.
  981.  
  982.    If you want to get an update directly from the author, there are two
  983. possible ways:
  984.    * Write to the author and include 5 US$ if you are living outside
  985.      Germany, or DM 5 if you are living in Germany. The latest version
  986.      will be sent to you as fast as possible.
  987.  
  988.    * Wirte an electronic mail to the author, if you want to get the
  989.      latest update via e-mail (lha-file uuencoded). This is the fastest
  990.      way to receive an update.
  991.  
  992.    The addresses for reaching the author are:
  993.  
  994.      Bernhard Scholz                 or: (e-mail)
  995.      Steinbruchstr. 9
  996.      82398 Polling            scholz@informatik.tu-muenchen.de
  997.      
  998.      Germany
  999.  
  1000.  
  1001. The Support You Get.
  1002. ====================
  1003.  
  1004.    There is simply NO support for *unregistered* users, except that
  1005. they will get notified of new version by looking on several PD-series
  1006. or the aminet, because every major enhanced release will be distributed
  1007. there.
  1008.  
  1009.    *Registered* users may send questions, comments and wishes to the
  1010. author, and they are surely considered for the next release and their
  1011. questions will be answered. Please note that only those questions can
  1012. be answered, by normal mail, if there is an amount of money included in
  1013. your letter, to send you the answer back! E-mail will of course be the
  1014. most convinient way to contact the author and to get answer.
  1015.  
  1016.  
  1017. Thanks To The People Who Helped.
  1018. ================================
  1019.  
  1020.    During the development of SunWindow several problems occured, and I
  1021. needed people for testing my software, or just commenting it. These
  1022. people helped me most:
  1023.  
  1024.    * *Martin Korndörfer*. For nearly every programming problem, he
  1025.      knowed a trick or solution. Also his "MagicMenu" is a great
  1026.      product! Take a look on it!
  1027.  
  1028.    * *Thomas Feistle*. For correcting the documentation, and his
  1029.      enhancments to it. Really much work, which I hate.
  1030.  
  1031.    * *Antje Karrasch*. For re-reading the docs.
  1032.  
  1033.    * *Christian Rattei*. For testing SunWindow on his A3000 and finding
  1034.      always a bug, when I just thought every bug was fixed. He is also
  1035.      the guy, who makes testing with the EGS System possible. Also take
  1036.      a look at his fantastic disk utility "FileFairy" which will soon
  1037.      be released!
  1038.  
  1039.    * *Christian Scholz*. He always had problems with SunWindow. This is
  1040.      useful for developing even better versions. He is also the guy,
  1041.      who painted the 8 colored icons.
  1042.  
  1043.    * *Bernhard Möllemann*. For his testing, and bugreports on the good
  1044.      old "original" Amiga A1000.
  1045.  
  1046.    * *Henning Schmiedehausen*. He sent most comments to the first
  1047.      version of SunWindow and tested it intensively. He also sent most
  1048.      Enforcer and Mungwall hits, just when I thought there are no more
  1049.      hits!
  1050.  
  1051.    * *Manfred Fichtl*. For testing SunWindow on his A4000 and giving me
  1052.      some ideas, how to enhance it.
  1053.  
  1054.    * *Peter Kunath and Frank Riffel*. Thanks also for testing and
  1055.      commenting. You should also register for their great work, the
  1056.      "DeliTracker", the best sound module player ever written for the
  1057.      Amiga.
  1058.  
  1059.    * *Matthias Scheler*. For managing #amigager on the IRC system.
  1060.  
  1061.  
  1062. The Future Of SunWindow
  1063. =======================
  1064.  
  1065.    With your registration you'll make a further development of
  1066. SunWindow possible. SunWindow in the present state fits my personal
  1067. needs and will therefore be only slightly enhanced. I will only go on
  1068. developing SunWindow, if there are enough registrations and enhancement
  1069. ideas. I thank all the people who will (and have already) register(ed)
  1070. and support(ed) this project. Remember: SHAREWARE products depend on
  1071. your support!
  1072.  
  1073.    Some ideas for the future, which might be included in the next
  1074. revisions:
  1075.    * Window iconifying.
  1076.  
  1077.    * Screen icons in a seperate window, so screens can be selected fast.
  1078.  
  1079.    * special mousepointers (animated) for windows which don't have
  1080.      their own special mousepointer design.
  1081.  
  1082.    * Annotator tool, for different actions.
  1083.  
  1084.    * sticky windows option
  1085.  
  1086.  
  1087. Questions and Answers
  1088. =====================
  1089.  
  1090.    Because SunWindow is a tool, which offers you a new feeling for you
  1091. computer, not everything might be common to the usual behaviour. But if
  1092. you have worked a while with SunWindow and got used to it's features,
  1093. I'm sure you won't want to miss them again! Also due to the programming
  1094. difficulties with the system of the Amiga, some problems might occour.
  1095. These Problem are now discussed:
  1096.  
  1097.    * *I just opened a new public screen but SunWindow's thumbnail
  1098.      display still runs on the old one.*
  1099.  
  1100.      Try to close the thumbnail display with the hotkey and reopen it.
  1101.      If the thumbnail display is still on the other screen, then your
  1102.      public screen is private!
  1103.  
  1104.    * *I want to change the ScreenMode, but something is still locking
  1105.      the screen!*
  1106.  
  1107.      SunWindow has a savety lock on the public screen it is
  1108.      controlling, therefore you have to disable SunWindow first. Only
  1109.      closing the thumbnail display isn't enough.
  1110.  
  1111.    * *If the thumbnail display is in front of another window, I just
  1112.      can't click this window to back!*
  1113.  
  1114.      This is normal, due to the internal operations of Intuition. Use
  1115.      the hotkey for bringing a window to back instead, or close the
  1116.      thumbnail display.
  1117.  
  1118.    * *In conjunction with MAGICMENU the systems seems to hang up
  1119.      sometimes.*
  1120.  
  1121.      There is no real solution, yet. But the system doesn't hang up.
  1122.      Intuition just locks the menu system, after a view seconds the
  1123.      system is usable again.
  1124.  
  1125.    * *I set the update time to 0, but sometimes SunWindow needs a long
  1126.      time reacting to changes on the screen.*
  1127.  
  1128.      You are running another task with a high task priority or a task
  1129.      which needs a lot of CPU-power. Try setting the task priority of
  1130.      SunWindow to 1, or simply wait until the busy task has ended.
  1131.  
  1132.    * *I am using a patch, which causes all requesters to become
  1133.      ReqTools requesters, but now all the requesters are automatically
  1134.      centered, even if I didn't specify this!*
  1135.  
  1136.      You have set the option for centering windows. Because all
  1137.      requesters are based on windows, this is a normal circumstance.
  1138.  
  1139.    * *I am using Directory Opus, but if I want to quit, Directory Opus
  1140.      pops up a requester telling to close all foreign windows?!*
  1141.  
  1142.      Directory Opus belongs to those kind of programs, which don't
  1143.      count on programming guidlines in some circumstances. Disable
  1144.      SunWindow, or put it to sleep, to get Directory Opus ending.
  1145.  
  1146.    * *I want to change the screen mode, but sometimes the system
  1147.      crashes!*
  1148.  
  1149.      Take care on specifying the new screen mode dimensions; it might
  1150.      be possible that SunWindow can't open it's display with this new
  1151.      (extrem) values!
  1152.  
  1153.    * *I am using a graphics card with the EGS system. Unfortunately
  1154.      SunWindow doesn't work perfectly!*
  1155.  
  1156.      The EGS system in it's present state isn't 100% systemcompatibel.
  1157.      Take care that also other programs can't work together with EGS,
  1158.      because EGS isn't error free! SunWindow was tested with EGS, but
  1159.      there might be still some problems not known to the author. Most
  1160.      Problems belong to the EGS system and *not* to SunWindow. Please
  1161.      tell the author your problems, so they can be fixed. (Only known
  1162.      problem: Running SunWindow without a valid SUNWINDOW.PREFS file
  1163.      will cause an window opening error; under EGS the system will
  1164.      simply crash your computer!)
  1165.  
  1166.  
  1167. The Distribution Package.
  1168. *************************
  1169.  
  1170.    In this chapter you will find everything about the distribution
  1171. package of SunWindow. Also information is included about
  1172. redistribution, and distribution with other software.
  1173.  
  1174.  
  1175. What's In The Distribution Package
  1176. ==================================
  1177.  
  1178.    In the distribution package of SunWindow V2.0 the following files
  1179. are included. Please check whether you got all this files. Please
  1180. inform the author if you didn't get all of these files. The files are:
  1181.  
  1182.           ENV (dir)
  1183.             SunWindow.prefs
  1184.           OtherIcons (dir)
  1185.             SunWindow.info                   SWPrefs.info
  1186.           English (dir)
  1187.             ReadMeFirst.doc                  ReadMeFirst.doc.info
  1188.             Registration.doc                 Registration.doc.info
  1189.             ReqTools.doc                     ReqTools.doc.info
  1190.             SunWindow.doc                    SunWindow.doc.info
  1191.             SunWindow.dvi                    SunWindow.dvi.info
  1192.             SunWindow.guide                  SunWindow.guide.info
  1193.           Deutsch (dir)
  1194.             ReadMeFirst.dok                  ReadMeFirst.dok.info
  1195.             Registrierung.dok                Registrierung.dok.info
  1196.             ReqTools.dok                     ReqTools.dok.info
  1197.             SunWindow.dok                    SunWindow.dok.info
  1198.             SunWindow.dvi                    SunWindow.dvi.info
  1199.             SunWindow.guide                  SunWindow.guide.info
  1200.           ReqTools (dir)
  1201.                libs13 (dir)
  1202.                  reqtools.library
  1203.                libs20 (dir)
  1204.                  reqtools.library
  1205.                Prefs (dir)
  1206.                  ReqTools                         ReqTools.doc
  1207.                  ReqTools.doc.info                ReqTools.info
  1208.                Install (dir)
  1209.                     Workbench_2.1+ (dir)
  1210.                       Install ReqTools
  1211.                  Install ReqTools                 Installer.README
  1212.                  Installer.README.info            Install_1.3
  1213.                  Workbench_1.2-1.3                Workbench_1.2-1.3.info
  1214.                  Workbench_2.0.info               Workbench_2.1+.info
  1215.             Install.info                     Prefs.info
  1216.        Deutsch.info                     English.info
  1217.        LISTING                          OtherIcons.info
  1218.        ReqTools.info                    SunWindow
  1219.        SunWindow.info                   SunWindow.small
  1220.        SunWindow.small.info             SWPrefs
  1221.        SWPrefs.info
  1222.  
  1223.    The special file `LISTING' contains the dumped directory with file
  1224. sizes, etc. `SunWindow.small' is a short version of SunWindow, without
  1225. error messages and default settings!
  1226.  
  1227.  
  1228. The History Of SunWindow V2.0
  1229. =============================
  1230.  
  1231.    Actually there is no history for SunWindow V2.0. This is the first
  1232. release.
  1233.  
  1234.    But for those who updated from SunWindow V1.16 or higher, here the
  1235. major changes to SunWindow V2.0:
  1236.  
  1237.    * Preference program to control all the features, instead of a menu.
  1238.  
  1239.    * Hotkeys added for window and screen control.
  1240.  
  1241.    * Hotkeys added to remember positions and quickly jump back to them.
  1242.  
  1243.    * SunMouse feature added.
  1244.  
  1245.    * Thumbnail display enhanced, to display window titles as well.
  1246.  
  1247.    * Greater control over the thumbnail display with dragbar, and
  1248.      closegadget.
  1249.  
  1250.    * Automatic sizing of the thumbnail display, to show the screen with
  1251.      the right proportions.
  1252.  
  1253.    * several internal routines completely rewritten.
  1254.  
  1255.  
  1256. The Distribution Of SunWindow
  1257. =============================
  1258.  
  1259.    SunWindow may be distributed with other software under the following
  1260. circumstances:
  1261.  
  1262.    * the copyright belongs to me.
  1263.  
  1264.    * the documentation must not be changed.
  1265.  
  1266.    * I get a fully functional version of the software, if needed with
  1267.      registration.
  1268.  
  1269.    * the distribution package of SunWindow is not changed.
  1270.  
  1271.    * additional for commercial software, including SHAREWARE:
  1272.               
  1273.  
  1274.         - the producer has to register.     
  1275.  
  1276.         - you have asked me for permission and got a licence, which is
  1277.           included in your Software package
  1278.  
  1279.    With this writing, Fred Fish and Martin Schulze get the written
  1280. permission, to include SunWindow in their PD-series (AmigaLibDisk and
  1281. SaarAG-PD)
  1282.  
  1283.  
  1284. Warranty
  1285. ========
  1286.  
  1287.    With the use of this software, you accept the following disclaimer:
  1288.  
  1289.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  1290. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  1291. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  1292. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  1293. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  1294. PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  1295. PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  1296. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  1297.  
  1298.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  1299. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  1300. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  1301. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  1302. USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  1303. OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  1304. THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1305. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  1306. POSSIBILITY OF SUCH DAMAGES.
  1307.  
  1308.  
  1309. (c) 1993, Bernhard Scholz
  1310.