Pragma Details

This section describes each Compiler-available pragma. The pragmas are listed in alphabetical order and are divided into separate tables. The following table lists and defines the topics that appear in the description of each pragma.

Table 1. Pragma Documentation Topics
Topic	Description
Scope	Defines scope of pragma in which it is valid (refer to the table "Definition of Items that can Appear in a Pragma's Scope Topic").
Syntax	Specifies pragma syntax in an EBNF format.
Synonym	Lists a synonym for the pragma or none, if no synonym exists.
Arguments	Describes and lists optional and required arguments for the pragma.
Default	Shows the default setting for the pragma or none.
Description	Provides a detailed description of the pragma and its use.
Example	Gives an example of usage and effects of the pragma.
See also	Names related sections.

The following table describes the different scopes of pragmas.

Table 2. Definition of Items that can Appear in a Pragma's Scope Topic
Scope	Description
File	The pragma is valid from the current position until the end of the file. Example: If the pragma is in a header file included from a source file, the pragma is valid in the header file but not the source file.
Compilation Unit	The pragma is valid from the current position until the end of the whole compilation unit. Example: If the pragma is in a header file included from a source file, it is valid in the header file and the source file.
Data Definition	The pragma affects only the next data definition. Ensure that you always use a data definition behind this pragma in a header file. If not, the pragma is used for the first data segment in the next header file, or in the main file.
Function Definition	The pragma affects only the next function definition. Ensure that you use this pragma in a header file: The pragma is valid for the first function in each included source file if there is no function definition in the header file.
Next pragma with same name	The pragma is used until the same pragma appears again. If no such pragma follows this one, it is valid until the end of the file.

The following listed are the pragmas for HCS08 compiler: