aboutsummaryrefslogtreecommitdiffstats
path: root/lib/dialyzer/README
diff options
context:
space:
mode:
authorErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
committerErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
commit84adefa331c4159d432d22840663c38f155cd4c1 (patch)
treebff9a9c66adda4df2106dfd0e5c053ab182a12bd /lib/dialyzer/README
downloadotp-84adefa331c4159d432d22840663c38f155cd4c1.tar.gz
otp-84adefa331c4159d432d22840663c38f155cd4c1.tar.bz2
otp-84adefa331c4159d432d22840663c38f155cd4c1.zip
The R13B03 release.OTP_R13B03
Diffstat (limited to 'lib/dialyzer/README')
-rw-r--r--lib/dialyzer/README84
1 files changed, 84 insertions, 0 deletions
diff --git a/lib/dialyzer/README b/lib/dialyzer/README
new file mode 100644
index 0000000000..e9b03883d2
--- /dev/null
+++ b/lib/dialyzer/README
@@ -0,0 +1,84 @@
+##----------------------------------------------------------------------------
+## File: README
+## Author(s): Tobias Lindahl <[email protected]>
+## Kostis Sagonas <[email protected]>
+##
+## Copyright: Held by the authors; all rights reserved (2004 - 2009).
+##
+## $Id$
+##----------------------------------------------------------------------------
+
+The DIALYZER, a DIscrepany AnaLYZer for ERlang programs.
+
+
+-----------------------------------------------
+--
+-- Starting the Dialyzer
+--
+-----------------------------------------------
+
+You can use Dialyzer either in its GUI mode, simply by:
+
+ ./dialyzer
+
+or in its command-line mode, as e.g. by:
+
+ ./dialyzer -r OTP_DIR/lib/inets
+
+which analyzes all the bytecode (.beam) files of the "inets" application of
+the Erlang/OTP installation for discrepancies.
+
+The complete set of Dialyzer options is:
+
+ dialyzer [--help] [--version] [--shell] [--quiet] [--verbose]
+ [-pa dir]* [--plt plt] [-Ddefine]* [-I include_dir]*
+ [--output_plt file] [-Wwarn]* [--src]
+ [-c applications] [-r applications] [-o outfile]
+ [--build_plt] [--add_to_plt] [--remove_from_plt] [--check_plt]
+ [--plt_info] [--get_warnings]
+
+Use "dialyzer --help" to see an explanation of these options as well as
+a description of the various options to turn on or suppress certain types
+of warnings (for the latter only type "dialyzer -Whelp").
+
+
+The Persistent Lookup Table
+===========================
+Most Dialyzer uses require information about functions in the Erlang/OTP
+standard libraries. This information is stored in a Persistent Lookup
+Table (PLT) and is the starting point for later analyses. Before the
+first use of Dialyzer, the PLT needs to be built explicitly by the user
+using a command of the form:
+
+ dialyzer --build_plt -r lib/kernel/ebin lib/stdlib/ebin ... OTHER LIBS
+
+At each subsequent startup of Dialyzer the validity of this PLT is checked,
+and if something has changed in the libraries and applications that were
+included in it when the PLT was initially created, the PLT will be rebuilt.
+
+It is possible to have multiple PLTs and select dynamically among them.
+It is also possible to build PLTs incrementally. For more information
+refer to the documentation of the relevant options.
+
+
+-----------------------------------------------
+--
+-- More information about using the Dialyzer
+--
+-----------------------------------------------
+
+Start up the Dialyzer and click on its Help menu (in the upmost right corner)
+to read a brief overview and a user manual.
+
+
+-----------------------------------------------
+--
+-- Feedback & bug reports
+--
+-----------------------------------------------
+
+We welcome all sorts of user feedback (even wish-lists!). If you notice
+something weird, please send an error report describing the symptoms and
+how to reproduce them to:
+