elmerge(1)                          CLIX                          elmerge(1)



  NAME

    elmerge - Generates program listing files for C, FORTRAN, and Pascal

  SYNOPSIS

    elmerge [+ppath[:path...]] [+e] [+n] [+i] [compiler options] [files]

  FLAGS

    Flags that begin with a plus sign + are parsed by elmerge, while those
    that begin with a minus sign - are passed on to the compiler.

    +n       Numbers the lines in the listing file for each source file.  By
             default, no line numbers are generated.

    +e       Invokes the compiler for the source file(s).  If the compiler
             prints any warnings or errors, they are inserted at the
             appropriate line in the listing file.  By default, compiler
             output is not inserted.

             The compiler invoked is determined by the extension of the source
             file.  If the file ends in .c, the acc command is run.  If the
             file ends in .f or .F, the af77 command is run.  It is
             permissible to mix sources from C, FORTRAN, and Pascal in one
             run, but the user is responsible for any conflicts caused by the
             compiler options.

             If a file does not have one of the extensions listed above, no
             compiler is invoked, and only a listing of the file is generated.

    +i       Generates individual listing files.  By default, elmerge
             generates one listing file for all of the source files.
             Individual listing files are named the same as the original
             source file, except that the extension is changed to .E.

             If a file has no extension, the .E extension is added. (Filenames
             longer than 12 characters are first truncated, and then the
             extension is added.)

    +ppath   Designates a list of search paths for the source files.  If more
             than one path is specified, the colon character (:) is used as a
             separator.

  DESCRIPTION

    The elmerge utility generates program listing files for C, FORTRAN, and
    Pascal sources.  Flags beginning with a plus sign + are parsed by elmerge,
    while those beginning with a minus sign - are passed to the compiler.  The
    tokens remaining are processed as source files.




  2/94 - Intergraph Corporation                                              1

  elmerge(1)                          CLIX                          elmerge(1)



    By default, elmerge simply generates a listing file named elmerge.E, which
    includes a copy of each specified source.

  EXAMPLES

    1.  The following example creates a line-numbered listing of the source
        file main.c and puts the output in elmerge.E.

        $  elmerge +n main.c


    2.  This example generates a listing of the source file bugs.f with
        compiler errors and warnings inserted and puts the output in
        elmerge.E.

        $  elmerge +e bugs.f


    3.  This example creates three listing files--main.E, funcs.E, and
        subs.E--each of which conatins a line-numbered listing of the original
        source file.  If any of the source files are not found in the current
        working directory, elmerge searches for them in the directories src
        and src2, in that order.

        $  elmerge +n +i +psrc:src2 main.c funcs.c subs.c


    4.  In this example, the -knr compiler option is passed to the compiler
        when it is invoked for main.c.

        $  elmerge +e -knr main.c


  CAUTIONS

    Mixing C, FORTRAN, and Pascal source files is tolerated, but if the +e
    flag is present, be aware that all flags starting with - are passed to
    each compiler when it is invoked.

  EXIT VALUES

    The command exits with a value of 0 if successful.

  RELATED INFORMATION

    Commands:  acc(1), af77(1), pc(1)








  2                                              Intergraph Corporation - 2/94