Previous IDL Reference Guide: Procedures and Functions Next

PREF_MIGRATE

The PREF_MIGRATE procedure is used to import IDL user preferences from other versions of IDL for use by the currently running version. Under Microsoft Windows, it is also used to import IDLDE macros.

IDL user preferences are maintained on a per-release basis, meaning that a different user preference file exists for each version of IDL you use on your system. When you first use a new version of IDL, it is common to want to carry over the preference settings you were using with the previous version of IDL. The PREF_MIGRATE procedure exists to help you with this migration. You can run it at any time. In addition, each new version of IDL runs it once the first time you run that version if you have migratable preferences from other versions of IDL on your system.

This routine is written in the IDL language. Its source code can be found in the file pref_migrate.pro in the lib subdirectory of the IDL distribution.

Syntax

PREF_MIGRATE [, /MACRO] [, /PREFERENCE] [, /STARTUP]

Arguments

None

Keywords

MACRO

If this keyword is set, the migration process migrates only IDLDE macros. This option is allowed only under Microsoft Windows because it has no meaning to the Motif (UNIX) version of the IDLDE.

PREFERENCE

If this keyword is set, the migration process migrates only IDLDE preferences and not macros. This option has meaning only under Microsoft Windows. It is quietly ignored on other platforms.

STARTUP

At startup, if IDL determines that the user does not have a user preference file, it runs PREF_MIGRATE with the STARTUP keyword set prior to running the startup file (if any) or prompting the user for input. STARTUP mode differs from a regular call in a few ways:

Version History

6.2
Introduced

See Also

PREF_COMMIT, PREF_GET, PREF_SET

  IDL Online Help (March 06, 2007)