                            Building LCLint
                            ===============
			       7 May 1996
	
			      David Evans
			 evs@larch.lcs.mit.edu

To build LCLint you need:

o a (hopefully ANSI-conforming) C compiler.  On most modern Unix
  systems, cc will work fine.  For older or less standard
  systems, gcc is recommended.
o the GNU make utility (usually called make, gmake or gnumake).  
  If you don't have this installed on your system, download it from 
  ftp://prep.ai.mit.edu/pub/gnu/make-3.74.tar.gz.
o standard Unix tools: uncompress or gzip compression utility, 
  tar archive utility, csh command shell.

Build Instructions:

o Download one of the common packages:
    ftp://larch.lcs.mit.edu/pub/Larch/lclint/lclint.commmon.tar.[gz, Z]
    ftp://larch.lcs.mit.edu/pub/Larch/lclint/lclint.commmon-mini.tar.[gz, Z]

  (Unless you are very short on disk space, use lclint.common.tar.)

o Download the LCLint source package
    ftp://larch.lcs.mit.edu/pub/Larch/lclint/lclint.src.tar.[gz, Z]

o Copy both tar files to the directory where you want to build LCLint.  When
  a tar file is extracted, it will create an lclint-2.1b/ subdirectory in this 
  directory.

o Uncompress both tar files.  If you downloaded the .gz package,
  run 
	gzip -d lclint.src.tar.gz.  
  For the .Z package, run
	uncompress lclint.src.tar.Z.

o Extract files from the tar archive.  Run
	tar xf lclint.common.tar
	tar xf lclint.src.tar
  This will create an lclint-2.1b/ directory, containing several subdirectories.

o Run 
 	configure
  This will create a Makefile with settings for your system.  If you
  want to install LCLint or associated libraries different directories,
  edit the Makefile.

o Run 
	gmake (or whatever the GNU make utility is called)
  It is best to do this in an emacs shell or a buffered terminal, so you
  can scroll through the output.

o Visit vending machines while waiting for build to finish. 

o Run
	gmake test
  Check test output.  If there are errors, send a bug report to
  lclint-bug@larch.lcs.mit.edu.

o Join lclint-announce mailing list by sending a human-readable message
  to lclint-request@larch.lcs.mit.edu.



 


