		    NeoDesk 3.02 to 3.03 Patch Program

	  This program will upgrade NeoDesk version 3.02 to
	  version 3.03.  It will ONLY upgrade version 3.02.

	  If you have version 3.01, you will need to run a
	  separate upgrade program first, to upgrade you to
	  version 3.02.

  This program is copyright  1993 by Gribnif Software.  All rights are
  reserved.  This program may be freely distributed to all legitimate
  registered users of NeoDesk 3 - The Ultimate Desktop.

  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


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

  1.  A non-modified, registered, NeoDesk 3 Master Disk, version 3.02, and
      a version 3.02 Extras Disk.  This version of the program works with
      the USA release only.  Owners of foreign versions should contact
      their respective distributor.
      
  2.  A hard disk or a blank, double-sided, formatted floppy disk (to
      place the PATCH303.PRG and the DATA files on).


How to upgrade your NeoDesk version 3.02 to version 3.03
=========================================================

  1.  Make sure you have made a backup copy of both NeoDesk 3 disks.

      Note: If you have modified or created any new icons using the Icon
	    Editor, you should save a ".NIC" file containing those icons.
	    This upgrade will replace your resource files, where NeoDesk
	    stores its icons.  This means that you will lose any new icons
	    you have (unless you save them to a ".NIC" file which you can
	    then load into the new version).

  2.  Place the PATCH303.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 eight "DATA" files to the same directory.

  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.  DO NOT RUN THE PATCH PROGRAM FROM NEODESK! Run PATCH303.PRG from the
      built-in desktop and follow the prompts.

  5.  Once you have finished upgrading your master disk to version 3.03,
      make a backup copy of this newer version.

  ** VERY IMPORTANT STEP, READ CAREFULLY **

  6.  To install the newer version on your system, you MUST replace ALL the
      NeoDesk 3.02 files in your system with the 3.03 version files.  The
      patch program is automatically set up to do just this.  If, however,
      you do not choose to use the patch program to copy the files, you
      MUST manually replace all copies of these files:
      
      Master Disk:   Contents of \NEODESK3 folder
      Extras Disk:   \ACC\NEOCNTRL.ACC
		     \ACC\NEOCNTRL.RSC
		     \ACC\NEOQ_C.RSC
		     \ACC\NEOQ_M.RSC
		     \INF_CONV\INF_CONV.NPG
		     \INF_CONV\INF_CONV.RSC
		     \FONTS\FONTCONV.NPG
		     \FONTS\FONTCONV.RSC
		     \FONTS\FONTLOAD.PRG
		     The file \JARXXX\JARXXX.PRG needs to run before
		     NEOLOAD.PRG, preferably in the AUTO folder. See the
		     file JARXXX.DOC on the upgraded Extras Disk.

      Mixing 3.02 versions of NeoDesk 3 files with 3.03 versions is VERY
      likely to lead to problems.

 *** ULTRA IMPORTANT **
 *
 *    Don't forget to replace all the copies of NEOLOAD.PRG, including the
 *    one in the AUTO folder of your boot disk, if you don't let the patch
 *    program do this automatically for you.
 **********************

  7.  If you use XBoot or another AUTO folder file manager, please see the
      section "An Important Note", below.

  8.  If you have saved macro (.MAC) files, the enclosed MAC_CONV.PRG must
      be used to convert them to the 3.03 format.

  9.  If you own the Neodesk Accessories Disk, please run the enclosed
      PATCH_CN.PRG to update Call NeoDesk to the newer 1.01 version.

  10. You can now run NeoDesk 3.03.  It is strongly suggested that you
      re-boot the computer to do this, otherwise you may end up mixing
      files from 3.03 with older 3.02 programs which are still resident in
      memory. When NeoDesk first loads, you will most likely get a message
      saying that your .INF file is not the correct version. This is to be
      expected, since the format has changed slightly. See Step 11.
  
  11. You can now run the icon editor to re-load your old icons from the
      NIC file (from Step 1).

  12. You can also use the INF_CONV.NPG program to convert your old NeoDesk
      information (.INF) files.
      

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

  If your NeoDesk 3 disks have 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 both
  disks so that we can upgrade them.

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

  1.  Send your original, registered, NeoDesk 3.02 Masters AND Extras
      Disks.
  2.  If you did not purchase the Patch Disk directly from us, please
      enclose a U.S. check for $5 + $2 shipping & handling ($7 total).
  3.  Enclose a note with your name, address, and daytime phone number.

  In return you will receive the upgraded 3.03 Master and Extras Disks.


