-qxlines

Purpose

Specifies whether fixed source form lines with an X in column 1 are compiled or treated as comments.

This option is similar to the recognition of the character 'd' in column 1 as a conditional compilation (debug) character. The -qxlines option recognizes the character 'x' in column 1 as a conditional compilation character when this compiler option is enabled. The 'x' in column 1 is interpreted as a blank, and the line is handled as source code.

Syntax


Option:

        .-noxlines-.   
>>- -q--+-xlines---+-------------------------------------------><

@PROCESS:

@PROCESS XLINES |  NOXLINES

Defaults

-qnoxlines

This option is set to -qnoxlines by default, and lines with the character 'x' in column 1 in fixed source form are treated as comment lines.

While the -qxlines option is independent of -D, all rules for debug lines that apply to using 'd' as the conditional compilation character also apply to the conditional compilation character 'x'.

The -qxlines compiler option is only applicable to fixed source form.

Usage

The conditional compilation characters 'x' and 'd' may be mixed both within a fixed source form program and within a continued source line. If a conditional compilation line is continued onto the next line, all the continuation lines must have 'x' or 'd' in column 1. If the initial line of a continued compilation statement is not a debugging line that begins with either 'x' or 'd' in column 1, subsequent continuation lines may be designated as debug lines as long as the statement is syntactically correct.

The OMP conditional compilation characters '!$', 'C$', and '*$' may be mixed with the conditional characters 'x' and 'd' both in fixed source form and within a continued source line. The rules for OMP conditional characters will still apply in this instance.

Examples

An example of a base case of -qxlines:

      C2345678901234567890
             program p
             i=3 ; j=4 ; k=5
      X      print *,i,j
      X    +        ,k
             end program p

     <output>: 3 4 5     (if -qxlines is on)
               no output (if -qxlines is off)

In this example, conditional compilation characters 'x' and 'd' are mixed, with 'x' on the initial line:

     C2345678901234567890
            program p
            i=3 ; j=4 ; k=5
     X      print *,i,
     D    +         j,
     X    +         k
            end program p

     <output>: 3 4 5 (if both -qxlines and -qdlines are on)
               3 5   (if only -qxlines is turned on)

Here, conditional compilation characters 'x' and 'd' are mixed, with 'd' on the initial line:

     C2345678901234567890
            program p
            i=3 ; j=4 ; k=5
     D      print *,i,
     X    +         j,
     D    +         k
            end program p

     <output>: 3 4 5 (if both -qxlines and -qdlines are on)
               3 5   (if only -qdlines is turned on)

In this example, the initial line is not a debug line, but the continuation line is interpreted as such, since it has an 'x' in column 1:

     C2345678901234567890
            program p
            i=3 ; j=4 ; k=5
            print *,i
     X    +        ,j
     X    +        ,k
            end program p

     <output>: 3 4 5 (if -qxlines is on)
               3     (if -qxlines is off)