notes_history.sgml

来自「OTP是开放电信平台的简称」· SGML 代码 · 共 299 行

<!doctype chapter PUBLIC "-//Stork//DTD chapter//EN">
<!-- 
 ``The contents of this file are subject to the Erlang Public License,
 Version 1.1, (the "License"); you may not use this file except in
 compliance with the License. You should have received a copy of the
 Erlang Public License along with this software. If not, it can be
 retrieved via the world wide web at http://www.erlang.org/.
 
 Software distributed under the License is distributed on an "AS IS"
 basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 the License for the specific language governing rights and limitations
 under the License.
 
 The Initial Developer of the Original Code is Ericsson Utvecklings AB.
 Portions created by Ericsson are Copyright 1999, Ericsson Utvecklings
 AB. All Rights Reserved.''
 
     $Id$
-->
<chapter>
  <header>
    <title>STDLIB Release Notes (Old)</title>
    <prepared>Kenneth Lundin</prepared>
    <responsible>Kenneth Lundin</responsible>
    <docno></docno>
    <approved>Kenneth Lundin</approved>
    <checked>Kenneth Lundin</checked>
    <date>97-11-17</date>
    <rev>F</rev>
    <file>release_notes.sgml</file>
  </header>
  
    <p>This document describes the release notes for older versions
    of the <c>stdlib</c> application.

  <section>
    <title>Stdlib 1.3.2</title>
    
    <section>
      <title>Incompatibilities with Stdlib 1.3.1</title>
      <list>
	<item>
	  <p>Because of the major updates to the <c>slave</c> module a
	    version of OTP with this new slave module as described
	    here *cannot* start slave nodes on computers using an
	    older version of OTP, and vice versa.

	    <p>The return values from <c>slave</c> on error are
	    changed (atoms are used instead of strings).

	  <p>Own Id:OTP-1463
      </list>

    </section>
    <section>
      <title>Fixed Bugs and malfunctions</title>
      <list>
	<item>
	  <p><c>filename:basename("/foo/bar/")</c> returned wrong
	  result: <c>[]</c>. The last <c>/</c> should be ignored and
	  the result should be <c>"bar"</c>.

	  <p>Own Id:OTP-1451
      </list>
    </section>
      <section>
	<title>Improvements and new features</title>
      <list>
	<item>
	  <p><c>slave:start</c> is enhanced to work on other platforms
	    (e.g WIN32). Previously it was UNIX specific.

	  <p>Own Id:OTP-1463
	<item>
	  <p>The <c>timer</c> module is modified to be a gen_server
	    and is now supervised by the safe kernel supervisor.

	  <p>Own Id: OTP-1469
      </list>
    </section>
  </section>
      
  <section>
    <title>Stdlib 1.3.1</title>
      
    <section>
      <title>Fixed Bugs and malfunctions</title>
      <list>
	<item>
	  <p><c>ets</c> tables created before the system was converted to a
	    distributed system could not be accessed then the system
	    became distributed. The representation of the <c>ets</c> table
	    identifier is thus changed.
	  <p>Own Id: OTP-1393
      </list>
    </section>
  </section>

  <section>
      <title>Stdlib 1.3</title>
      
      <section>
	<title>Improvements and new features</title>
	
	<list>
	  <item>
	    <p><c>erl_eval</c> did crash on valid input like:
	      <code>
