File: notes.html

package info (click to toggle)
erlang-doc-html 1%3A11.b.2-1
links: PTS
area: main
in suites: etch, etch-m68k
size: 23,284 kB
ctags: 10,724
sloc: erlang: 505; ansic: 323; makefile: 62; perl: 61; sh: 45
file content (1550 lines) | stat: -rw-r--r-- 36,028 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- This document was generated using DocBuilder 3.3.3 -->
<HTML>
<HEAD>
  <TITLE>STDLIB Release Notes</TITLE>
  <SCRIPT type="text/javascript" src="../../../../doc/erlresolvelinks.js">
</SCRIPT>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#FF00FF"
      ALINK="#FF0000">
<CENTER>
<A HREF="http://www.erlang.se"><IMG BORDER=0 ALT="[Ericsson AB]" SRC="min_head.gif"></A>
</CENTER>
<A NAME="1"><!-- Empty --></A>
<H2>1 STDLIB Release Notes</H2>

<P>This document describes the changes made to the STDLIB application.
<A NAME="1.1"><!-- Empty --></A>
<H3>1.1 STDLIB 1.14.2</H3>
<A NAME="1.1.1"><!-- Empty --></A>
<H4>1.1.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         The control sequences <CODE>p</CODE> and <CODE>P</CODE> of the
         <CODE>Format</CODE> argument of the functions
         <CODE>io:format/2,3</CODE> and <CODE>io_lib:format/2</CODE> did not
         handle binaries very well. This bug, introduced in
         stdlib-1.14, has been fixed.
<BR>
         Own Id: OTP-6230
<BR>

</LI>


<LI>
         <CODE>filelib:wildcard(Wc, PathWithRedundantSlashes)</CODE>,
         where <CODE>PathWithRedundantSlashes</CODE> is a directory path
         containing redundant slashes, such as <CODE>/tmp/</CODE> or
         <CODE>//tmp</CODE>, could return incorrect results. (Thanks to
         Martin Bjorklund.)
<BR>
         Own Id: OTP-6271
<BR>

</LI>


<LI>
         The Erlang code preprocessor crashed if the predefined
         macros ?MODULE or ?MODULE_STRING were used before the
         module declaration. This bug has been fixed.<BR>

         Own Id: OTP-6277
<BR>

</LI>


</UL>
<A NAME="1.1.2"><!-- Empty --></A>
<H4>1.1.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
         Support for faster join of two tables has been added
         to the <CODE>qlc</CODE> module. There are two kinds of fast
         joins: lookup join that uses existing indices, and merge
         join that takes two sorted inputs. There is a new
         <CODE>join</CODE> option that can be used to force QLC to use a
         particular kind of join in some QLC expression.<BR>

         Several other changes have also been included:<BR>

         <BR>

<UL>

<LI>
The new <CODE>tmpdir</CODE> option of <CODE>cursor/2</CODE>,
         <CODE>eval/2</CODE>, <CODE>fold/4</CODE>, and <CODE>info/2</CODE> can be
         used to set the directory that join uses for temporary
         files. The option also overrides the <CODE>tmpdir</CODE> option
         of <CODE>keysort/3</CODE> and <CODE>sort/2</CODE>.<BR>

</LI>


<LI>
The new <CODE>lookup</CODE> option can be used to
         assert that constants are looked up when evaluating some
         QLC expression.<BR>

</LI>


<LI>
The <CODE>cache</CODE> and <CODE>cache_all</CODE> options
         accept new tags: <CODE>ets</CODE>, <CODE>list</CODE>, and <CODE>no</CODE>.
         The tag <CODE>list</CODE> caches answers in a list using a
         temporary file if the answers cannot be held in RAM.
         Combining <CODE>{cache,list}</CODE> and <CODE>{unique, true}</CODE>
         is equivalent to calling <CODE>sort/2</CODE> with the option
         <CODE>unique</CODE> set to <CODE>true</CODE>. The old tags
         <CODE>true</CODE> (equivalent to <CODE>ets</CODE>) and <CODE>false</CODE>
         (equivalent to <CODE>no</CODE>) are recognized for backward
         compatibility.<BR>
 
</LI>


<LI>
The new option <CODE>max_list_size</CODE> can be used
         to set the limit where merge join starts to use temporary
         files for large equivalence classes and when answers
         cached in lists are put on temporary files.<BR>

</LI>


<LI>
There is a new callback <CODE>is_sorted_key</CODE> to
         be supplied as an option to <CODE>table/2</CODE>.<BR>

</LI>


<LI>
QLC analyzes each and every QLC expression when
         trying to find constants for the lookup function.
         Hitherto only QLC expressions with exactly one generator
         were analyzed.<BR>
 Note that only filters with guard
         syntax placed immediately after the generator are
         analyzed. The restriction to guard filters is an
         incompatible change. See <CODE>qlc(3)</CODE> for further
         details.<BR>

