ITK Release 4/MigrationGuideDeveloperTutorial: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
Line 13: Line 13:


==Step 2 - Create the XML Document==
==Step 2 - Create the XML Document==
* Follow the steps in either the Manual XML
* Follow the steps in either the Manual [[#Manual XML Document Generation]]


=Manual XML Document Generation=
=Manual XML Document Generation=


=Automatic XML Document Generation=
=Automatic XML Document Generation=

Revision as of 22:48, 11 November 2010

General Steps

This tutorial provides a quick walkthrough of how to document changes made to the API during the ITKv4 development process. The steps of this guide only need to be followed when making an API change. The process consists of creating an XML document in the $ITK_SOURCE_DIR/Migration folder that represents the changes made to the API and including this document in the patch that gets reviewed in Gerrit.

Step 1 - Make the Change

  • Start a new topic branch for the desired change
    • This topic branch should only be used to make the desired API change (it should not combine multiple change topics)
    • Give the branch a descriptive name that corresponds to the nature of the API change
    • The topic branch name should correspond to the name for the XML document
  • Make the API changes locally
  • Commit the changes
    • The changes must be committed prior to using the automatic XML initialization tool
    • Make sure to use descriptive commit messages for all commits since they will be used by the automatic tool when initializing the XML document

Step 2 - Create the XML Document

Manual XML Document Generation

Automatic XML Document Generation