== SkyGuide version 2.10.002 release notes (27-Feb-03) ==

SkyGuide 2.10.002 is a full/new release of SkyGuide.
New features/fixes over the SkyGuide 2.10.001 patch are
described below.

================ New features/fixes in SkyGuide 2.10.002 ======================

-------------- Changes to behavior with ASCOM client software -----------------

- Most ASCOM Client software (e.g. planetarium packages, observing planners,
  etc.) "open" the ASCOM connection with a telescope Server (e.g. SkyGuide)
  once at the start of a session and keep it open.  However, some ASCOM Client
  software (notably DeepSky2002/2003) will open and close the ASCOM connection
  each time they submit an ASCOM command.  To work properly in remote control
  applications, SkyGuide will attempt to connect to SkyWalker (i.e. attempt
  to enter Land mode) when the ASCOM connection is opened and SkyGuide will
  return to StartUp mode when the ASCOM connection is closed.  This lead to
  a problem with some ASCOM Clients, such as DeepSky200*, where SkyGuide would
  return to StartUp mode after every command from the Client.

  For remote control applications we must maintain the default behavior that
  SkyGuide returns to StartUp mode when the ASCOM connection is closed however
  we have added a command-line switch to SkyGuide that allows for use with
  ASCOM Clients such as DeepSky200* which connect/disconnect with every
  command.

  To use this switch, and make SkyGuide work with DeepSky200*, provide SkyGuide
  2.10.002 with the -IgnoreASCOM_Disconnect command line option.  Command-line
  options are specified by right-clicking the SkyGuide icon and selecting
  properties and then in the "Target" box enter the command-line option at the
  end of all text (outside the quotation marks, if the quotation marks exist).
  Do not disrupt existing text in the "Target" box.  Be sure to include a space
  between the command line option and any existing text.

- Some ASCOM Client software (notably ACP from DC-3 Dreams) will attempt to
  "unpark" the telescope upon "opening" the ASCOM connection with a telescope
  Server (e.g. SkyGuide).  If SkyGuide is not yet aligned, but only in Land
  mode, then the ASCOM Client's unpark command will nicely cause SkyGuide to
  align-from-last.  However, if SkyGuide 2.10.001 (or earlier) is already
  aligned then an error is raised "Alignment from parked position not currently
  allowed".  In SkyGuide 2.10.002, no error is raised.  If SkyGuide 2.10.002 is
  already aligned when it receives the "unpark" ASCOM command it quietly
  ignores it.

------------------- Changes to SkyGuide's user interface ----------------------

- The state of the "OnTop" button (which controls weather SkyGuide is the top-
  most window on the Windows desktop) is now saved upon exit and restored the
  next time SkyGuide is run.

- SkyGuide will now prompt you when exiting to verify that you really want to
  exit.  This is in response to suggestions from users.  Note: if you do
  inadvertently exit SkyGuide you can start-up again and do an align-from-last
  and should not require an alignment from stars.

  This prompt-on-exit feature is disabled when using SkyGuide's WARP interface
  IF the TCS_SetInteractiveDialog( W_OFF ) function is called in WARP or when
  using SkyGuide's ASCOM interface IF the CommandBool() method is called with
  a parameter of "ID0".  This is in support of remote operation.  More details
  can be found on these two commands from our support page.

- Bug fix: Previous versions of SkyGuide would display a blank field for
  TimeInSustain on the console IF the amount of time in Sustain mode exceeded
  999 seconds.  SkyGuide 2.10.002 can now display up to 999,999 seconds of
  time in Sustain mode.

------------------------------- Misc changes ----------------------------------

- SkyGuide now has 5 sites available from the Settings/StartUp/Sites Display
  Page.

- The Alt/Az GoTo feature (available from WARP) now allows targets with a
  negative Altitude (down to -30 degrees).

- Bug fix: occasionally SkyGuide would issue an InternalError with text such
  as "Internal Error: Error: negative x in quad_interp()" or "Internal Error:
  IEK58_A".  This would generally only happen on setups that had been slewed
  through may rotations of RA/Az in SkyGuide's Land mode and SkyGuide would
  "overflow" its position counter that is used to keep track of "last" position
  for the align-from-last feature.  The work-around was to delete the last.ini
  file.

  This error has been fixed and now if the telescope is moved through more
  than 2 full revolutions in RA/Az in Land-mode the alert "Alert: Mount has
  "wrapped" in Scope Azimuth: align-from-last position lost" occurs instead
  of the error.

CLH 27-Feb-2003