An Important Note (Especially for XBoot Users!)
===============================================

  NeoDesk 3.03 includes a new program, called JARxxx. This program is used
  by NeoDesk for managing the system's Cookie Jar.  In order for NeoDesk to
  run, this file must be run beforehand.  The easiest way to make sure that
  it runs first is to copy it into the first slot in the AUTO folder.

  If you use XBoot or another AUTO folder management program, please be
  sure to set JARxxx so that it will be active when the computer reboots.
  Otherwise, NeoDesk will not run.

  For more information about JARxxx, please refer to the file JARXXX.DOC,
  which is on the newly upgraded Extras Disk.


What's New
==========

o When a folder is opened, the position of the window scroll bars are
  saved.  When the folder is closed, the old scroll position is restored.

o A "Delete Item" menu option has been added. This makes it easier to
  delete things when the trashcan is not visible. Please note that this is
  a permanent deletion; the Recoverable Trashcan is not used.

o Show Information works for multiple items on the desktop or in windows.
  If no item is selected, the topmost window's info is shown.

o Pressing Backspace will do the same thing as the "send to back" button on
  the topmost window.

o High and Extended density floppy formats have been added. In order to use
  High Density, you must have a 1.44Mb drive and the proper version of TOS.

o The "Fast-11" disk format has been added. This is optimal for 9-sector
  disks. Twister is still best for 10-sector ones.

o The "Set Preferences" dialog has been changed cosmetically. Also, a
  "More" dialog has been added:

  o If an error occurs while files are being copied, then any files which
    are in memory but have not been written to the destination disk can be
    automatically moved to the File Clipboard. The "More" dialog contains
    an option which specifies whether to Ask before doing this, to Always
    do this, or Never to do it at all.
    
    There are times when this will not be possible, though. If there is not
    enough free memory in the system, then the files will not be stored.
    Also, any file which is only partially in memory will not be stored.
  
  o The Format for Diskcopy is what is used when copying from one floppy to
    another, with the "Format" option.

  o If "Check for Executable Bootsector" is off, no virus check is
    performed. This makes updating drives significantly faster on machines
    that use AHDI with a Syquest drive.

  o If "Check for Bad Filenames" is off, no check is done to see if you
    have entered bad characters for the name of a file. It also converts
    the names of files to all uppercase before matching icons.	Having this
    option off is slightly slower at re-reading disk drives for this
    reason. If you use DMJ's ReNameIt program, you must turn this option
    off.

o The INF files option in Set Preferences has changed. It now controls
  whether or not VDI graphics are used for a particular resolution. If the
  button under "VDI" is blackened, then when NeoDesk first runs, it will
  load a different set of graphics routines from the ones it normally uses.
  The VDI graphics mode must be used with extended graphics hardware (like
  the Matrix and Crazy Dots video boards), and also the True Color modes of
  a Falcon. Also, if you use a screen accelerator program like Warp 9 from
  Codehead Tech., you will see a greater speed increase when NeoDesk is in
  VDI mode.
  
  In this dialog, you can also enter the name of a default INF file to use
  if no other INF file is appropriate for a previously undefined
  resolution.
  
  If you have a NEO_INF.DAT file left over from version 3.02, then the
  first time you look at this dialog and quit with "Ok", NeoDesk will ask
  to save the NEO_INF.DAT file. This is because the format of this file has
  changed slightly for version 3.03. The file will be updated automatically
  to the new format.

o NeoDesk can now control the caches of a TT, Mega STe, or AdSpeed, as well
  as the Blitter. If you load a NeoDesk 3.02 INF file (with INF_CONV), all
  of the new caches will default to On. These chips can be configured with
  the new version of NEOCNTRL. Any changes made in NEOCNTRL are saved when
  you Save Configuration.
  