</LI>


<LI>
In a similar way several match specifications
         for traversal of QLC tables can be utilized for different
         generators of one single QLC expression.<BR>

</LI>


<LI>
A bug has been fixed: when caching answers to a
         sufficiently complex query it could happen that some
         answers were not returned.<BR>

</LI>


</UL>

         *** POTENTIAL INCOMPATIBILITY ***
<BR>
         Own Id: OTP-6038
<BR>

</LI>


<LI>
         The Erlang pretty printer (<CODE>erl_pp</CODE>) is now much
         faster when the code is deeply nested. A few minor bugs
         have been fixed as well.
<BR>
         Own Id: OTP-6227 Aux Id: OTP-5924 
<BR>

</LI>


<LI>
         The Erlang shell now tries to garbage collect large
         binaries. Under certain circumstances such binaries could
         otherwise linger on for an indefinite amount of time.
<BR>
         Own Id: OTP-6239
<BR>

</LI>


<LI>
         To help Dialyzer find more bugs, many functions in the
         Kernel and STDLIB applications now only accept arguments
         of the type that is documented.<BR>

         For instance, the functions <CODE>lists:prefix/2</CODE> and
         <CODE>lists:suffix/2</CODE> are documented to only accept lists
         as their arguments, but they actually accepted anything
         and returned <CODE>false</CODE>. That has been changed so that
         the functions cause an exception if one or both arguments
         are not lists.<BR>

         Also, the <CODE>string:strip/3</CODE> function is documented
         to take a character argument that is a character to strip
         from one or both ends of the string. Given a list instead
         of a character, it used to do nothing, but will now cause
         an exception.<BR>

         Dialyzer will find most cases where those functions
         are passed arguments of the wrong type.<BR>

         *** POTENTIAL INCOMPATIBILITY ***
<BR>
         Own Id: OTP-6295
<BR>

</LI>


</UL>
<A NAME="1.2"><!-- Empty --></A>
<H3>1.2 STDLIB 1.14.1</H3>
<A NAME="1.2.1"><!-- Empty --></A>
<H4>1.2.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         The functions <CODE>c:y/1,2</CODE> which call
         <CODE>yecc:file/1,2</CODE> are now listed by
         <CODE>c:help/0</CODE>.<BR>

         Documentation of <CODE>c:y/1,2</CODE> has been added to
         <CODE>c(3)</CODE>.<BR>

         The fact that the control sequence character <CODE>s</CODE>
         recognizes binaries and deep character lists has been
         documented in <CODE>io(3)</CODE>. This feature was added in
         R11B-0 (OTP-5403).<BR>

         Own Id: OTP-6140
<BR>

</LI>


<LI>
         The shell command rr() sometimes failed to read record
         definitions from file(s). This problem has been fixed.
<BR>
         Own Id: OTP-6166 Aux Id: OTP-5878 
<BR>

</LI>


<LI>
         The nonlocal function handler in <CODE>erl_eval</CODE>, which
         is used for implementing the restricted mode of the
         Erlang shell, did not handle calls to
         <CODE>erlang:apply/3</CODE> correctly. This bug has been fixed.
<BR>
         Own Id: OTP-6169 Aux Id: seq10374 
<BR>

</LI>


<LI>
         ets:rename/1 could deadlock, or crash the SMP emulator
         when the table wasn't a named table.
<BR>
         ets:next/2, and ets:prev/2 could return erroneous results
         on the SMP emulator.
<BR>
         Own Id: OTP-6198 Aux Id: seq10392, seq10415 
<BR>

</LI>


<LI>
         When closing a Dets table the space management data was
         sometimes saved in such a way that opening the table
         could not be done without repairing the file. This bug
         has been fixed.
<BR>
         Own Id: OTP-6206
<BR>

</LI>


</UL>
<A NAME="1.3"><!-- Empty --></A>
<H3>1.3 STDLIB 1.14</H3>
<A NAME="1.3.1"><!-- Empty --></A>
<H4>1.3.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
                 A bugfix in QLC: two of the call-back functions used
         for implementing QLC tables, <CODE>TraverseFun</CODE> and
         <CODE>LookupFun</CODE>, are now allowed to return a term other
         than a list. Such a term is immediately returned as the
         results of the current query, and is useful mostly for
         returning error tuples.<BR>

                 Several other minor bugs have been also been fixed.<BR>

         Own Id: OTP-5195<BR>


</LI>


<LI>
         The STDLIB modules <CODE>error_logger_file_h</CODE> and
         <CODE>error_logger_tty_h</CODE> now read the environment
         variable <CODE>utc_log</CODE> from the SASL application.<BR>

         Own Id: OTP-5535<BR>


</LI>


