CodeComposer:preserve:file
--------------------------

..	list-table::
	:widths: 15 100
	:header-rows: 0
	:class: tight-table

	*	-	Category
		-	CodeComposer directives
	*	-	Directive
		-	CodeComposer:preserve:file
	*	-	Deprecated name
		-	CodeComposer:ignore
	*	-	Purpose
		-	Instruct :term:`CodeComposer` to preserve the file in following generation runs.
	*	-	Arguments
		-	none
	*	-	Returns
		-	nothing
	*	-	Exceptions
		-	none
	*	-	Usage
		-	.. include:: usage.rst
	*	-	Example
		-	The following example shows parts of a generated Java class that the CodeComposer will preserve in following generation runs.
			Given any model CodeComposer will not write this file.

			.. code-block:: java
				:caption: Example.java
				:name: CodeComposer_preserve_1
				:linenos:
				:emphasize-lines: 1

				// CodeComposer:preserve:file
				public class Example {

				}

			The following example shows parts of a generated XML file that the CodeComposer will preserve in following generation runs.
			Given any model CodeComposer will not write this file.

			.. code-block:: xml
				:caption: logback.xml
				:name: CodeComposer_preserve_2
				:linenos:
				:emphasize-lines: 4

				<?xml version="1.0" encoding="UTF-8"?>
				<!DOCTYPE configuration>
				<configuration scan="true">
					<!--CodeComposer:preserve:file-->

				</configuration>

			.. note::

				The CodeComposer console window will show the following:

				Skip writing file '<filename>', because first 4 lines contains 'CodeComposer:preserve:file'