o In addition to the hardware flags described above, each Installed
  Application can also be set to turn the corner clock off. Note that if
  the corner clock in NEOCNTRL is already off (or NEOCNTRL is not loaded),
  changing this flag will have no effect. For that matter, setting any of
  the CPU flags for an application when the machine you are using does not
  have that capability (like turning the Blitter On when all you have is an
  original 520 ST) will have no effect, either.

o NEOCNTRL has the ability to change the sound controls on a TT or STe.
  Please note there is no way for the control panel to know what the
  current settings of these controls are. This means that if you use
  Atari's XCONTROL to change the sound controls, then NEOCNTRL will reset
  them to whatever values it last had when you open the sounds dialog a
  second time.

o When the mouse is over an icon in NEOCNTRL, a helpful string of text is
  displayed in the name bar of the window.

o The corner clock is now always turned off when viewing a picture or a
  text file.

o If the Control key is held while double-clicking on a file on the
  desktop, a window will be opened to the path of the icon.

o You can now specify a number of copies to make when copying from one
  floppy to another. Note that if more than one swap is necessary, the
  source disk will be re-read each time; otherwise it will just be read the
  very first time. An alert will prompt you after each disk is copied.
  This alert even occurs if there is an error during copying, though if the
  error happened during reading the source disk, the entire source will be
  read again.

o Print Directory's output can be sent to a disk file.

o All window colors are taken from the system's window attributes on a
  machine with AES versions greater than 2.0. This is only read when
  NeoDesk first runs, so changing them with the control panel will not
  affect NeoDesk unless you quit first (or run a program with Unload for
  Execute on). Also, if you do not have version 4.0 of the AES (MultiTOS),
  you must run NEOLOAD in the AUTO folder in order for the colors to be
  set properly. This is due to a deficiency in version 2.x/3.x of the AES.

o Macros can now record opening a NeoDesk desk accessory. This was just an
  oversight, since they always could record passing files to one.

o If a macro is being recorded while a new MAC file is loaded, macro
  recording will not stop. Instead, you will be presented with an
  informative alert.  At this point, you should end macro recording, since
  anything coming after this will be ignored when the macro is played back,
  anyway. This change makes it possible for a macro to load a new macro
  file.

o If the right Shift key is held, icons will never become de-selected.
  This is handy for repeating an operation without having to select the
  icons again. Note that if the operation you are performing (copy or
  move) causes the drive window containing selected icons to be updated,
  the icons will become de-selected.

o There is now a hack to make it work with MultiGEM, but it still isn't
  great, due to limitations in MultiGEM.

o NeoDesk works with MultiTOS now, however it really does not take full
  advantage of its capabilities. Wait for NeoDesk 4...<smile>  See the
  section below for more info.

o File copying speed has been improved.

o If no INF file is loaded and a HD floppy drive is used, the seek rates of
  both floppy drives are set to 6 ms.

o The speed of sorting window contents has been improved.

o When editing a Desktop Note, some helpful text appears in the menu bar to
  remind you of this change in modes.

o If only some of the desktop icons are selected, Snap to Grid will only
  snap those icons.

o A quicker Show Info is available for disk drives. If the left Shift key
  is held, the total number of files will not be checked. This is much
  faster for when you just want to know how much free space there is.

o Files on the desktop can be copied.

o A "No Format" diskcopy will work if the number of sectors per track on
  the destination disk is greater than that on the source disk. This means
  you can copy a 9-sector disk to a disk which was formatted to 10.

o Pictures can be displayed in all (built-in) resolutions on a TT.

o NEOCNTRL can also be run as a program, simply by renaming it to
  NEOCNTRL.PRG. You will not have access to the screen saver or corner
  clock, though.

o If no environment variables are supplied, then the environment which was
  inherited from the program which ran NeoDesk is used when NeoDesk runs a
  program.

o Show Info for files allows you to set the TT-specific and
  MultiTOS-specific flags for an executable file.