<LI>
         <CODE>ets:info/1</CODE> has been corrected to behave according
         to the documentation and return a list of tuples, not a
         tuple with tuples.<BR>

         *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-5639<BR>


</LI>


<LI>
          Referencing a so far undeclared record from the default
         value of some record declaration is from now on considered
         an error by the linter. It is also an error if the default
         value of a record declaration uses or binds a variable.<BR>

         *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-5878<BR>

        
</LI>


<LI>
         When a file <CODE>.hrl</CODE> file is included using
         <CODE>-include_lib</CODE>, the include path is temporarily
         updated to include the directory the <CODE>.hrl</CODE> file was
         found in, which will allow that <CODE>.hrl</CODE> file to itself
         include files from the same directory as itself using
         <CODE>-include</CODE>. (Thanks to Richard Carlsson.)<BR>

         Own Id: OTP-5944<BR>


</LI>


<LI>
         Corrected <CODE>filelib:ensure_dir/1</CODE> which sometimes
         returned <CODE>true</CODE> and sometimes <CODE>ok</CODE> to always
         return <CODE>ok</CODE> when successful. This goes against the
         documentation which said <CODE>true</CODE>, but <CODE>ok</CODE> was
         judged to be a more logical return value.<BR>

         *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-5960 Aux Id: seq10240 <BR>


</LI>


<LI>
         The shell now handles records better when used in calls
         on the form <CODE>{Module, Function}(ArgList)</CODE>.<BR>

         Own Id: OTP-5990 Aux Id: OTP-5876 <BR>


</LI>


<LI>
                 The functions <CODE>lists:ukeysort/2</CODE> and
         <CODE>lists:ukeymerge/3</CODE> have been changed in such a way
         that two tuples are considered equal if their keys
         match.<BR>

                 For the sake of consistency, <CODE>lists:usort/2</CODE> and
         <CODE>lists:umerge/3</CODE> have been modified too: two elements
         are considered equal if they compare equal.<BR>

         The <CODE>file_sorter</CODE> module has been modified in a
         similar way: the <CODE>unique</CODE> option now applies to the
         key (<CODE>keysort()</CODE> and <CODE>keymerge()</CODE>) and the
         ordering function (the option <CODE>{order, Order} </CODE>).<BR>

         *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-6019<BR>


</LI>


<LI>
         Correction in documentation for
         <CODE>ets:update_counter/3</CODE>; failure with <CODE>badarg</CODE>
         also if the counter to be updated is the key.<BR>

         Own Id: OTP-6072<BR>


</LI>


<LI>
                 When sorting terms using the <CODE>file_sorter</CODE> module
         and an ordering fun, the sort was not always stable. This
         bug has been fixed.<BR>

         Own Id: OTP-6088<BR>


</LI>


</UL>
<A NAME="1.3.2"><!-- Empty --></A>
<H4>1.3.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
                 Improvements of the linter:<BR>

         
<UL>

<LI>
         The <CODE>compile</CODE> attribute is recognized after
                function definitions.<BR>

         
</LI>


<LI>
         The new compiler option
                <CODE>nowarn_deprecated_function</CODE> can be used for
                turning off warnings for calls to deprecated functions.
         <BR>

         
</LI>


<LI>
         The new compiler option
                <CODE>{nowarn_unused_function,[{Name,Arity}]}</CODE> turns off
                warnings for unused local functions for the mentioned
                functions. The new options
                <CODE>{nowarn_deprecated_function,[{Module,Name,Arity}]}</CODE>
                and <CODE>{nowarn_bif_clash,[{Name,Arity}]}</CODE> work
                similarly.<BR>

         
</LI>


</UL>

                 The Erlang code preprocessor <CODE>epp</CODE> now recognizes
         the <CODE>file</CODE> attribute. This attribute is meant to be
         used by tools such as Yecc that generate source code
         files.<BR>

         Own Id: OTP-5362<BR>


</LI>


<LI>
         The formatting option <CODE>~s</CODE> of <CODE>io:fwrite</CODE> and
         <CODE>io_lib:fwrite</CODE> has been extended to handle arguments
         that are binaries or I/O lists.<BR>

         Own Id: OTP-5403<BR>


</LI>


<LI>
         The control sequences <CODE>p</CODE> and <CODE>P</CODE> of the
         <CODE>Format</CODE> argument of the functions
         <CODE>io:format/2,3</CODE> and <CODE>io_lib:format/2</CODE> have been
         changed as to display the contents of binaries containing
         printable characters as strings.<BR>

         Own Id: OTP-5485<BR>


</LI>


<LI>
         The linter emits warnings for functions exported more
         than once in <CODE>export</CODE> attributes.<BR>

         Own Id: OTP-5494<BR>


</LI>


<LI>
         A manual for STDLIB has been added, <CODE>stdlib(6)</CODE>. It
         mentions the configuration parameters for the Erlang
         shell.<BR>

         Own Id: OTP-5530<BR>


