Texas Instruments TMS320C54x, User Manual

Page: 119 / 469

.copy/.include
Read Source File
4-36
Syntax
.copy [”] filename[”]
.include [”] filename[”]
Description The .copy and .include directives tell the assembler to read source state-
ments from a different file. The statements that are assembled from a copy file
are printed in the assembly listing. The statements that are assembled from
an included file are
not printed in the assembly listing, regardless of the num-
ber of .list/.nolist directives assembled. The assembler:
1) Stops assembling statements in the current source file.
2) Assembles the statements in the copied/included file.
3) Resumes assembling statements in the main source file, starting with the
statement that follows the .copy or .include directive.
The
filename is a required parameter that names a source file. It may be en-
closed in double quotes and must follow operating system conventions. You
can specify a full pathname (for example, c:\dsp\file1.asm). If you do not speci-
fy a full pathname, the assembler searches for the file in:
1) The directory that contains the current source file.
2) Any directories named with the –i assembler option.
3) Any directories specified by the environment variable A_DIR.
For more information about the –i option and A_DIR, see Section 3.4,
Naming
Alternate Directories for Assembler Input, on page 3-7.
The .copy and .include directives can be nested within a file being copied or
included. The assembler limits nesting to ten levels; the host operating system
may set additional restrictions. The assembler precedes the line numbers of
copied files with a letter code to identify the level of copying. An A indicates the
first copied file, B indicates a second copied file, etc.