home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_c / cc.lzh / CC / LATTICE / LC.DOC < prev    next >
Encoding:
Text File  |  1991-11-01  |  2.4 KB  |  59 lines
  1. FUNCTION    Compile/assemble/link C and assembler source, and object files.
  2.  
  3. USAGE       lc { -optstring [string] } { file.c | file.o | file.a }
  4.  
  5. DESCRIPTION
  6.  
  7.    A UNIX style driver for Lattice C compiler, assembler and linker.
  8.    The "(E dd)" or "(W dd)" in the error warnings from the compiler refer to
  9.    numbered errors and warnings, respectively. See the Lattice C manual.
  10.    Also note that the number of compiler error messages is limited to 20.
  11.  
  12.    The first named source file in the command line is used to name the
  13.    resulting executable file.  For example, "cc prog.o astr.a crfi.c"
  14.    results in an executable called "prog" being produced.
  15.  
  16. OPTIONS
  17.  
  18.    -d : Include extra information for debugging environment.  This option
  19.         works for all phases, so the "-c S" option for the assembler would
  20.         be redundant.
  21.    -C : Generate object files only; do not link.
  22.    -F : Runs the linker with the "faster" option.  There is
  23.         memory checking, and deallocation may not be done correctly.
  24.         Use with care.
  25.    -L : "Lint" : check for errors; do not generate object or executable
  26.         files.
  27.    -P : Just print what is to be done; do not execute the commands.
  28.  
  29.    Compiler options:
  30.  
  31.    Works mostly like LC, as documented in Lattice C Compiler Manual,
  32.    with following exceptions:
  33.  
  34.    -dDEF=VAL : must be one word - no spaces!
  35.    -q        : must be a volume or a directory (use trailing /, as "-q:t/")
  36.                (defaults to ram:)
  37.    -V        : non-existent : see -P, above
  38.  
  39.    Assembler options:
  40.  
  41.    Use the form,  "-ax string", where x is the option desired. See the
  42.    AmigaDOS Developer's Manual for options and related strings. Also,
  43.  
  44.    -A : Even if there are no .c files in the command line, link the results
  45.         together as if there were. (Helpful when all .c files were previously
  46.         compiled into object files.)
  47.  
  48. BUGS
  49.    Don't try compiling two files with the same name with different tasks at
  50.    the same time -- the program uses the same names for intermediate files
  51.    every time it runs.  In other words, don't run two compiles at once; 
  52.    this program wasn't written with multitasking in mind.
  53.  
  54.    In many of the cases, the syntax of the argument string is not checked.
  55.    For example, the -L option does not insist on there being only one source
  56.    file present; it just quietly ignores all but the first.
  57.  
  58.    Also, there is a limit of 32 files of each type in the command line. 
  59.