</LI>


<LI>
         Added the <CODE>zip</CODE> module with functions for reading
         and creating zip archives. See <CODE>zip(3)</CODE>.<BR>

         Own Id: OTP-5786<BR>


</LI>


<LI>
         Simple-one-for-one supervisors now store the pids of
         child processes using <CODE>dict</CODE> instead of a list. This
         significantly improves performance when there are many
         dynamic supervised child processes. (Thanks to Mickal
         Rmond et al.)<BR>

         Own Id: OTP-5898<BR>


</LI>


<LI>
                 When given the new option '<CODE>strict_record_tests</CODE>',
         the compiler will generate code that verifies the record
         type for '<CODE>R#record.field</CODE>' operations in guards. Code
         that verifies record types in bodies has already been
         generated since R10B, but in this release there will be a
         '<CODE>{badrecord,RecordTag}</CODE>' instead of a
         '<CODE>badmatch</CODE>' if the record verification test fails.
         See the documentation for the <CODE>compile</CODE> module for
         more information.<BR>

                 The Erlang shell always applies strict record tests.<BR>

         Own Id: OTP-5915 Aux Id: OTP-5714 <BR>


</LI>


<LI>
                 The Erlang pretty printer (<CODE>erl_pp</CODE>) now tries to
         insert line breaks at appropriate places.<BR>

         Own Id: OTP-5924<BR>


</LI>


<LI>
         The <CODE>public</CODE> option has been removed from
         <CODE>digraph:new/1</CODE>. The reason is that several
         functions in the <CODE>digraph</CODE> module are implemented
         using multiple ETS accesses, which is not thread safe.
         (Thanks to Ulf Wiger.)<BR>

         *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-5985<BR>


</LI>


<LI>
         The function <CODE>lists:keyreplace/4</CODE> checks that the
         fourth argument (<CODE>NewTuple</CODE>) is a tuple.<BR>

         Own Id: OTP-6023<BR>


</LI>


<LI>
         Added an example of how to reconstruct source code from
         debug info (abstract code) to <CODE>beam_lib(3)</CODE>. (Thanks
         to Mats Cronqvist who wrote the example.)<BR>

         Own Id: OTP-6073<BR>


</LI>


<LI>
  The new compiler option <CODE>warn_unused_record</CODE> is used
         for finding unused locally defined record types.<BR>

         Own Id: OTP-6105<BR>


</LI>


</UL>
<A NAME="1.4"><!-- Empty --></A>
<H3>1.4 STDLIB 1.13.12</H3>
<A NAME="1.4.1"><!-- Empty --></A>
<H4>1.4.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         <CODE>shell_default:xm/1</CODE> has been added. It calls
         <CODE>xref:m/1</CODE>.<BR>

         Own Id: OTP-5405 Aux Id: OTP-4101 <BR>


</LI>


<LI>
          Warnings are output whenever so far undeclared records are
         referenced from some default value of a record
         declaration. In STDLIB 1.14 (R11B) such forward references
         will cause a compilation error.<BR>

         Own Id: OTP-5878<BR>


</LI>


<LI>
         The linter's check of the <CODE>deprecated</CODE> attribute did
         not take the compile option <CODE>export_all</CODE> into
         account. This bug has been fixed.<BR>

         Own Id: OTP-5917<BR>


</LI>


<LI>
         The Erlang pretty printer did not handle <CODE>try/catch</CODE>
         correctly. This bug has been fixed.<BR>

         Own Id: OTP-5926
<BR>

</LI>


<LI>
         Corrected documentation for <CODE>lists:nthtail/3</CODE>.<BR>

         Added documentation for <CODE>lists:keymap/3</CODE>.<BR>

         Tried to clarify some other type declarations and
         function descriptions in <CODE>lists(3)</CODE>.<BR>

         Corrected documentation for <CODE>timer:now_diff/2</CODE>.<BR>

         Fixed broken links in <CODE>gen_fsm(3)</CODE>,
         <CODE>gen_server(3)</CODE>, <CODE>io_lib(3)</CODE> and <CODE>lib(3)</CODE>.
         <BR>

         Own Id: OTP-5931<BR>


</LI>


<LI>
         Type checks have been added to functions in
         <CODE>lists.erl</CODE>.<BR>

         Own Id: OTP-5939<BR>


</LI>


</UL>
<A NAME="1.4.2"><!-- Empty --></A>
<H4>1.4.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
         The new STDLIB module <CODE>erl_expand_records</CODE> expands
         records in abstract code. It is used by the Erlang shell,
         which means that Compiler is no longer used by the shell.
         <BR>

         Own Id: OTP-5876 Aux Id: OTP-5435 <BR>


</LI>


