notes.sgml

OTP是开放电信平台的简称

<!doctype chapter PUBLIC "-//Stork//DTD chapter//EN">
<chapter>
  <header>
    <title>Dilayzer Release Notes</title>
    <prepared>otp_appnotes</prepared>
    <docno>nil</docno>
    <date>nil</date>
    <rev>nil</rev>
  </header>
  
  <p>This document describes the changes made to the Dialyzer
    application.</p>

<section><title>Dialyzer 1.7.0</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Minor Makefile changes.</p>
          <p>
	    Own Id: OTP-6689</p>
        </item>
        <item>
	    <p>Dialyzer can now use success typings to find
	    discrepancies. As a consequence significantly more
	    discrepancies are detected. The downside is that the
	    analysis takes about 2 to 2.5 times longer than in
	    previous versions, and may also result in some warnings
	    that might be harder to interpret even though they are
	    correct. This has been a major change, worth of
	    increasing the version number.</p>
	    <p>New command-line options:</p>
	    <p>--succ_typings Use the success typings analysis.</p>
	    <p>--dataflow (default) Use the previous analysis.</p>
	    <p>The new type unit() has been introduced to handle the
	    return type of non-terminating functions such as
	    servers.</p>
	    <p>Dialyzer's code server uses a compressed
	    representation and the analysis requires significantly
	    less memory than in previous versions.</p>
          <p>
	    Own Id: OTP-6736</p>
        </item>
      </list>
    </section>

</section>


<section><title>Dialyzer 1.6.0</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Dialyzer (in the modes where either source or BEAM
	    code which contains debug_info is analyzed) spits out
	    line information for all discrepancies. This has been a
	    major change, worth of increasing the version number.</p>
	    <p>We warn users that *considerably* more discrepancies
	    are identified by this version of Dialyzer compared with
	    previous ones and applications. If, for some reason,
	    warnings generated by previous versions of Dialyzer are
	    preferable, the command line option --old_style can be
	    employed.</p>
          <p>
	    Own Id: OTP-6546</p>
        </item>
        <item>
	    <p>Dialyzer handles term comparison operators more
	    precisely and is able to identify more discrepancies in
	    'if' or 'case' statements with comparisons.<p>
	    <p>Dialyzer has more precise type information for many
	    standard OTP functions.</p>
          <p>
	    Own Id: OTP-6547</p>
        </item>
      </list>
    </section>

</section>

<section><title>Dialyzer 1.5.1</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Updated the chapter "More on the Persistant Lookup Table
	    (PLT)" in Dialyzer User's Guide and added information on
	    how to use Dialyzer from Erlang to <c>dialyzer(3)</c>.
	    Also, the Dialyzer text files used by its GUI are now
	    included in the Erlang/OTP release.</p>
          <p>
	    Own Id: OTP-6361</p>
        </item>
        <item>
	    <p>New options <c>--check_init_plt</c> and
	    <c>--verbose</c>.</p>
	    <p>Improvements in the analysis (meaning that this
	    version can find more discrepancies than the previous
	    version).</p>
          <p>
	    Own Id: OTP-6421</p>
        </item>
      </list>
    </section>

</section>


<section><title>Dialyzer 1.5.0</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Dialyzer's building of PLT is based on a different
	    type inference algorithm. More specifically, Dialyzer
	    uses inferrence of refined success typings to infer
	    function prototypes. As a result, Dialyzer bases its
	    analysis on a significantly more powerful basis and thus
	    is able to detect more discrepancies. The downside is
	    that building the PLT is a considerably slower process.
	    We will work on improving that.</p>
	    <p>Dialyzer takes into account the BEAM compiler
	    directive <c>-compile({nowarn_unused_function,
	    {F,A}}).</c> and then suppresses the warning that
	    function F/A will never be called.</p>
	    <p>Dialyzer's default initial PLT now also includes
	    "mnesia".</p>
          <p>
	    Own Id: OTP-6304
        </item>
      </list>
    </section>

</section>

<section><title>Dialyzer 1.4.2</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Improvements in PLT management.
          <p>
	    Own Id: OTP-6128
        </item>
      </list>
    </section>