1> lists:sort(A=[1,2]).
	    </code>
	    <p>A correction conserning variable bindings is done.
	    <p>Own Id: OTP-1295
	  </item>
	  <item>
	    <p><c>dets:next</c> did sometimes erreounously return <c>'$end_of_table'</c>.
	    <p>Own Id: OTP-1293
	  </item>
	  <item>
	    <p>Corrected spelling errors in <c>help()</c> printout from shell.
	    <p>Own Id: OTP-1038
	  </item>

	<item><p>Added a new function <c>sync_notify</c> in <c>gen_event</c>.
	    <p>Own Id: OTP-1310

	<item>
	  <p>The functions <c>add_sup_handler/3</c> and
	    <c>swap_sup_handler/3</c> are added to the
	    <c>gen_event</c> module.  They are used to supervise
	    <c>gen_event</c> handlers.

	    <p>Own Id: OTP-1122
	</item>

	<item>
	  <p>It is possible to add several handlers using the same call-back
	    module to a <c>gen_event</c> event manager. Use the new
	    <c>{Module, Id}</c> syntax for such event handlers.
	</item>

	<item>
	  <p><c>gen_event</c> generates an error report when a handler
	    crashes.
	</item>

	<item><p>Two new supervisor types <c>rest_for_one</c> and
	  <c>simple_one_for_one</c> are added.
	  <p>Own Id: OTP-1177
	</item>

	<item><p><c>os:type/1</c> and its documentation is corrected. 
	  <p>Own Id: OTP-1185
	</item>

	<item>
	  <p>The function <c>init_ack/1</c> is added to the <c>proc_lib</c>
	    module.
	</item>

	<item>
	  <p><c>erl_lint</c> produces warnings related to the <c>behaviour</c>
	    module attribute. For example, missing call-back functions are
	    reported. This feature is used by the compiler.
	  <p>Own Id: OTP-1200
	</item>

      </list>
    </section>

    <section>
      <title>Fixed Bugs and malfunctions</title>
      <list>
	<item><p><c>gen_server:cast</c> and <c>gen_server:abcast</c> did 
	    sometimes crash if the server did not exist.
	    <p>Own Id:OTP-1343
	<item><p>The <c>ets</c> reference manual is corrected to describe
	    what happens when trying to access a non existant table.
	    <p>Own Id:OTP-1244
      </list>
    </section>

    <section>
      <title>Incompatibilities with Stdlib 1.2</title>
	  <p>-
    </section>
  </section>

  <section>
    <title>Stdlib 1.2</title>

    <section>
      <title>Improvements and new features</title>
      <list>
	<item>
	  <p>The <c>dets</c> module has been greatly enhanced. Previously
	    the <c>dets</c> module had no real space management on the file.
	    Now, space is managed on a per file basis by a builtin buddy system.
	    This means that allocation is much faster. The format of a dets file
	    is consequently also changed, the dets module will however 
	    recognize files with the old format and automatically upgrade
	    the file to the new format the first time it is opened.
	  <p>This has consequences for the Mnesia system, or rather it does not,
	    since the version upgrade is done automatically.
	<item>
	<p>A new module <c>filename</c> which has a number of useful functions 
		for manipulation of filenames. These functions are recommended
		to use
		when writing applications which shall be runnable on a number
	of different platforms.
	<item>
	<p>A new module <c>os</c> which provides functions which enables
	various information from the host operating system to the Erlang 
	programmer. The function <c>cmd/1</c> is equivalent with the 
	<c>unix:cmd/1</c> on a unix platform and will also be available
	on other platforms if applicable, e.g on Windows NT. This function
	is the recommended way of issuing operating system commands from
	Erlang programs (rather than <c>unix:cmd/1</c>). Other functions
	in the module are <c>version</c> and <c>type></c> which give
	information about the host operating system version and type.
      </list>
    </section>

    <section>
      <title>Fixed Bugs and malfunctions</title>
      <list>
	<item>
	  <p>The <c>ets</c> man page updated (Name instead of Id).
	  <p>Own Id: OTP-1001.
	<item>
	  <p>The <c>ets</c> module now handles arbitrarily many variables.
	    Previously there was an upper limit of 10.
	  <p>Own Id: OTP-1124.
      </list>
    </section>

  </section>

  <section>
    <title>Stdlib 1.1</title>

    <section>
      <title>Improvements and new features</title>
      <list>
        <item>
	  <p>Added <c>disk_log</c>, a disc based term logging facility.

	<item>
	  <p>Added <c>dets</c>, a disc based term storage.

	<item>
	  <p>Added <c>proc_lib:start/3,4</c>,
	  <c>proc_lib:start_link/3,4</c> and
	  <c>proc_lib:init_ack/2</c> for synchronous start of
	  <c>proc_lib</c> processes.

	<item>
	  <p>Added <c>regexp</c>, regular expression functions for strings.

	<item>
	  <p>It is possible to have anonymous supervisors.
      </list>
    </section>

    <section>
      <title>Fixed Bugs and malfunctions</title>

      <list>
	<item>
	  <p>Fixed bug in <c>timer</c> there timeouts would cause an internal
	    error under heavy load.
      </list>
    </section>

    <section>
      <title>Incompatibilities with OTP P1G</title>

      <list>
	<item>
	  <p>It is possible to change the internal state of the event manager
	    using the <c>gen_event:call</c> function. The <c>handle_call/2</c>
	    call-back function should return in a similar way as the
	    <c>handle_event/2</c> function.

	<item>
	  <p>A <c>gen_event</c> worker should specify <c>dynamic</c> for
	    modules in the supervisor child specification.
      </list>
    </section>

    <section>
      <title>Known bugs and problems</title>
      
      <p>-
    </section>
  </section>
</chapter>