                  NeoDesk 4 release 002 Patch Program

          This program will upgrade NeoDesk 4 release 001 to
          release 002.  It will ONLY upgrade release 001.

  This program is copyright  1994 by Gribnif Software.  All rights are
  reserved.  It may be distributed free of charge, provided this and all
  other files are included and are not modified.

  Any questions or comments, please contact us at:

      Gribnif Software, P.O. Box 779, Northampton, MA 01061, USA

      Tel: (413) 247-5620, Fax: (413) 247-5622

      GEnie:    GRIBNIF
      Internet: gribnif@genie.geis.com


What is needed to upgrade
=========================

  1.  An unmodified, registered, NeoDesk 4 Master Disk, release 001.  This
      version of the patch program works only with English language
      versions of NeoDesk 4.  Owners of other versions should contact their
      respective distributor.

  2.  A hard disk or a blank, double-sided, formatted floppy disk (to
      place the NEO_002.PRG and the NEO_002.DAT files on).


How to upgrade your NeoDesk 4 release 001 to release 002
========================================================

  1.  Make sure you have made a backup copy of the NeoDesk 4 disk.

  2.  Place the NEO_002.PRG on your hard disk or on the blank floppy disk
      (it may need the extra disk space to write some temporary files).
      Also, copy the NEO_002.DAT file to the same directory. If you
      obtained a patch disk from us with only these files on it, you can
      use the patch disk directly, though if you have a hard drive, copying
      the files there will be quicker in the long run.

  3.  The patch program will run more quickly and with the fewest disk
      swaps if you give it as much free memory as possible. If you have
      less than 500K of free memory, you can disable AUTO folder programs
      and desk accessories to obtain more free memory.

  4.  Once you have finished upgrading your master disk to release 002,
      make a backup copy of this newer version.

  ** VERY IMPORTANT STEP, READ CAREFULLY **

  5.  To install the newer version on your system, you MUST replace ALL the
      release 001 files in your system with the 002 files. To do this you
      can either:

      o Run the INSTALL.PRG on the newly updated disk. In several places,
        you may get messages saying that a file already exists. You should
        tell it to go ahead and overwrite the old file, in every case
-->>    EXCEPT FOR THE FILE NEODESK.NIC. If you tell it to overwrite the
        NEODESK.NIC file, this will permanently delete any custom icons
        you have added to NeoDesk!

      o To install the new version manually, you should replace any
        occurences of these files on your working disk:

          ACC\NEOCNTRL.ACC
              NEOQUEUE.ACC
          INF_LOAD\INF_LOAD.ACC
          NEODESK\ICONEDIT.RSC
                  NEODESK.EXE
                  NEODESK.HLP
                  NEODESK.RSC
                  NEOLOAD.PRG
                  SETTINGS.RSC  (New for release 002)
          TRASHCAN\TRASHCAN.ACC
                   TRASHCAN.RSC
          INSTALL.SCR

        Mixing 001 versions of NeoDesk files with 004 versions is VERY
        likely to lead to problems.

 *** ULTRA IMPORTANT **
 *
 *      If you install NeoDesk 4 002 manually, don't forget to replace all
 *      the copies of NEOLOAD.PRG, including the one in the AUTO folder of
 *      your boot disk.
 *
 **********************

  6.  You can now run NeoDesk 4, 002. You will have to reboot in order to
      do this.
  
  Please note that the resource files for NEOQUEUE, NEOCNTRL, and INF_CONV
  have not changed. This means that if you look at the copyright
  information dialogs for any of these programs, they will still mention
  NeoDesk 4.00, even though the programs themselves have changed. The best
  way to tell what version of one of these programs is, is by looking at
  the file date: the release 002 files will always have the date that you
  performed the patch.


If you get an error message
===========================

  If your NeoDesk 4 disk has been modified in any way, the patch program
  may not be able to perform the upgrade.  You will get an error message
  indicating that this has happened.  In this case, you should mail us the
  disk so that we can upgrade it.

  To have your disk upgraded by us, you need to:

  1.  Send your original, registered, NeoDesk 4 disk.
  2.  Please enclose a U.S. check for $5 + $2 shipping & handling ($7
      total). If this patch program was already purchased directly from
      Gribnif Software for $5, then you do not need to send any payment,
      just the NeoDesk disk.
  3.  Enclose a note with your name, address, and daytime phone number.

  In return you will receive an upgraded 002 disk.


