[Insight-developers] migration guide

[Gabe Hart]

Hi Gaëtan,

This is a great (and timely) question.  I'm currently working on getting 
this all set up and just finished a first prototype of the XML file 
initialization script (attached).  The goal of this script is to 
initialize all the fields of the XML file using information from your 
git commits.  I'm also in the process of putting together a step-by-step 
tutorial of the process at:

http://www.itk.org/Wiki/ITK_Release_4/MigrationGuideDeveloperTutorial

At this point, the simple solution should be to put the script in 
$ITK_SOURCE_DIR/Migration and run it from $ITK_SOURCE_DIR (might work in 
other ways, but not tested yet).  It will ask for a unique name that 
describes the change (there aren't many xml files in the Migration 
folder yet, so this should be easy to come up with).  The script will 
then generate a file in the Migration folder with the initial fields 
filled in.  It should be manually edited for conciseness (it is 
basically just a dump of info from the git commits).

For information about what should ultimately be in the XML file, see

http://www.itk.org/Wiki/ITK_Release_4/Users_Migration_Guide/Migration_Guide_XML_Format

-Gabe

PS: As I wrote this, I realized that I forgot to make the script handle 
the <Title> element, so a revision for that will be forthcoming

On 11/19/2010 10:25 AM, Gaëtan Lehmann wrote:
>
> Hi Gabe,
>
> I've proposed a non backward compatible change that I like to document 
> for the migration guide:
>
>   http://review.source.kitware.com/#change,374
>
> I'm a bit lost though, probably because I was not at the fall meeting.
> In
>
>   http://itk.org/Wiki/ITK_Release_4/MigrationGuideDeveloperTutorial
>
> some automatic tools are mentioned, but I can't find them.
>
> Do we already have those tools?
>
> Thanks,
>
> Gaëtan
>
>


-- 
Gabe Hart
R&D Engineer
Kitware, Inc. - North Carolina Office
http://www.kitware.com
(919) 969-6990 x317

-------------- next part --------------
A non-text attachment was scrubbed...
Name: InitializeXMLGuide.py
Type: text/x-python
Size: 8120 bytes
Desc: not available
URL: <http://www.itk.org/mailman/private/insight-developers/attachments/20101119/25f5499e/attachment-0001.py>