1 Splint - annotation-assisted static program checker
4 Copyright (C) 1994-2002
5 University of Virginia,
6 Massachusetts Institute of Technology
14 For documentation on Splint, please see http://www.splint.org
16 WARNING: this is an Alpha release - new features and changes are not
17 reflected in the documentation.
22 To build Splint you need:
24 o a (hopefully ANSI-conforming) C compiler. On most modern Unix systems,
25 cc will work fine. For older or less standard systems, gcc is
27 o gmake, the GNU make utility. If you don't have gmake installed on your
28 system, download it from prep.ai.mit.edu.
29 o standard Unix tools: gzip, tar
34 o bison version 1.28 or later - bison 1.27 and 1.25 are believed to
35 have bugs that cause problems with Splint's parsers.
37 If these are unavailable, you may be able to build Splint anyway using
38 the derived grammar files. This is not recommended however.
40 1. Download the Splint source package (splint-<version>.src.tgz).
42 Copy this package to the directory where you want to build Splint. When
43 the tar file is extracted, it will create an splint-<version> subdirectory.
45 2. Extract files from the tar archive:
46 tar xzf splint-<version>.src.tgz
50 This will create a Makefile with settings for your system. If you
51 want to install Splint or associated libraries different
52 directories, edit the Makefile.
56 It is best to do this in an emacs shell or a buffered terminal,
57 so you can scroll through the output.
59 6. Set environment variables
61 LARCH_PATH - path to search for splint libraries and
62 initializations files. If you are using the standard directories, this
63 should be .:<base-directory>/splint-<version>/lib.
65 LCLIMPORTDIR - directory containing lcl imports files. If you are using
66 the standard directories, this is <base-directory>/splint-<version>/imports.
68 Put the commands to set these variables (the actual commands will depend
69 on the shell you are using) in one of your initialization dotfiles
70 (usually ~/.environment).
72 Set up your PATH to include the directory containing
73 splint-<version>/bin/splint, or move the binary to a directory on
78 Examine the test output. If there are errors, send a bug
79 report to splint-bug@cs.virginia.edu
81 To subscribe to announcements of new Splint releases, send a message to
82 majordomo@virginia.edu containing the body:
84 subscribe lclint-announce
86 To participate in discussions related to Splint, send a message to
87 majordomo@virginia.edu containing the body:
89 subscribe lclint-interest