Changes in NeoDesk 002
----------------------

  New in NeoDesk:
    Two new dialogs have been added. These dialogs are only available when
    Geneva is not present. See the "Addenda & Errata" section of this file
    for more info:
    o The "Windows" dialog has a new button named "Gadgets" which allows
      you to access a sub-dialog to change the colors and keyboard
      equivalents of the gadgets.
    o The "Dialogs" dialog has a sub-dialog which allows you to change the
      colors, fill patterns, and other attributes of dialog buttons.

  New in the icon editor:
    o There are now "cycle" buttons next to the View and Draw popups.
    o The "Clear" option under the "Mask" menu has been removed. Instead,
      there are now separate options to "Clear Data", "Clear Mask", and
      "Clear Both".
    o There are options in the "Image" menu to do horizontal and vertical
      flips.
    o You can now replace all occurrences of one color with another. Start
      by selecting the new color in the grid to the right, then click and
      drag this color to the color you want to replace.

Problems Fixed
--------------

In NeoDesk:

  If Geneva is not present:
    o The cycle windows gadget works.
    o NeoDesk can now be used as a desk accessory.
    o Dragging desktop icons will not sometimes lose the drag box.

  If neither Geneva nor MultiTOS is present, and you have a computer
    other than a Falcon, then changing resolution by using the Video Mode
    dialog works properly.

  If Geneva is present, you can now run a program in single-tasking mode
    with the "Unload for execute" option turned on.

  Copying a disk drive to the clipboard starts the operation right away.

  Searching the contents of a group is now correctly flagged as an invalid
    operation.

  Editing the environmental variables in 40-column resolutions now works
    right. The dialog also undraws properly when closed.

  Using non-Bitstream fonts in NeoDesk 4 when Speedo GDOS 5 is active works
    much better now, however early versions of Speedo 5 produce dots across
    the screen occasionally.

  The Sort order gets saved in INF files.

  Saving an INF file with a group open works properly when the INF file is
    later loaded.

  When an INF file for a resolution which permits windows which are larger
    than the current resolution is loaded, the windows are limited to the
    current maximum size.

  Pressing Undo in the Macros dialog will no longer select the "Remove"
    button.

  The program loads more quickly when run from a floppy disk.

  Showing an ST High resolution picture on a normal ST with a color monitor
    now works.

  The NPI dialog has been expanded vertically so that the Parameters
    section will look right in ST Medium/Low resolution.

  Dialogs with wrap-around editable fields now always draw the cursor
    correctly.

  It is now possible to choose from all of the GDOS fonts you have loaded,
    not just the first 16 (memory permitting.) Also, the full 32 characters
    of the font names are visable.

  Macros to run programs and to close all windows work now, without
    producing an alert afterward.

  Editing the 20-character name of an item in a group no longer interferes
    with the icon it has in the window. Also, NPI files in a group always
    get the right icon now.

  Using Show Information on an open folder will no longer crash if you
    select the "Ok!" button.

  Reading disk directories has been sped up slightly.

  When a file name conflict occurs during a copy/move, the items' dates and
    sizes are now visible when using ST Medium/Low resolution.

  The width of the custom window gadgets for x2, Select All, etc. will
    always be wide enough for the icons inside the gadgets, even if the
    rest of the window gadgets are not.

  Avoided a bug in the TOS 4.04 Blitmode() call which would cause the
    system color palette to get reset to its defaults whenever an INF file
    was loaded.

  Fixed NeoDesk so that deletions using the recoverable trashcan will
    update NeoDesk's windows properly when done and not sometimes crash
    instead.

  Made a change in memory allocation that should lead to less
    fragmentation.

  If NEODESK.EXE is not present when any module is trying to load, you will
    get an error message. Previously, this would only happen when NeoDesk
    first ran.


In the NeoDesk Icon Editor:

  Copying a 2-color icon image to 4- or 16-colors in the icon editor by
    using the clipboard works properly. Similarly, creating a 4- or
    16-color icon from a 2-color one (when there had previously not been
    one) works.

  Using Show Information on an icon in the icon editor is now correctly
    flagged as an invalid operation.

  Quitting the icon editor will no longer cause icons on the desktop to
    disappear.

  Deleting all or some of the NeoDesk Icons will no longer potentially
    cause a crash when you open a new window.

  The editor window will be the correct size when used in TT Low or Falcon
    40-column true color modes.


In INF_LOAD:

  The INF Loader now converts icons from NeoDesk 3 INF files properly.


In the Recoverable Trashcan:

  The TRASHCAN no longer gives an "Illegal AES function" alert when used on a
    Falcon.
    

In NEOCNTRL:

  NEOCNTRL and NEOQUEUE will no longer give an "Illegal AES Function" alert
    when run on a Falcon with TOS <= 4.04.
  The corner clock now works in true color modes on the Falcon.
  The control panel no longer thinks the Falcon has a Blitter chip. Chalk
    up another bug in TOS 4.04.
  NEOCNTRL will now let you change the state of the Blitter and T25 if
    you have this exact combination of enhancements available.
  Changing the date when in yy/mm/dd format works.


