-qshowinc

Pragma equivalent

#pragma options [no]showinc

Purpose

When used with -qsource option to generate a listing file, selectively shows user or system header files in the source section of the listing file.

Syntax


        .-noshowinc-------------------------.   
>>- -q--+-showinc--+----------------------+-+------------------><
                   |      .-:---------.   |     
                   |      V .-all---. |   |     
                   '-=------+-sys---+-+---'     
                            +-nosys-+           
                            +-usr---+           
                            '-nousr-'

Defaults

-qnoshowinc: Header files included in source files are not shown in the source listing.

Parameters

all: Shows both user and system include files in the program source listing.
sys: Shows system include files (that is, files included with the #include <filename> preprocessor directive) in the program source listing.
usr: Shows user include files (that is, files included with the#include "filename" preprocessor directive or with -qinclude) in the program source listing.

Specifying showinc with no suboptions is equivalent to -qshowinc=sys : usr and -qshowinc=all. Specifying noshowinc is equivalent to -qshowinc=nosys : nousr.

Usage

This option has effect only when the -qlist or -qsource compiler options is in effect.

Predefined macros

None.

Examples

To compile myprogram.c so that all included files appear in the source listing, enter:

xlc myprogram.c -qsource -qshowinc

Related information

-qsource