.. include:: /inline-images.txt

.. _CodeComposerDirectives:

CodeComposer Directives
=======================

**CodeComposer** **directives** direct the CodeComposer to **preserve** **manual** **changes** **in** **generated** **files** in following generation runs.
Developers should use specific directives whenever they have adapted a generated file manually before running CodeComposer again.

.. admonition:: Feature: Preserve manually adapted code
	:class: feature

	By directing CodeComposer to preserve manually adapted code in certain generated files, you can easily make adjustments in generated code directly in the file, as CodeComposer will not overwrite your manual changes in the next run.

To determine the right CodeComposer directive to use follow the steps in the :ref:`Activity diagram for determining CodeComposer directives<DirectivesActivityDiagram>` below:

.. figure:: images/codecomposer-directives-activity-diagram.png
	:name: DirectivesActivityDiagram
	
	Activity diagram for determining CodeComposer directives

The following CodeComposer directives can be used in generated files to instruct CodeComposer to preserve manually written code in generated files:

.. toctree::
   :maxdepth: 2
   :caption: Contents

   CodeComposerPreserveFile
   CodeComposerPreserveField
   CodeComposerPreserveMethod
   CodeComposerAutopreservedField
   CodeComposerAutopreservedMethod