These switches instruct KAP to build a library file containing
partially analyzed routines for later inlining. The library
created is used with the -inline_from_libraries
(-ipa_from_libraries ) switch.
Libraries created with -inline_create can be used with
either inlining or IPA, since they contain essentially complete
descriptions of the subroutines and functions included. Libraries
created with -ipa_create can be used only with IPA,
since they do not have the complete text of the routines, just the
data relationship information.
You can use any name for the created library. However, for maximum
compatibility with the -inline_from_libraries and
-ipa_from_libraries switches, Digital recommends that
you use the extension .klib .
The -inline_depth and -ipa_depth switches
set the maximum level of subprogram nesting that KAP will attempt
to inline. Higher values instruct KAP to trace CALLs and function
references further. The values and their meanings are as follows:
1 - 10 - Inline routines to this depth.
0 - Use the default value.
-1 - Inline only routines that do not contain
subroutine CALLs or function references.
Chapter 7 has examples of recursive
inlining with different values of -inline_depth .
The C*$* [no]inline and C*$* [no]ipa
directives, when enabled, are not affected by the
-inline_depth or -ipa_depth
restrictions.