o If a dialog would have appeared even partially off the screen (due to
  being loaded with INF_CONV, etc.) it is moved back before being drawn by
  NeoDesk.

o The memory display in About NeoDesk tells how much free ST and TT RAM
  there is (if there is any TT RAM). If there is none, then it tells the
  total amount of ST RAM there is. (There is no way to know how much TT RAM
  there is total, so it can't be displayed.) Also reported is the total
  number of free memory blocks, and the size of the largest block (which is
  what NeoDesk used to report as "free memory").

o The font converter, FONTCONV.NPG, can be used in VDI graphics mode,
  however it is much faster at redrawing the screen when NeoDesk is in its
  normal graphics mode.


Major Fixes
===========

o Copying from a disk icon to a folder icon on the desktop works properly
  under all circumstances.

o A macro to delete all items from a drive now updates any windows open to
  that drive correctly all the time.

o Fixed a bug that prevented it from working with drives > P:. It also now
  works with MiNT's "fake" drives.

o Running without an INF file gives the right colors on a TT. Also, the
  colors are as bright as possible for a TT/STe (0xFFF instead of 0x777).

o Fixed a long standing bug in diskcopy with format, which would sometimes
  cause a crash.

o The colors shown in NEOCNTRL on a TT in TT high or TT medium are ordered
  correctly.

o Show Information, Search, and Print Directory will now properly put up an
  alert when more than 8 folders deep are accessed.

o The medium resolution Show Folder dialog can be dragged.

o The number of folders to be copied in a Clipboard to disk copy operation
  is correct.

o The Floppy Format dialog does not leave buttons selected after changing
  to a new INF file.

o NEWDESK.INF is read on a Mega STe instead of DESKTOP.INF during a
  resolution change.

o Opening a floppy drive for the first time on a TOS 1.0/1.2 machine should
  not go into a loop of several Cancel/Retry alerts if there is no disk.

o A NeoDesk DA which uses the NEO_ACC_EXC message to run a program will no
  longer cause the Parameters dialog to open if Shift and Alt are held.

o Loading a new INF file will work properly if the old config had NeoDesk
  DA's in it. Previously, the new configuration would sometimes cause
  NeoDesk to think that icons on the desktop were NeoDesk DA's when they
  weren't.

o Saving config with a blank name for the file will no longer save to a
  filename like ".INF".

o Systems which allow for more than seven windows are handled properly.

o Opening more than seven windows produces a correct error alert.


Using NeoDesk 3.03 with the NeoDesk CLI
=======================================

  If you intend to use the NeoDesk CLI with NeoDesk 3.03, you must have
  version 2.1 or newer of the CLI, if you intend to use the "VDI" mode in
  NeoDesk 3.03. If you have an older version of the CLI, you must turn VDI
  mode off by changing the black square (so that it becomes white) next to
  the entry for the current screen resolution in the ".INF files..."
  button in "Set Preferences..."

  If you have version 2.1 of the NeoDesk CLI, you should be aware that
  there is one minor bug. When you enter the scrollback buffer and attempt
  to select a block of text using the mouse, the text is not drawn
  correctly. This is just a minor inconvenience, and will be fixed for the
  next version of the CLI. It can also be avoided by turning the VDI
  option off.


Using NeoDesk with MultiTOS
===========================

  To use NeoDesk with MultiTOS, you still need to have things configured
  correctly in your GEM.CNF file. This is because NeoDesk lets the
  operating system decide how to run an application based on the contents
  of the TOSEXT, ACCEXT, and GEMEXT variables in GEM.CNF. See the MultiTOS
  documentation for more information about these variables.
  
  To have desk accessories load automatically whenever you open them from
  NeoDesk, define "ACC" as a new filename extension in "Set Preferences".
  Set just the GEM flag.
  
  NeoDesk can be set as the default "shell" in GEM.CNF.

  If you are using MultiTOS, you should definitely define some program as
  the "Alternate Text File Reader" in "Set Preferences". Otherwise, the
  normal display routines will be used, and full-screen TOS output does not
  get along very well with MultiTOS.
