# First Run Wizard

This dialogue box appears only when you run CodeSnip 4 for the first time after updating from CodeSnip 3 or earlier.

Its purpose is to enable you to preserve preferences from the earlier version of CodeSnip and to import any user defined snippets database you may have created.

Note: If you run CodeSnip 4 as a different user you may see this dialogue box again since it performs configuration on a per-user basis.

The dialogue box takes the form of a multi-page wizard. You can't cancel or close the dialogue box prematurely: you must go through each step. It won't take long.

Each page of the wizard is described below.

## Introductory page

When the wizard appears you see an introductory page entitled "New version of CodeSnip". This page simply provides some information about the wizard along with some brief instructions.

Click Next to go to the next page. This will probably be the Preferences page, but on rare occasions you may see the Snippets database page instead.

## "Preferences" page

This page appears if an earlier preferences file has been detected. It enables you to preserve the preferences used by your earlier version of CodeSnip. Make sure the check box is ticked to do this, or clear it if you would prefer to use CodeSnip 4 with its default settings.

Most preferences from earlier versions can be preserved, with a few exceptions for older versions of the program. These are:

- Any syntax highlighter customisation you have made will be lost if you are updating from any v2 or earlier release.
  You will need to redo any customisation using the Syntax Highlighter page of the Preferences dialogue box.
- Your source code formatting preferences will have been lost if you are updating from v1.7.4 or earlier.
  You will need to reconfigure them using the Code Formatting page of the Preferences dialogue box.

Once you have decided whether to preserve preferences, click the Next button. This will take you to the Snippets database page or the Summary page, depending on whether a user defined snippets database has been found.

## "Snippets database"

This page appears if a user-defined snippets database has been detected. It enables you to create a copy of the database suitable for use by CodeSnip 4. To do this ensure that the check box is ticked. If you prefer to abandon the database, clear the check box.

If you do create a copy of the database any changes you make to it in CodeSnip 4 will not be reflected in the earlier copy, and vice versa. This is because a snippets database updated by CodeSnip 4 ceases to be readable by earlier versions.

Note: If you don't install the old database you can still export snippets from it later, using the old version of CodeSnip and then import them with CodeSnip 4. If you think you may need to do this do not uninstall the older version of CodeSnip. See Exporting and Importing Snippets for further information about importing and exporting.

## "Summary" page

This page summarises the actions you are taking. It is your last chance to change your mind before committing yourself.

You should read the information carefully, and use the Back button to go back to the earlier pages if you want to change anything.

When you are ready click the Confirm button to configure CodeSnip 4. There is no undo.

## "Finished" page

This page is displayed after the configuration is complete.

If you preserved your preferences and any loss of information has been detected, or is possible, that information is listed here. See the "Preferences" page section above for details. Otherwise the page simply reports that the process is complete.

Click Finish to close the wizard. CodeSnip 4 will now load normally.