Copyright Notice and Identification Pragmas

The following pragmas can be used to insert strings in code.

COPYRIGHT

#pragma COPYRIGHT "string

string is the set of characters included in the copyright message in the object file.

The COPYRIGHT pragma specifies a string to include in the copyright message and puts the copyright message into the object file.

If no date is specified (using pragma COPYRIGHT_DATE), the current year is used in the copyright message. For example, assuming the year is 1999, the directive #pragma COPYRIGHT "Acme Software" places the following string in the object code:

(C)Copyright Acme Software, 1999. All rights reserved. No part of this program may be photocopied, reproduced, or transmitted without prior written consent of Acme Software.

The following pragmas

#pragma COPYRIGHT_DATE "1990-1999"

#pragma COPYRIGHT "Brand X Software"

place the following string in the object code:

(C)Copyright Brand X Software, 1990-1999. All rights reserved. No part of this program may be photocopied, reproduced, or transmitted without prior written consent of Brand X Software.

COPYRIGHT_DATE

#pragma COPYRIGHT_DATE "string"

string is a date string used by the COPYRIGHT pragma.

This pragma specifies a date string to be included in the copyright message.

Use the COPYRIGHT pragma to put the copyright message into the object file.

For example, #pragma COPYRIGHT_DATE "1988-1992" places the string "1988-1992" in the copyright message.

LOCALITY

#pragma LOCALITY "string"

string specifies a name to be used for a code section.

The LOCALITY pragma specifies a name to be associated with the code written to a relocatable object module. The string is forced to be uppercase in C.

All code following the LOCALITY pragma is associated with the name specified in string. Code that is not headed by a LOCALITY pragma is associated with the name .text.

The smallest scope of a unique LOCALITY pragma is a function.

For example, the directive,

#pragma LOCALITY "MINE"

builds the name .text.MINE and associates all code following this pragma with this name, unless another LOCALITY pragma is encountered.

LOCALITY_ALL

#pragma LOCALITY_ALL string

Copyright Notice and Identification Pragmas 97