Addenda & Errata to the Manual
------------------------------

  o Page 5 of the manual incorrectly refers to REGISTER.PRG. You simply
    need to run INSTALL.PRG and it will ask for registration information.

  o Page 7, Section 2.5.2., the first example should read:

    setenv PATH=C:\NEODESK4

    This can be combined with other paths that may already be in the line,
    such as:

    setenv PATH=.,C:\UTILS,C:\NEODESK4

  o Page 9, Section 2.8, the example is incorrect. It should read:
  
    setenv NEOPATH=<path where NEODESK.EXE is stored>
                                       ^^^
    Also, it should be added that if you are going to use NeoDesk 4 as a
    desk accessory, you must also run NEOLOAD.PRG in the AUTO folder of
    your boot disk. If you have TOS 1.4 or newer, then you must also turn
    the "Fastload" attribute of NEODESK.ACC off. This can be done by using
    NeoDesk's "Show Information" dialog.

  o Page 79, Section 4.1.3.3, second paragraph, change to:
  
    Clicking on the font button will display the names of the available
    fonts...
    
    (NeoDesk 002 will read as many fonts as you have configured to load,
    memory permitting)

  o Page 81, Section 4.1.3.4, second paragraph, change to:
  
    from a pop-up list of the available system, GDOS, or Speedo GDOS
    fonts.

    Add to end of section:

    If you are not using Geneva, then the "Gadgets" button will allow you
    to modify the colors and keyboard equivalents for window gadgets.

  o Page 81, Add Section 4.1.3.4.1:
    
    Window colors and keyboard equivs. 
    ---------------------------------- 
 
    This dialog gives you control over the colors and fill patterns of the
    gadgets in NeoDesk's windows. It also allows you to change the keyboard
    keys that can be used to achieve common window operations.
 
    If you use Atari's XCONTROL panel and have a CPX module to set the
    window colors, then NeoDesk can read these settings. Choose the "Use
    system window colors" button if you would prefer to control the colors
    of NeoDesk's windows with the CPX. In this mode, only the 3D attribute
    of the gadgets can be changed.
 
    By clicking on the "Topped" button, you can toggle the display between
    editing the attributes of topped windows and non-topped windows.
 
    In order to be compatible with the method used by Atari to control
    window colors, some of the window gadgets NeoDesk uses inherit the same
    colors as other gadgets. For instance, if you change the color of the
    Full box, the color of the Cycle gadget will also change.
 
    To copy the attributes of one gadget to another, click and hold the
    left mouse button on the currently selected gadget. An outline box will
    appear, which can be dragged to the destination gadget.
 
    The keyboard equivalent for the currently selected window gadget can
    also be changed. If one is available, you will see the current setting
    in the bottom of this dialog. Note that selecting the area above the
    vertical scroll drag box ("page up") allows you to change a different
    keyboard equivalent than selecting the area below that gadget ("page
    down").
   
    The "Read" button will allow you to press the keyboard key to assign
    to the currently selected window function. The "Clear" button will
    erase the current key. The dialog will show the string "???" to
    indicate that the key is undefined.
 
    You should remember to Save Configuration after making changes to this
    dialog so that your changes become permanent.

  o Page 82, Section 4.1.3.5, add:

    If you are not using Geneva, then the "Button Colors" button will allow
    you to modify the colors of the buttons used in NeoDesk's dialogs.  If
    you have Geneva, then you can use the Task Manager's "Dialogs" option
    to change these settings.

  o Page 83, Add Section 4.1.3.5.1:

    Dialog Colors 
    ------------- 
 
    This dialog allows you to set the way in which various components of
    other dialogs are displayed.
 
    NeoDesk allows you to have separate appearances for several types of
    objects contained within dialogs. The "Type" box contains a list of
    the four different types of objects that can be assigned these special
    attributes. The "Sample" shows you one object of each of these types,
    so that you can gauge how they will look in actual dialogs.
 
    The "Attributes" section is where you can specify how the currently
    selected object should look:
 
    o Outline: produces a line around the outside of the object. 
    o Shadow:  a shadow on the lower-right edge of the object. 
    o 3D: a three-dimensional effect. The text of the object will "move" 
      when it is selected. 
    o Round: the corners of the outer edge are rounded, instead of square. 
      Note that if Outline is also used, the thick part of the object's 
      border is moved to the outside. 
    o Opaque: affects how text is drawn. When this flag is set, the area 
      around the actual dots that make up a character of text are left 
      white. Otherwise, the fill pattern of the object will show through. 
    o Pattern: this is a pop-up menu which lets you choose from any of 
      the eight pre-defined fill patterns. You can also move from one to 
      the next by clicking on the left or right arrow buttons. 
    o Fill:  this is a pop-up menu with all of the colors available in the 
      resolution you are currently using. (Some colors will be black if the 
      current screen resolution does not support at least 16 colors at 
      once.) You can use this option to define what color is used when 
      drawing the fill pattern of the currently selected object. 
    o Text: the color of any text appearing in the object. 
    o Border: the color of any border surrounding the object. 

    Note that some attributes of some types of objects are overridden by
    NeoDesk itself, and therefore changing them will have no effect.

    You should remember to Save Configuration after making changes to this
    dialog so that your changes become permanent.

  o Page 95, Section 4.1.4.3, add:
  
    The popup menu in the NPI dialog moves you between several groups of 
    settings which will affect how the program gets run. All of these 
    settings will override the way in which NeoDesk would otherwise run the 
    program: 
 
    o The Main section controls how the program is executed, in a manner 
      similar to Install Application. 
    o The Parameters section can be used to alter the way file names get 
      passed to the program. Any text entered here is always sent, as-is. You 
      can also use a $ followed by a number to indicate a particular passed 
      filename, or $$ to indicate all passed file names. For instance, you 
      could use the string "copy $1 $2" to indicate to a CLI that the first 
      file should be copied to the second one. The "Extended argument 
      passing" option allows more parameters to be passed than the standard 
      limit of 126 characters. A program must specifically support this 
      method. 
    o The Miscellaneous section gives you control over the hardware options 
      that are enabled when the program gets run. Some programs do not work 
      correctly when the CPU is at a certain rate or when the NeoDesk Control 
      Panel's corner clock is on, so this allows these things to be changed. 
      Not all of these options have an effect on all computers. 
    o The Environment section allows you to specify a group of up to ten 
      environmental variables specifically for this instance of the 
      program.
      
    Note that if you use NeoDesk 4 with a multitasking environment, like
    Geneva, then the Miscellaneous settings will not seem to work correctly.
    This is because the settings are changed back to their normal state as
    soon as NeoDesk regains control which, in a multitasking system, is
    immediate. With Geneva, you can solve this by setting the program itself
    to be single-tasking with Geneva's Task Manager.

  o Page 121, Section 5.4.3, add:
  
    The button to the right of the View button will cycle between the
    available choices.
    
  o Page 123, Section 5.4.3.1, add:
  
    The button to the right of the Draw button will cycle between the
    available choices.

  o Page 124, Add Section 5.4.3.3. Recoloring an image

    Sometimes, it is necessary to change all occurrences of one color in
    an icon to another color alltogether. To aid in this, the icon editor
    has a special copying feature.
    
    Start by choosing the new color from the color palette. Now, click
    and hold the left mouse button. Drag the resulting outline to the
    color palette entry you want to replace with this new color. If you
    let go of the left mouse button while the mouse pointer is outside of
    the color palette box, no change will occur.

  o Page 124, Section 5.4.4.1, replace the "Clear" item with:
  
    Clear Data - Clear just the data portion of the icon 
    Clear Mask - Clear just the mask portion
    Clear Both - Clear both the data and the mask
    
    Under Rotate, add:
    
    H-Flip - Flip the image horizontally. In "View" modes other than "Both",
      only the current portion of the image is affected.
    V-Flip - Flip the image vertically

  o Page 125, Section 5.4.4.2, remove the "Clear" item.

  o Page 150, Section 7.1, add:
  
    [CONTROL][ALTERNATE][DELETE]    Perform a warm restart of the computer
    [CONTROL][ALTERNATE][UNDO]      Perform a cold restart of the computer

  o If you are going to use Speedo GDOS, you need to have version 4.11 or
    newer in order to use the scalable fonts allowed in the Windows and
    Desktop Notes dialogs. Version 4.1 will not work properly.
    
  o If you own Geneva, you must update to release 003. If you still have an
    older version, you can update using a patch program which is available
    on GEnie, Compuserve, and other BBS'es. You can also get the patch
    program from us for a minimal charge.

  o If you use Warp 9 3.81 or older and Geneva together, you should turn
    on Warp 9's "Zoom boxes" option. Otherwise, dialogs in NeoDesk will not
    undraw correctly. The same effect can safely be achieved by turning the
    "Grow/shrink boxes" option off in the Task Manager's "Miscellaneous"
    dialog.

  o In order to change the colors of NeoDesk's window gadgets, you should
    use WCOLORS.CPX or an equivalent replacement. There are two important
    things to note, however:

    1. If you are not using MultiTOS or Geneva, then you must have a copy
       of NEOLOAD.PRG in your AUTO folder in order for the colors to be
       read properly. This is because of a deficiency in TOS versions prior
       to 4.0.
    2. If you are not using Geneva, and you do not want to use WCOLORS.CPX,
       then you should use the "Window colors" dialog. This can be accessed
       by choosing the "Gadgets" button in the "Window preferences" dialog.
       The "Use system window colors" button controls whether or not the
       settings from WCOLORS.CPX are read by NeoDesk. If this button is
       selected, then changing the settings of the window colors in
       WCOLORS.CPX will only take effect when NeoDesk loads an INF file.
