ITK Release 4/Users Migration Guide/Migration Guide XML Format

The goal of the migration guide XML documents is to encode all information about changes to the ITK API between the v3.X releases and v4.0. Each migration document consists of a single <Change> element and a set of associated child elements. The <Change> element has a set of required child elements and a set of additional optional child elements which can be used to automatically identify locations in user code where the API change will mandate updates. In the case of simple changes, these rules can be used to automatically fix user code with the migration tool.

Required Child Elements

• <Description>: English description of what changes were made along with

rational for making them.

• <SampleCode>: Code snippet either manually written or automatically harvested from the patch's changes that illustrates how to update the API from the old version to the new version. This element must contain two child elements, <Old> and <New>. As their names suggest, these two elements contain the snippets of old API code and new API code.
• <FileList>: A list of all files that were changed in association with the API change. File names should be specified relative to the base source directory for ITK.
• <Gerrit-ChangeId>: This element links the API change to the Gerrit entry used to review the change.