LLBLGen Pro v2.x to v5 project file migration template
============================================================
This additional template (with template bindings and a preset) is to be used to convert
a v2.x .lgp project file to a v5 .llblgenproj file. As v5 uses XML based project
files, it's necessary to convert a .lgp (which is a binary file). This template works with the
v2.6 designer only. If you're using v2.0 or v2.5 of the designer, please download the v2.6
designer from the customer area and use this template with that instance to convert your project.

Be sure to also read the 'Converting v2.x projects to v5' section in the manual.

NOTE: if you're using v1.x, you have to use v2.6's designer to convert the project file. If you don't have
a v2.x license but you do have a valid v5 license, please email info@llblgen.com with your v5 customerId 
to receive a free v2.x license.

Giving feedback
================
It's very important to us that this template works in all cases. If you run into a problem
and the problem isn't documented here or in the v5 documentation, and by examining the generated
llblgenproj file (which is XML based) you conclude it's a bug in the template, please
post a bugreport on our forums about this so we can investigate it. 

As always with bug reports, be aware that we don't have the data / code of your project in 
front of us, so please supply us with the details we need to reproduce this problem. We have
a secure helpdesk forum available if you have to supply a .lgp file for review. You can
also email the .lgp file to support@llblgen.com if you need to supply the .lgp file for us to
review.

Installation
==============
Unpack the .zip file in the installation folder of LLBLGen Pro v2.6. It will install
a new templategroups.config file in the AdditionalTemplates folder. If you get a prompt to 
overwrite this file, you already have such a file in that folder, and you should click 'No'
to NOT overwrite that file. Instead, open the templategroups.config file in the AdditionalTemplates
folder and add:
<templateGroup name="LLBLGen Pro v5" description="Template group which contains templates for converting v2 projects to v5 project files."/>

Usage
=======
Start the LLBLGen Pro v2.6 designer and load the project to convert. Press F7 to bring up
the code generation dialog. For 'Template group' you select 'LLBLGen Pro v5'. Choose a
.NET version (.NET 2.0/3.5/4.0) and language (C#). Specify the destination root folder
you want the llblgenproj file to be created in. 

Click 'Start generator'. The project is now generated as a .llblgenproj file. In the 
destination folder you have chosen, a file called 'ConvertedProjectv50Format.llblgenproj' has been
created. This is your v5 version of the .lgp project. Rename the file to your liking, e.g.
after the project name. 

NOTE for type converter users: if you use type converters in your LLBLGen Pro project
be sure you copy them to the 'TypeConverters' folder of v5. 

Start the v5 designer and load your converted project file. If you get an error, like
a type couldn't be loaded, make sure that if the type is typeconverter related, you have
placed your type converter in the v5 typeconverters folder or a folder which is reachable
by the v5 designer. 

After you've loaded the project, it might be v5.x's designer finds errors. This isn't the 
fault of the template, but caused by more strict rules implemented in v5's designer. Manually
fix the errors reported, if the designer reports any. After that, refresh your catalogs. The
project should now validate and is ready to use.

Post successful conversion
================================
After you've successfully converted the project, first check the new preferences and project properties
and adjust them to your liking before proceeding. 