HELPLIB.HLB  —  CC  /ANNOTATIONS
     /ANNOTATIONS[=(option,...)]
     /NOANNOTATIONS (D)

  Controls whether or not the source listing file is annotated with
  indications of specific optimizations performed or, in some cases,
  not performed.  These annotations can be helpful in understanding
  the optimization process.

  Select one or more of the following /ANNOTATIONS qualifier options:

     ALL

        Selects all annotations.  This output can be quite verbose
        because it includes detailed output for all annotations.  For
        more concise output for each kind of annotation, use
        /ANNOTATIONS=(ALL,NODETAIL), or just /ANNOTATIONS with no
        qualifier options.

     [NO]CODE

        Annotates the machine-code listing with descriptions of
        special instructions used for prefetching, alignment, and so
        on.  The /MACHINE_CODE qualifier must also be specified for
        /ANNOTATION=CODE to have any visible effect.

     [NO]DETAIL

        Provides additional level of annotation detail, where
        available.

     [NO]FEEDBACK

        Indicates use of profile-directed feedback optimizations.
        Feedback optimizations are not implemented on OpenVMS
        systems, so this keyword has no visible effect.

     [NO]INLINING

        Indicates where code for a called procedure was expanded
        inline.

     [NO]LOOP_TRANSFORMS

        Indicates optimizations such as loop reordering and code
        hoisting.

     [NO]LOOP_UNROLLING

        Indicates where advanced loop nest optimizations have been
        applied to improve cache performance (unroll and jam, loop
        fusion, loop interchange, and so on).

     [NO]PREFETCHING

        Indicates where special instructions were used to reduce
        memory latency.

     [NO]SHRINKWRAPPING

        Indicates removal of code establishing routine context when
        it is not needed.

     [NO]SOFTWARE_PIPELINING

        Indicates where loops have been scheduled to hide functional
        unit latency.

     [NO]TAIL_CALLS

        Indicates an optimization where a call from routine A to B
        can be replaced by a jump.

     [NO]TAIL_RECURSION

        Indicates an optimization that eliminates unnecessary routine
        context for a recursive call.

     NONE

        Same as /NOANNOTATIONS.

 The default is /NOANNOTATIONS.

 Specifying /ANNOTATIONS with no keywords is the same as specifying
  /ANNOTATIONS=(ALL,NODETAIL).
Close Help