Pragma Obsolescent

Syntax:

     pragma Obsolescent [(static_string_EXPRESSION)];

This pragma must occur immediately following a subprogram declaration. It indicates that the associated function or procedure is considered obsolescent and should not be used. Typically this is used when an API must be modified by eventually removing or modifying existing subprograms. The pragma can be used at an intermediate stage when the subprogram is still present, but will be removed later.

The effect of this pragma is to output a warning message that the subprogram is obsolescent if the appropriate warning option in the compiler is activated. If a parameter is present, then a second warning message is given containing this text.