<LI>
         The compiler will now warn that the
         <CODE>megaco:format_versions/1</CODE> function is deprecated.<BR>

         Own Id: OTP-5976<BR>


</LI>


</UL>
<A NAME="1.5"><!-- Empty --></A>
<H3>1.5 STDLIB 1.13.11</H3>
<A NAME="1.5.1"><!-- Empty --></A>
<H4>1.5.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         When calling <CODE>gen_server:enter_loop</CODE> with a
         registered server name, it was only checked that the
         registered name existed, not that it actually was the
         name of the calling process.<BR>

         Own Id: OTP-5854<BR>


</LI>


</UL>
<A NAME="1.5.2"><!-- Empty --></A>
<H4>1.5.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
         More detail on <CODE>beam_lib:version/1</CODE> in
         documentation.<BR>

         Own Id: OTP-5789<BR>


</LI>


<LI>
         The new function <CODE>io:read/3</CODE> works like
         <CODE>io:read/1,2</CODE> but takes a third argument,
         <CODE>StartLine</CODE>.<BR>

         Own Id: OTP-5813<BR>


</LI>


<LI>
         The new function <CODE>gen_fsm:enter_loop/4,5,6</CODE>, similar
         to <CODE>gen_server:enter_loop/3,4,5</CODE>, has been added.<BR>

         Own Id: OTP-5846 Aux Id: seq10163 <BR>


</LI>


<LI>
         The function <CODE>c:i/1</CODE> is now exported.<BR>

         Own Id: OTP-5848 Aux Id: seq10164 <BR>


</LI>


</UL>
<A NAME="1.6"><!-- Empty --></A>
<H3>1.6 STDLIB 1.13.10</H3>
<A NAME="1.6.1"><!-- Empty --></A>
<H4>1.6.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         A couple of type errors have been fixed in <CODE>sofs</CODE>.<BR>

         Own Id: OTP-5739<BR>


</LI>


<LI>
                 The pre-processor used to complain that the macro
         definition '<CODE>-define(S(S), ??S).</CODE>' was circular,
         which it isn't. (Thanks to Richard Carlsson.)<BR>

         Own Id: OTP-5777<BR>


</LI>


</UL>
<A NAME="1.7"><!-- Empty --></A>
<H3>1.7 STDLIB 1.13.9</H3>
<A NAME="1.7.1"><!-- Empty --></A>
<H4>1.7.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         The linter, QLC and the module <CODE>erl_pp</CODE> did not
         handle the new '<CODE>fun M:F/A</CODE>' construct in all
         situations. This problem has been fixed.<BR>

         Own Id: OTP-5644<BR>


</LI>


</UL>
<A NAME="1.7.2"><!-- Empty --></A>
<H4>1.7.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
                 The manual pages for most of the Kernel and some of
         the STDLIB modules have been updated, in particular
         regarding type definitions.<BR>

                 The documentation of the return value for
         <CODE>erts:info/1</CODE> has been corrected.<BR>

                 The documentation for <CODE>erlang:statistics/1</CODE> now
         lists all possible arguments.<BR>

         Own Id: OTP-5360<BR>


</LI>


<LI>
                 Replaced some tuple funs with the new <CODE>fun M:F/A</CODE>
         construct.<BR>

                 The high-order functions in the lists module no longer
         accept bad funs under any circumstances.
         '<CODE>lists:map(bad_fun, [])</CODE>' used to return
         '<CODE>[]</CODE>' but now causes an exception.<BR>

                 Unused, broken compatibility code in the <CODE>ets</CODE>
         module was removed. (Thanks to Dialyzer.)<BR>

                 Eliminated 5 discrepancies found by Dialyzer in the
         Appmon application.<BR>

         Own Id: OTP-5633<BR>


</LI>


<LI>
                 The <CODE>c:i/0</CODE> function will now run in a paged mode if
         there are more than 100 processes in the system. (Thanks
         to Ulf Wiger.)<BR>

                 <CODE>erlang:system_info(process_count)</CODE> has been
         optimized and does now return exactly the same value as
         <CODE>length(processes())</CODE>. Previously
         <CODE>erlang:system_info(process_count)</CODE> did not include
         exiting processes which are included in
         <CODE>length(processes())</CODE>.<BR>

                 The <CODE>+P</CODE> flag for <CODE>erl</CODE>, which sets the maximum
         number of processes allowed to exist at the same, no longer
         accepts values higher than 134217727. (You will still
         probably run out of memory before you'll be able to reach
         that limit.)<BR>

         Own Id: OTP-5645 Aux Id: seq9984 <BR>


</LI>


</UL>
<A NAME="1.8"><!-- Empty --></A>
<H3>1.8 STDLIB 1.13.8</H3>
<A NAME="1.8.1"><!-- Empty --></A>
<H4>1.8.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  Very minor corrections in <CODE>beam_lib</CODE> and its
         documentation.<BR>

 Own Id: OTP-5589<BR>


