<type>documentation</type>
<domain>intro</domain>
<id>migrating</id>
<title>Migrating From Older Versions</title>
<date>$Date: 2006-05-26 18:09:56 -0400 (Fri, 26 May 2006) $</date>
<version>$Revision: 13129 $</version>
<product>per+</product>

Moving to Wing 7 from earlier versions should be easy.  The
first time you start Wing 7, it will automatically convert your 
preferences from any older version of Wing and place them into 
your `Settings Directory`__.

__ ref:install/user-settings-dir

Wing 7 can be installed and used side by side with older major releases
(Wing 6 and earlier) and operates completely independently.  Projects from earlier
versions of Wing will be converted and opened as untitled, and 
should be saved to a new file name since older versions of Wing
cannot open Wing 7 projects.

Upgrading Your License
----------------------

Valid annual licenses for Wing Pro, and any perpetual license covered by Support+Upgrades
can upgrade to Wing 7 for free.

Other licenses must be upgraded before they can be activated for Wing Pro 7.
This can be done in the `online store`__.

__ https://wingware.com/store/upgrade

Compatibility Changes in Wing 7
-------------------------------

Wing 7 makes some incompatible changes, including changes in supported Python
versions, functional changes, and changes to the API and command set.

Changes in Supported Python Versions
....................................

* Dropped support for Python 2.5 and 3.2
* Dropped support for 32-bit Python on OS X

Important Functional Changes
............................

* Automatically restart the Python Shell by default when changing projects;
  disable this by unchecking Auto-restart when Switch Projects in the Python
  Shell's Options menu
* Change default drag and drop action within the Project tool to move files
  (copying now requires pressing a modifier key)
* Change default for maximum number of non-sticky editors to keep open to 5
* Renamed the Debug Probe to Debug Console
* Evaluate in Python Shell and Debug Console will use the current line when
  there is no selection even if the ``Evaluate Only Whole Lines`` option in
  the ``Options`` menu is unchecked
* Debugger shows unicode characters in Stack Data instead of code points
  under Python 3
* Wing now sets sys.argv in the Python Shell when Evaluate File in Python Shell
  is used.  The value matches the arguments used when debugging the selected
  file and persists until another file is evaluated.
* Wing no longer reloads a file when a disk file is removed while it is open
  in the editor.  Instead, the editor is marked as changed with its current 
  contents.

Changes in Scripting API and Command Set
........................................

* Rename CAPIProject.Get/SetMainDebugFile to Get/SetMainEntryPoint
* Rename command set-current-as-main-debug-file to set-current-as-main-entry-point
* Rename command set-selected-as-main-debug-file to set-selected-as-main-entry-point
* Rename command clear-project-main-debug-file to clear-project-main-entry-point
* Deprecate API and commands affected by the above changes
* Change the ``bookmarks-remove-all`` command to confirm the removal by default
* ``GetStackFrame`` and ``SetStackFrame`` API calls are deprecated; use ``GetStackIndex`` 
  and ``SetStackIndex`` instead
* Changed command names: ``hide-detail`` is now ``hide-debug-value-detail`` and
  ``show-detail`` has been replaced with ``show-debug-value-as-array`` and
  ``show-debug-value-as-text``
* bin/wingapi.py has been moved to src/wingapi.py
* bin/wingdb.py, src/wing.py, and remoteagent.py have been moved to bootstrap
* Dropped the 'sheet' parameter to CAPIApplication.ShowMessageDialog in
  the scripting API

Other Minor Changes
...................

* Disable the old PyLint integration since the Code Warnings tool offers a better 
  option for invoking pylint and indicating its warnings inline in editors
* OS X application name for Wing Pro is now Wing Pro and not WingIDE
* Exceptions in the Debugger > Exceptions > Never Report list are also ignored when
  they occur in code run in the Python Shell and Debug Probe
* Don't display extension module scraping results in the status area
* Remove old and undocumented option to use temp files when running tests
* Increase default for Source Analysis > Max Cache Size preference to 2GB
* Trial license numbers are computed differently
* Increased the default for the Debugger > Line Threshold preference to 95
  to more often include useful data
* Moved size threshold preferences to the new Debugger > Data Display page
* Moved introspection preferences to the new Debugger > Introspection page
* Don't switch to or from fullscreen mode when starting wing, opening a new
  project or switching perspectives
* Use https (and not http) for all communication with wingware.com for 
  license activation, update checks, and submitting feedback and bug reports
* Set TERM=dumb when Start Terminal is used