</section>

  <section><title>Dialyzer 1.4.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Some minor changes.
	  </p>
	</item>
      </list>
    </section>
    
    <section><title>Improvements and New Features</title><list>
	<item>
	  <p>
	    Some minor changes.
	  </p>
	</item>
      </list>
    </section>
  
  </section>
  
  <section><title>Dialyzer 1.4.0</title>
      
    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Changes for Dialyzer to work with Erlang/OTP R10B-10.
	  </p>
	</item>
      </list>
    </section>

    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Dialyzer's analysis is significantly faster as it uses a global function
	    call-graph for obtaining type signatures for all analyzed functions.
	  </p>
	</item>
      </list>
    </section>
  
  </section>
  
  <section><title>Dialyzer 1.3.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Small changes for Dialyzer to work with Erlang/OTP R10B-5.
	  </p>
	</item>
	<item>
	  <p>
	    Fixed a small buglet in the analysis; this affected one of HiPE's files.
	  </p>
	</item>
      </list>
    </section>

    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Modified setup script for execution under Cygwin (patch by Vlad Dumitrescu).
	  </p>
	</item>
	<item>
	  <p>
	    Added command line option --no_warn_on_inline.
	  </p>
	</item>
	<item>
	  <p>
	    Dialyzer now explicitly warns when modules with the same name
	    but from different dirs are being analyzed (contribution by Ulf Wiger).
	  </p>
	</item>
      </list>
    </section>

  </section>

  <section><title>Dialyzer 1.3.0</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Fixed a number of false positives that Dialyzer 1.2.0 was spitting out.
	  </p>
	</item>
      </list>
    </section>

    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Requires the presence of an Erlang/OTP R10B-4 system.
	  </p>
	</item>
	<item>
	  <p>
	    Dialyzer is significantly (approx 40%) faster since it now uses 'ets'
	    rather than 'dets' for its PLT.
	  </p>
	</item>
	<item>
	  <p>
	    Slightly improved the precision of the analysis.
	  </p>
	</item>
	<item>
	  <p>
	    In the GUI version, Dialyzer now reports the list of modules that should
	    be included in the modules to analyze in order to possibly improve
	    the accuracy of the reported results.
	  </p>
	</item>
	<item>
	  <p>
	    Some more information is displayed when calling a function or closure
	    with arguments of the wrong type.
	  </p>
	</item>
	<item>
	  <p>
	    The record guard now allows discrepancies involving tuples that are known
	    to be records to be displayed as #rec{} rather than {'rec',_,...,_}
	  </p>
	</item>
	<item>
	  <p>
	    Added -q option which makes the command-line version of Dialyzer
	    a bit more silent.
	  </p>
	</item>
      </list>
    </section>
      
  </section>

  <section><title>Dialyzer 1.2.0</title>
      
    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Dialyzer works with the open source and commercial versions of Erlang/OTP
	    R10B-2 on all platforms (i.e., HiPE support is not a prerequisite anymore).
	  </p>
	</item>
	<item>
	  <p>
	    Whenever a .beam file contains abstract code (i.e., has been compiled
	    with the +debug_info option), the analysis starts from this code rather
	    than from BEAM bytecode -- this makes the results identical to those
	    obtained by analysis starting from source code.
	    (This is a contribution from Bjorn Gustavsson - Thanks!)
	  </p>
	</item>
	<item>
	  <p>
	    Added -pa command line option for easier handling of -include_lib()
	    directives in source code.
	  </p>
	</item>
	<item>
	  <p>
	    Includes all changes added in v1.1.1; see below.  The "Add Recursively"
	    functionality is also available in the command-line mode (-r option).
	  </p>
	</item>
      </list>
    </section>
    
  </section>

  <section><title>Dialyzer 1.1.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Fixed problems using the shell script on Solaris machines.
	  </p>
	</item>
	<item>
	  <p>
	    Fixed small inconsistencies in Dialyzer's documentation and help.
	  </p>
	</item>
      </list>
    </section>
    
    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    The command-line mode of Dialyzer spits discrepancies in stdout
	    by default and returns a numeric value indicating its exit status.
	  </p>
	</item>
	<item>
	  <p>
	    Added "Add Recursively" button contributed by Martin Bjorklund (thanks!).
	  </p>
	</item>
      </list>
    </section>

  </section>


  <section><title>Dialyzer 1.1.0</title>

    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Dialyzer works with the open source version of Erlang/OTP R10B-1 (on
	    platforms where HiPE support is available) and it does not require
	    installation of a customized Erlang/OTP system anymore.
	  </p>
	</item>
	<item>
	  <p>
	    Dialyzer comes with an extensive command-line interface, in addition
	    to an enhanced GUI.
	  </p>
	</item>
	<item>
	  <p>
	    Analysis can start from source code (through Core Erlang) as well as
	    from BEAM bytecode.
	  </p>
	</item>
	<item>
	  <p>
	    Dialyzer finds considerably more discrepancies in Erlang code than
	    previous versions.
	  </p>
	</item>
	<item>
	  <p>
	    Added ability to selectively turn on/off different warning categories.
	  </p>
	</item>
      </list>
    </section>
    
  </section>
  


  <section><title>Dialyzer 1.0.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
	<item>
	  <p>
	    Fixed major bug of v1.0.0 which caused the analysis to stop prematurely
	    (i.e., without properly reaching fixpoint) when analyzing more than one
	    module.  This did not affect correctness of the results, but lost many
	    opportunities to detect discrepancies.
	  </p>
	</item>
      </list>
    </section>
    
    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Performance improvements in the analysis.
	  </p>
	</item>
      </list>
    </section>
    
  </section>

  <section><title>Dialyzer 1.0.0</title>

    <section><title>Improvements and New Features</title>
      <list>
	<item>
	  <p>
	    Initial Dialyzer version: Analysis starts from BEAM bytecode only and 
	    only a GUI version is available. Dialyzer reports discrepancies in the
	    use of the "sequential" part of Erlang. To be used, Dialyzer requires
	    the presence of a specific snapshot of Erlang/OTP which can be obtained
	    from Dialyzer's homepage.
	  </p>
	</item>
      </list>
    </section>
    
  </section>


  </chapter>