</LI>


</UL>
<A NAME="1.8.2"><!-- Empty --></A>
<H4>1.8.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
                 The <CODE>erlang:port_info/1</CODE> BIF is now documented.
         Minor corrections of the documentation for
         <CODE>erlang:port_info/2</CODE>.<BR>

                 Added a note to the documentation of the <CODE>math</CODE>
module that all functions are not available on all
platforms.<BR>

                 Added more information about the '<CODE>+c</CODE>' option in
         the <CODE>erl</CODE> man page in the ERTS documentation.<BR>

 Own Id: OTP-5555<BR>


</LI>


<LI>
                 The new <CODE>fun M:F/A</CODE> construct creates a fun that
refers to the latest version of <CODE>M:F/A</CODE>. This syntax is
meant to replace tuple funs <CODE>{M,F}</CODE> which have many
problems.<BR>

                 The new type test <CODE>is_function(Fun,A)</CODE> (which may be
used in guards) test whether <CODE>Fun</CODE> is a fun that can be
applied with <CODE>A</CODE> arguments. (Currently, <CODE>Fun</CODE> can
         also be a tuple fun.)<BR>

 Own Id: OTP-5584<BR>


</LI>


</UL>
<A NAME="1.9"><!-- Empty --></A>
<H3>1.9 STDLIB 1.13.7</H3>
<A NAME="1.9.1"><!-- Empty --></A>
<H4>1.9.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  <CODE>filelib:wildcard/2</CODE> was broken (it ignored its
second argument).<BR>

                 Also, <CODE>filelib:wildcard(&#34;Filename&#34;)</CODE> (where the
argument does not contain any meta-characters) would
always return <CODE>[&#34;Filename&#34;]</CODE>. Corrected so that an
empty list will be returned if <CODE>&#34;Filename&#34;</CODE> does not
actually exist. (Same correction in
<CODE>filelib:wildcard/2</CODE>.) (This change is a slight
incompatibility.)<BR>

                 <CODE>filelib:wildcard/1,2</CODE> will generate a different
exception when given bad patterns such as <CODE>&#34;{a,&#34;</CODE>. The
exception used to be caused by
'<CODE>exit(missing_delimiter)</CODE>' but is now
'<CODE>erlang:error({badpattern,missing_delimiter})</CODE>'.<BR>

 Own Id: OTP-5523 Aux Id: seq9824 <BR>


</LI>


</UL>
<A NAME="1.9.2"><!-- Empty --></A>
<H4>1.9.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
  Further improvements of encrypted debug info: New option
<CODE>encrypt_debug_info</CODE> for compiler.<BR>

 Own Id: OTP-5541 Aux Id: seq9837 <BR>


</LI>


</UL>
<A NAME="1.10"><!-- Empty --></A>
<H3>1.10 STDLIB 1.13.6</H3>
<A NAME="1.10.1"><!-- Empty --></A>
<H4>1.10.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  When opening a Dets table read only an attempt was
sometimes made to re-hash the table resulting in an error
message. This problem has been fixed.<BR>

 Own Id: OTP-5487 Aux Id: OTP-4989 <BR>


</LI>


</UL>
<A NAME="1.10.2"><!-- Empty --></A>
<H4>1.10.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
                 It is now possible to encrypt the debug information in
Beam files, to help keep the source code secret. See the
documentation for <CODE>compile</CODE> on how to provide the key
         for encrypting, and the documentation for <CODE>beam_lib</CODE>
         on how to provide the key for decryption so that tools such
         as the Debugger, <CODE>xref</CODE>, or <CODE>cover</CODE> can be used.
         <BR>

                 The <CODE>beam_lib:chunks/2</CODE> functions now accepts an
additional chunk type <CODE>compile_info</CODE> to retrieve
the compilation information directly as a term. (Thanks
to Tobias Lindahl.)<BR>

 Own Id: OTP-5460 Aux Id: seq9787 <BR>


</LI>


</UL>
<A NAME="1.11"><!-- Empty --></A>
<H3>1.11 STDLIB 1.13.5</H3>
<A NAME="1.11.1"><!-- Empty --></A>
<H4>1.11.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  Closing a Dets table kept in RAM would cause a crash if
the file could not be written. This problem has been
fixed by returning an error tuple.<BR>

 Own Id: OTP-5402<BR>


</LI>


<LI>
  <CODE>erl_pp</CODE> now correctly pretty-prints <CODE>fun F/A</CODE>.
         <BR>

 Own Id: OTP-5412<BR>


</LI>


<LI>
  The Erlang shell failed if the compiler was not in the
code path. This problem has been fixed, but in order to
evaluate records the compiler is still needed.<BR>

 Own Id: OTP-5435<BR>


</LI>


<LI>
  Corrected the example in the documentation for
<CODE>ets:match/2</CODE>. Also clarified that
         <CODE>ets:update_counter/3</CODE> updates the counter atomically.
         (Thanks to Anders Svensson.)<BR>

 Own Id: OTP-5452 Aux Id: seq9770, seq9789 <BR>


</LI>


</UL>
<A NAME="1.11.2"><!-- Empty --></A>
<H4>1.11.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
  The possibility to start the Erlang shell in parallel
with the rest of the system was reintroduced for
backwards compatibility in STDLIB 1.13.1. The flag to be
used for this is now called <CODE>async_shell_start</CODE> and has
been documented. New shells started from the JCL menu are
not syncronized with <CODE>init</CODE> anymore. This makes it
         possible to start a new shell (e.g. for debugging purposes)
         even if the initial shell has not come up.<BR>

 Own Id: OTP-5406 Aux Id: OTP-5218 <BR>


</LI>


<LI>
  The compiler will now produce warnings when using the
deprecated functions in the <CODE>snmp</CODE> module.<BR>

 Own Id: OTP-5425
<BR>

</LI>


<LI>
  The function <CODE>c:zi/0</CODE> has been removed. Use
         <CODE>c:i/0</CODE> instead.<BR>

 Own Id: OTP-5432<BR>


</LI>


<LI>
                 Corrected two minor bugs found by the Dialyzer:
Calling a parameterized module from a restricted shell
(i.e. if <CODE>shell:start_restricted/1</CODE> has been used)
         would crash the shell evaluator. A debug printout in
         <CODE>gen_fsm</CODE> had a clause that would never match; causing
         less information to be printed.<BR>

                 And a somewhat more serious one also found by
Dialyzer: <CODE>rpc:yield/1</CODE> would crash unless the call
         started by <CODE>rpc:async_call/4</CODE> had already finished;
<CODE>rpc:nb_yield(Key,infinity)</CODE> would also crash.<BR>

                 Cleaned up and removed redundant code found by
Dialyzer in <CODE>erlang:dmonitor_p/2</CODE>.<BR>

 Own Id: OTP-5462<BR>


</LI>


</UL>
<A NAME="1.12"><!-- Empty --></A>
<H3>1.12 STDLIB 1.13.4</H3>
<A NAME="1.12.1"><!-- Empty --></A>
<H4>1.12.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  Bugs in the Erlang shell have been fixed.<BR>

 Own Id: OTP-5327<BR>


</LI>


<LI>
  Some dead code reported by Dialyzer was eliminated.<BR>

                 A bug in <CODE>dbg</CODE> when tracing to wrap trace files has
         been corrected. It failed to delete any already existing
         wrap trace files with the same names when starting a new
         wrap trace.<BR>

 Own Id: OTP-5329<BR>


</LI>


<LI>
  The linter could output invalid warnings about bit
patterns in record initializations. This problem has been
fixed.<BR>

 Own Id: OTP-5338<BR>


</LI>


<LI>
  <CODE>ordsets:is_set(NoList)</CODE>, where <CODE>NoList</CODE> is any
         term except a list, would crash. For consistency with
<CODE>sets:is_set/1</CODE> and <CODE>gb_sets:is_set/1</CODE>, it now
returns <CODE>false</CODE>.<BR>

 Own Id: OTP-5341<BR>


</LI>


<LI>
  A BIF <CODE>erlang:raise/3</CODE> has been added. See the manual
         for details. It is intended for internal system programming
only, advanced error handling.<BR>

 Own Id: OTP-5376 Aux Id: OTP-5257 <BR>


</LI>


</UL>
<A NAME="1.12.2"><!-- Empty --></A>
<H4>1.12.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
  The <CODE>deprecated</CODE> attribute is now checked by the
linter. See <CODE>xref(3)</CODE> for a description of the
<CODE>deprecated</CODE> attribute.<BR>

 Own Id: OTP-5276<BR>


</LI>


<LI>
  The restricted shell will now indicate if the return
value from a user predicate is on an incorrect form.<BR>

 Own Id: OTP-5335<BR>


</LI>


</UL>
<A NAME="1.13"><!-- Empty --></A>
<H3>1.13 STDLIB 1.13.3</H3>
<A NAME="1.13.1"><!-- Empty --></A>
<H4>1.13.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         Bugs concerning unused and shadowed variables have been
         fixed in the linter.<BR>

         Own Id: OTP-5091<BR>


</LI>


<LI>
         A bug in the evaluator that caused the shell to choke on
         bit syntax expressions has been fixed.<BR>

         Own Id: OTP-5237<BR>


</LI>


<LI>
         <CODE>io:format/2</CODE> et.al no longer crashes for some
         combinations of precision and value for format character
         &#34;g&#34;. Previously it crashed if the precision P was 4 or lower
         and the absolute value of the float to print was lower
         than 10^4 but 10^(P-1) or higher. Now it will not crash
         depending on the value of the float.<BR>

         Own Id: OTP-5263<BR>


</LI>


<LI>
         Bugs in the handling of the bit syntax have been fixed in
         the Erlang shell.<BR>

         Own Id: OTP-5269<BR>


</LI>


<LI>
                 <CODE>gb_sets:del_element/2</CODE> was changed to do the
         same as <CODE>gb_sets:delete_any/2</CODE> which was the
         original intention, not as <CODE>gb_sets:delete/2</CODE>. Code
         that relies on <CODE>gb_sets:del_element/2</CODE> causing an
         error if the element does not exist must be changed to
         call <CODE>gb_sets:delete/2</CODE> instead.<BR>

                 The documentation was also updated to explicitly
         document functions that were only referred to as
         'aliases' of a documented function. Also, a list of all
         functions common to the <CODE>gb_sets</CODE>, <CODE>sets</CODE>, and
         <CODE>ordsets</CODE> was added.<BR>

                 *** POTENTIAL INCOMPATIBILITY ***<BR>

         Own Id: OTP-5277<BR>


</LI>


<LI>
         Debug messages have been removed from the QLC module.<BR>

         Own Id: OTP-5283<BR>


</LI>


</UL>
<A NAME="1.13.2"><!-- Empty --></A>
<H4>1.13.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
         The size of continuations returned from
         <CODE>dets:match/1,3</CODE>, <CODE>dets:match_object/1,3</CODE>, and
         <CODE>dets:select/1,3</CODE> has been reduced. This affects the
         amount of data Mnesia sends between nodes while
         evaluating QLC queries.<BR>

         Own Id: OTP-5232<BR>


</LI>


</UL>
<A NAME="1.14"><!-- Empty --></A>
<H3>1.14 STDLIB 1.13.2</H3>
<A NAME="1.14.1"><!-- Empty --></A>
<H4>1.14.1 Improvements and New Features</H4>

<P>
<UL>

<LI>
  The <CODE>-rsh</CODE> switch for starting a remote shell
         (introduced with OTP-5210) clashed with an already existing
         switch used by <CODE>slave</CODE>. Therefore the switch for
         the remote shell is now instead named <CODE>-remsh</CODE>.<BR>

 Own Id: OTP-5248 Aux Id: OTP-5210 <BR>


</LI>


</UL>
<A NAME="1.15"><!-- Empty --></A>
<H3>1.15 STDLIB 1.13.1</H3>
<A NAME="1.15.1"><!-- Empty --></A>
<H4>1.15.1 Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
  The Pman 'trace shell' functionality was broken as has
now been fixed. Furthermore, Pman could not correctly
find the pid of the active shell if more than one shell
process was running on the node. This has also been
corrected.<BR>

 Own Id: OTP-5191<BR>


</LI>


<LI>
  When the undocumented feature &#34;parameterized modules&#34; was
used, the ?MODULE macro did not work correctly.<BR>

 Own Id: OTP-5224<BR>


</LI>


</UL>
<A NAME="1.15.2"><!-- Empty --></A>
<H4>1.15.2 Improvements and New Features</H4>

<P>
<UL>

<LI>
  You can now start Erlang with the <CODE>-rsh</CODE> flag which
         gives you a remote initial shell instead of a local one.
Example:<BR>

         
<PRE>
            erl -sname this_node -rsh other_node@other_host
          
</PRE>

 Own Id: OTP-5210<BR>


</LI>


<LI>
  The man page for the <CODE>lists</CODE> module has been updated
with decscription of the new <CODE>zip</CODE>, <CODE>unzip</CODE>,
and <CODE>partition/2</CODE> functions.<BR>

 Own Id: OTP-5213<BR>


</LI>


<LI>
  The top level group leader used to be listed as job #1 in
the job list in JCL mode. Since there is no shell
associated with this process that can be connected to, it
will no longer be listed.<BR>

 Own Id: OTP-5214<BR>


</LI>


<LI>
  The possibility to start the Erlang shell in parallel
with the rest of the system has been reintroduced for
backwards compatibility. Note that this old behaviour is
error prone and should not be used unless for some reason
necessary.<BR>

 Own Id: OTP-5218 Aux Id: seq9534 <BR>


</LI>


<LI>
  The <CODE>shell</CODE> commands <CODE>rr/1,2,3</CODE> now accepts
wildcards when reading record definitions from BEAM
files.<BR>

 Own Id: OTP-5226<BR>


</LI>


</UL>
<CENTER>
<HR>
<SMALL>
Copyright &copy; 1991-2006
<A HREF="http://www.erlang.se">Ericsson AB</A><BR>
</SMALL>
</CENTER>
</BODY>
</HTML>