path: root/lib/tools/doc/src/notes.xml

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">

<chapter>
  <header>
    <copyright>
      <year>2004</year><year>2017</year>
      <holder>Ericsson AB. All Rights Reserved.</holder>
    </copyright>
    <legalnotice>
      Licensed under the Apache License, Version 2.0 (the "License");
      you may not use this file except in compliance with the License.
      You may obtain a copy of the License at
 
          http://www.apache.org/licenses/LICENSE-2.0

      Unless required by applicable law or agreed to in writing, software
      distributed under the License is distributed on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
      See the License for the specific language governing permissions and
      limitations under the License.

    </legalnotice>

    <title>Tools Release Notes</title>
    <prepared></prepared>
    <docno></docno>
    <date></date>
    <rev></rev>
    <file>notes.xml</file>
  </header>
  <p>This document describes the changes made to the Tools application.</p>

<section><title>Tools 3.0</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Added <c>instrument:allocations</c> and
	    <c>instrument:carriers</c> for retrieving information
	    about memory utilization and fragmentation.</p>
	    <p>The old <c>instrument</c> interface has been removed,
	    as have the related options <c>+Mim</c> and
	    <c>+Mis</c>.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-14961</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.11.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p> A counting bug is corrected in <c>Cover</c>. The bug
	    was introduced in Erlang/OTP 18.0. </p>
          <p>
	    Own Id: OTP-14817 Aux Id: PR 1641 </p>
        </item>
        <item>
	    <p>The <c>lcnt</c> server will no longer crash if
	    <c>lcnt:information/0</c> is called before
	    <c>lcnt:collect/0</c>.</p>
          <p>
	    Own Id: OTP-14912</p>
        </item>
        <item>
	    <p><c>lcnt:collect</c> will now implicitly start the
	    <c>lcnt</c> server, as per the documentation.</p>
          <p>
	    Own Id: OTP-14913</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Improved indentation in emacs and various other updates.</p>
          <p>
	    Own Id: OTP-14944</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.11.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p> Removed all old unused files in the documentation.
	    </p>
          <p>
	    Own Id: OTP-14475 Aux Id: ERL-409, PR-1493 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.11</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p> The predefined Xref analysis <c>locals_not_used</c>
	    no longer reports unused functions with the
	    <c>-on_load()</c> attribute.</p> <p> The new predefined
	    Xref variable <c>OL</c> holds all functions with the
	    <c>-on_load()</c> attribute. </p>
          <p>
	    Own Id: OTP-14344</p>
        </item>
        <item>
          <p>
	    In fprof when sampling multiple processes and analyzing
	    with totals set to true, the output now sums together all
	    caller and callee entries which concerns the same
	    function. Previous behaviour was to report each
	    contributing entry separately.</p>
          <p>
	    Own Id: OTP-14500</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Lock counting can now be fully toggled at runtime in
	    the lock counting emulator (<c>-emu_type lcnt</c>).
	    Everything is enabled by default to match the old
	    behavior, but specific categories can be toggled at will
	    with minimal runtime overhead when disabled. Refer to the
	    documentation on <c>lcnt:rt_mask/1</c> for details.</p>
          <p>
	    Own Id: OTP-13170</p>
        </item>
        <item>
	    <p><c>lcnt:collect</c> and <c>lcnt:clear</c> will no
	    longer block all other threads in the runtime system.</p>
          <p>
	    Own Id: OTP-14412</p>
        </item>
        <item>
          <p>
	    General Unicode improvements.</p>
          <p>
	    Own Id: OTP-14462</p>
        </item>
        <item>
          <p>
	    Tools are updated to show Unicode atoms correctly.</p>
          <p>
	    Own Id: OTP-14464</p>
        </item>
        <item>
	    <p>Add <c>erlang:iolist_to_iovec/1</c>, which converts an
	    iolist() to an erlang:iovec(), which suitable for use
	    with <c>enif_inspect_iovec</c>.</p>
          <p>
	    Own Id: OTP-14520</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.10.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    In OTP-20.0, the behavior of c, make, and ct_make was
	    changed so that in some cases the beam files by default
	    would be written to the directory where the source files
	    were found. This is now changed back to the old behavior
	    so beam files are by default written to current
	    directory.</p>
          <p>
	    Own Id: OTP-14489 Aux Id: ERL-438 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.10</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    In some situations, <c>make:all()</c> and friends did not
	    detect changes in include files located in the current
	    directory. This is now corrected.</p>
          <p>
	    Own Id: OTP-14339 Aux Id: ERL-395 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>The <c>make</c> module now accepts the
	    <c>{emake,Emake}</c> option.</p>
          <p>
	    Own Id: OTP-14253</p>
        </item>
        <item>
	    <p> Miscellaneous updates due to atoms containing
	    arbitrary Unicode characters. </p>
          <p>
	    Own Id: OTP-14285</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.9.1</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Improved edoc support in emacs mode.</p>
          <p>
	    Own Id: OTP-14217 Aux Id: PR-1282 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.9</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fix unhandled trace event send_to_non_existing_process in
	    fprof.</p>
          <p>
	    Own Id: OTP-13998</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Improved edoc support in emacs erlang-mode.</p>
          <p>
	    Own Id: OTP-13945 Aux Id: PR-1157 </p>
        </item>
        <item>
          <p>
	    Added erldoc to emacs mode which opens html documentation
	    in browser from emacs. For example <c>M-x erldoc-browse
	    RET lists:foreach/2</c>.</p>
          <p>
	    Own Id: OTP-14018 Aux Id: PR-1197 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Errors in type specification and Emacs template
	    generation for <c>gen_statem:code_change/4</c> has been
	    fixed from bugs.erlang.org's Jira cases ERL-172 and
	    ERL-187.</p>
          <p>
	    Own Id: OTP-13746 Aux Id: ERL-172, ERL-187 </p>
        </item>
        <item>
          <p>
	    Fix gc_start/gc_end in fprof tags when parsing old trace
	    logs.</p>
          <p>
	    Own Id: OTP-13778 Aux Id: PR-1136 </p>
        </item>
        <item>
	    <p><c>make</c> (tools) and <c>ct_make</c> (common_test)
	    would crash if an Erlang source file contained a
	    <c>-warning()</c> directive.</p>
          <p>
	    Own Id: OTP-13855</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.5</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>Correct a bug when adding multiple modules to an Xref
	    server. The bug was introduced in OTP-19.0. </p>
          <p>
	    Own Id: OTP-13708 Aux Id: ERL-173 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Update fprof to use the new 'spawned' trace event to
	    determine when a process has been created.</p>
          <p>
	    Own Id: OTP-13499</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Optimize adding multiple modules to an Xref server.
	    </p>
          <p>
	    Own Id: OTP-13593</p>
        </item>
        <item>
          <p>
	    Various emacs mode improvements, such as better tags
	    support.</p>
          <p>
	    Own Id: OTP-13610</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    <c>cover:compile_beam/1</c> and
	    <c>cover:compile_beam_directory/1,2</c> crashed when
	    trying to compile a beam file without a <c>'file'</c>
	    attribute. This has been corrected and an error is
	    returned instead.</p>
          <p>
	    Thanks to Louis-Philippe Gauthier for reporting this bug.</p>
          <p>
	    Own Id: OTP-13200</p>
        </item>
        <item>
	    <p>Fix a bit string comprehension bug in Cover. </p>
          <p>
	    Own Id: OTP-13277 Aux Id: PR 856 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The emacs mode does not add a newline after the arrow on
	    -callback lines anymore.</p>
          <p>
	    Own Id: OTP-13042</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    If a module includes eunit.hrl, a parse transform adds
	    the function test/0 on line 0 in the module. A bug in
	    OTP-18.0 caused cover:analyse_to_file/1 to fail to insert
	    cover data in the output file when line 0 existed in the
	    cover data table. This is now corrected.</p>
          <p>
	    Own Id: OTP-12981</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.8</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    In order to improve performance of the cover tool, new
	    functions are added for cover compilation and analysis on
	    multiple files. This allows for more parallelisation.</p>
          <p>
	    Some improvements of the data base access is also done in
	    order to improve the performance when analysing and
	    resetting cover data.</p>
          <p>
	    Minor incompatibility: An error reason from
	    analyse_to_file is changed from no_source_code_found to
	    {no_source_code_found,Module}.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-12330 Aux Id: seq12757 </p>
        </item>
        <item>
	    <p>Attempting to do a <c>cover</c> analysis when neither
	    source code nor beam file could be found would hang the
	    <c>cover</c> server. Corrected to return a proper
	    error.</p>
          <p>
	    Own Id: OTP-12806</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Allow maps for supervisor flags and child specs</p>
          <p>
	    Earlier, supervisor flags and child specs were given as
	    tuples. While this is kept for backwards compatibility,
	    it is now also allowed to give these parameters as maps,
	    see <seealso
	    marker="stdlib:supervisor#sup_flags">sup_flags</seealso>
	    and <seealso
	    marker="stdlib:supervisor#child_spec">child_spec</seealso>.</p>
          <p>
	    Own Id: OTP-11043</p>
        </item>
        <item>
          <p>
	    Remove Mnemosyne rules support.</p>
          <p>
	    Own Id: OTP-12511</p>
        </item>
        <item>
          <p>
	    Add printout of total number of calls and time in eprof</p>
          <p>
	    Own Id: OTP-12681</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.7.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fix lcnt sorting and printout of histograms.</p>
          <p>
	    Own Id: OTP-12364</p>
        </item>
        <item>
	    <p> Fix a Unicode bug in the <c>tags</c> module. </p>
          <p>
	    Own Id: OTP-12567</p>
        </item>
        <item>
          <p>
	    Fix tags completion in erlang.el for GNU Emacs 23+</p>
          <p>
	    Own Id: OTP-12583</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.7.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fixed a typo in erlang-mode comment.</p>
          <p>
	    Own Id: OTP-12214</p>
        </item>
        <item>
          <p>
	    Add a skeleton for -spec in Erlang mode for Emacs</p>
          <p>
	    Own Id: OTP-12283</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Cover no longer crashes when compiling <c>receive</c> and
	    the like with just an <c>after</c> clause. Thanks to
	    José Valim for providing a fix.</p>
          <p>
	    Own Id: OTP-12328</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.7</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Add log2 histogram to lcnt for lock wait time</p>
          <p>
	    Own Id: OTP-12059</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.15</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Removed <c>erlang:bitstr_to_list/1</c> and
	    <c>erlang:list_to_bitstr/1</c>. They were added by
	    mistake, and have always raised an <c>undefined</c>
	    exception when called.</p>
          <p>
	    Own Id: OTP-11942</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.14</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Removed the support for the query keyword from emacs mode
	    (Thanks to Paul Oliver)</p>
          <p>
	    Own Id: OTP-11568</p>
        </item>
        <item>
          <p>
	    Emacs mode improvements (Thanks to Steve Vinoski)</p>
          <p>
	    Own Id: OTP-11601</p>
        </item>
        <item>
          <p>
	    Application upgrade (appup) files are corrected for the
	    following applications: </p>
          <p>
	    <c>asn1, common_test, compiler, crypto, debugger,
	    dialyzer, edoc, eldap, erl_docgen, et, eunit, gs, hipe,
	    inets, observer, odbc, os_mon, otp_mibs, parsetools,
	    percept, public_key, reltool, runtime_tools, ssh,
	    syntax_tools, test_server, tools, typer, webtool, wx,
	    xmerl</c></p>
          <p>
	    A new test utility for testing appup files is added to
	    test_server. This is now used by most applications in
	    OTP.</p>
          <p>
	    (Thanks to Tobias Schlager)</p>
          <p>
	    Own Id: OTP-11744</p>
        </item>
        <item>
          <p>
	    The emacs erlang mode now match erlang keywords more
	    carefully (Thanks to Steve Vinoski)</p>
          <p>
	    Own Id: OTP-11786</p>
        </item>
        <item>
          <p>
	    The emacs erlang-mode now auto loads for more file types
	    (Thanks to Phil Hagelberg)</p>
          <p>
	    Own Id: OTP-11788</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    <c>cover</c> can run on itself. Also, support for reading
	    BEAM files produced by ancient OTP versions before R9C
	    has been removed.</p>
          <p>
	    Own Id: OTP-11692</p>
        </item>
        <item>
          <p>
	    Support maps in cover</p>
          <p>
	    Own Id: OTP-11764</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.13</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Erlang-specific compilation error regexp is added in
	    erlang-eunit.el. This defvar was earlier in erlang.el,
	    but was erroneously removed in R15B02, while still used
	    by erlang-eunit.el.</p>
          <p>
	    Own Id: OTP-11417 Aux Id: seq12447 </p>
        </item>
        <item>
          <p>
	    Take compiler options from beam in cover:compile_beam.
	    Thanks to Péter Gömöri.</p>
          <p>
	    Own Id: OTP-11439</p>
        </item>
        <item>
          <p>
	    Silence warnings (Thanks to Anthony Ramine)</p>
          <p>
	    Own Id: OTP-11517</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Add iodata, nonempty_string to built-in type highlighting
	    for emacs. Thanks to Paul Oliver.</p>
          <p>
	    Own Id: OTP-11394</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.12</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Remove trailing spaces in Emacs templates. Thanks to
	    Roberto Aloi.</p>
          <p>
	    Own Id: OTP-11198</p>
        </item>
        <item>
          <p>
	    Fixed the Emacs erlang-mode to accommodate the coding
	    style where lists written across several lines have each
	    line starting with a comma. Thanks to Magnus Henoch.</p>
          <p>
	    Own Id: OTP-11242</p>
        </item>
        <item>
          <p>
	    Make the Emacs Erlang mode TRAMP-aware when compiling.
	    Thanks to Tomas Abrahamsson.</p>
          <p>
	    Own Id: OTP-11270</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.11</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    When cover:stop(Node) was called on a non-existing node,
	    a process waiting for cover data from the node would hang
	    forever. This has been corrected.</p>
          <p>
	    Own Id: OTP-10979</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Make cover smarter about finding source from beam.</p>
          <p>
	    In particular, search using the source path in
	    module_info if the current heuristic fails.</p>
          <p>
	    Own Id: OTP-10902</p>
        </item>
        <item>
          <p>
	    Remove Flymake dependency in erlang-pkg.el. Thanks to
	    Magnus Henoch.</p>
          <p>
	    Own Id: OTP-10930</p>
        </item>
        <item>
          <p>
	    Erlang-mode: Add autoload cookies for file extension
	    associations. Thanks to Magnus Henoch.</p>
          <p>
	    Own Id: OTP-10999</p>
        </item>
        <item>
	    <p> Postscript files no longer needed for the generation
	    of PDF files have been removed. </p>
          <p>
	    Own Id: OTP-11016</p>
        </item>
        <item>
          <p>
	    Fix a race condition when there're several applications
	    in apps directory. Thanks to Manuel Rubio.</p>
          <p>
	    Own Id: OTP-11028</p>
        </item>
        <item>
          <p>
	    New option for eprof, 'set_on_spawn'. This option was
	    previously always on and is also the default.</p>
          <p>
	    Own Id: OTP-11144</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.10</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Fix a bug in cover when used with no_auto_import. Thanks
	    to José Valim.</p>
          <p>
	    Own Id: OTP-10778</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.9</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Add missing modules in app-file</p>
          <p>
	    Own Id: OTP-10439</p>
        </item>
        <item>
          <p>
	    Make erlang-mode more compatible with package.el (Thanks
	    to Gleb Peregud)</p>
          <p>
	    Own Id: OTP-10465</p>
        </item>
        <item>
          <p>
	    Fix various typos (thanks to Tuncer Ayaz)</p>
          <p>
	    Own Id: OTP-10611</p>
        </item>
        <item>
          <p>
	    Add separate face for exported functions (Thanks to
	    Thomas Järvstrand)</p>
          <p>
	    Own Id: OTP-10637</p>
        </item>
        <item>
          <p>
	    The BIF highlighting in the emacs mode has been updated
	    to correspond with the correct BIFs.</p>
          <p>
	    Own Id: OTP-10774</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p> Support for Unicode has been implemented. </p>
          <p>
	    Own Id: OTP-10302</p>
        </item>
        <item>
          <p>
	    A new function, cover:flush(Nodes), is added which will
	    fetch data from remote nodes without stopping cover on
	    those nodes. This is used by test_server and common_test
	    when it is safe to assume that the node will be
	    terminated after the test anyway. The purpose is to avoid
	    processes crashing when re-loading the original beam if
	    the processes is still running old code.</p>
          <p>
	    Remote nodes will now continue to count code coverage if
	    the connection to the main node is broken. Earlier, a
	    broken connection would cause the cover_server on the
	    remote node to die and thus any still cover compiled
	    modules would cause process crash when trying to insert
	    cover data in ets tables that used to exist on the
	    cover_server. The new functionality also involves
	    synchronization with the main node if the nodes are
	    reconnected.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-10523 Aux Id: OTP-10427 </p>
        </item>
        <item>
	    <p>Where necessary a comment stating encoding has been
	    added to Erlang files. The comment is meant to be removed
	    in Erlang/OTP R17B when UTF-8 becomes the default
	    encoding. </p>
          <p>
	    Own Id: OTP-10630</p>
        </item>
        <item>
          <p>
	    Fix syntax highlighting of $\' in Emacs mode. Thanks to
	    Magnus Henoch.</p>
          <p>
	    Own Id: OTP-10766</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.8</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The last tuple fun call has been removed from fprof.</p>
          <p>
	    Own Id: OTP-10091 Aux Id: seq12067 </p>
        </item>
        <item>
          <p>
	    Fix indentation of record fields in Emacs (Thanks to
	    Tomas Abrahamsson)</p>
          <p>
	    Own Id: OTP-10120</p>
        </item>
        <item>
          <p>
	    Documentation fixes (Thanks to Ricardo Catalinas Jiménez
	    )</p>
          <p>
	    Own Id: OTP-10121</p>
        </item>
        <item>
          <p>
	    Remove Erlang-specific compilation error regexp in
	    erlang.el</p>
          <p>
	    Own Id: OTP-10168</p>
        </item>
        <item>
          <p>
	    Fix highlighting of atoms ending with a dollar sign</p>
          <p>
	    Like this: 'atom$'. In that example, the last single
	    quote should be recognised as ending the atom. This needs
	    a font-lock workaround similar to the one for strings.
	    Thanks to Magnus Henoch</p>
          <p>
	    Own Id: OTP-10178</p>
        </item>
        <item>
	    <p> Xref now accepts filenames with character codes
	    greater than 126. (Thanks to Emile Joubert for reporting
	    the issue.) </p>
          <p>
	    Own Id: OTP-10192</p>
        </item>
        <item>
          <p>
	    Add test_indentation target to lib/tools/emacs/Makefile</p>
          <p>
	    Automatically indent test.erl.orig, save to test.erl, and
	    compare to test.erl.intended. Thanks to Magnus Henoch.</p>
          <p>
	    Own Id: OTP-10226</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.7</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Makefiles in erts, hipe and tools have been corrected to
	    enable parallel make, i.e MAKEFLAGS=-jX where X is the
	    parallelity number. As a result of this dependencies were
	    corrected since that is what is needed for parallel make
	    to work.</p>
          <p>
	    Own Id: OTP-9857 Aux Id: OTP-9451 </p>
        </item>
        <item>
	    <p>Minor suppressions and fixes of compilation
	    warnings</p>
          <p>
	    Own Id: OTP-10016</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>Update system profiling principles to reflect eprof
	    performance improvements.</p>
          <p>
	    Own Id: OTP-9656</p>
        </item>
        <item>
          <p>
	    [cover] fix leftover {'DOWN', ..} msg in callers queue</p>
          <p>
	    After stopping cover with cover:stop() there could still
	    be a {'DOWN',...} leftover message in the calling
	    process's message queue. This unexpected leftover could
	    be eliminated if erlang:demonitor/2 with option flush
	    would be used in certain points</p>
          <p>
	    Own Id: OTP-9694</p>
        </item>
        <item>
          <p>
	    Add deps as erlang-flymake include directory.</p>
          <p>
	    Update erlang-flymake to recognize the "deps" folder as
	    an include directory. This makes erlang-flymake
	    compatible with the rebar dependency management tool's
	    default folder structure, which puts included
	    dependencies in "deps".(Thanks to Kevin Albrecht)</p>
          <p>
	    Own Id: OTP-9791</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Variables are now now allowed in '<c>fun M:F/A</c>' as
	    suggested by Richard O'Keefe in EEP-23.</p>
	    <p>The representation of '<c>fun M:F/A</c>' in the
	    abstract format has been changed in an incompatible way.
	    Tools that directly read or manipulate the abstract
	    format (such as parse transforms) may need to be updated.
	    The compiler can handle both the new and the old format
	    (i.e. extracting the abstract format from a pre-R15 BEAM
	    file and compiling it using compile:forms/1,2 will work).
	    The <c>syntax_tools</c> application can also handle both
	    formats.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-9643</p>
        </item>
        <item>
          <p>
	    Tuple funs (a two-element tuple with a module name and a
	    function) are now officially deprecated and will be
	    removed in R16. Use '<c>fun M:F/A</c>' instead. To make
	    you aware that your system uses tuple funs, the very
	    first time a tuple fun is applied, a warning will be sent
	    to the error logger.</p>
          <p>
	    Own Id: OTP-9649</p>
        </item>
        <item>
          <p>
	    Eliminate use of deprecated regexp module</p>
          <p>
	    Own Id: OTP-9810</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.5</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Teach the emacs mode to compile yecc and leex files</p>
          <p>
	    If visiting a .yrl or .xrl file in emacs with
	    erlang-mode, then the `erlang-compile' function (normally
	    bound to C-c C-k), now knows how to compile yecc and leex
	    files, and then, if that compilation succeeds, also
	    compiles the resulting .erl files.</p>
          <p>
	    Also introduce a `erlang-compile-command-function-alist'
	    to make it possible to hook in other functions for
	    computing compilation commands/expressions, depending on
	    file name. (Thanks to Tomas Abrahamsson )</p>
          <p>
	    Own Id: OTP-9503</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p> Bugs in xref(3) have been fixed. (Thanks to Matthias
	    Lang.) </p>
          <p>
	    Own Id: OTP-9416</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Change make:files to behave more like erlc</p>
          <p>
	    This change removes the unnecessary checks on the files
	    when make:files is called and allows the error checking
	    to be done in compile:file, where the error messages are
	    produced. It does not affect the return value.</p>
          <p>
	    (Thanks to Sam bobroff)</p>
          <p>
	    Own Id: OTP-9179</p>
        </item>
        <item>
          <p>
	    add user specified compiler options on form reloading</p>
          <p>
	    In order to be able to test non-exported functions from
	    another (test) module it is necessary to compile the
	    specific module (at least during the test phase) with the
	    export_all compiler option. This allows complete
	    separation of testing and productive code. At the moment
	    it is not possible to combine this with a test code
	    coverage using the cover module. The problem is that when
	    cover compiling a module using cover:compile_* the code
	    is reloaded into the emulator omitting/filtering the
	    passed user options. In my example above the export_all
	    option would be removed and the non-exported functions
	    cannot be called any more. (Thanks to Tobias Schlager)</p>
          <p>
	    Own Id: OTP-9204</p>
        </item>
        <item>
          <p>
	    Inhibit electric newline after "-&gt;" when inside a type
	    spec</p>
          <p>
	    The Erlang mode for Emacs inserts a newline after every
	    "-&gt;", which saves you one keystroke when writing a
	    function, but that is inappropriate when writing a type
	    spec, as you'd normally keep the spec on one line. This
	    change inhibits the automatic insertion when the current
	    line starts with "-spec" or "-type".(Thanks to Magnus
	    Henoch)</p>
          <p>
	    Own Id: OTP-9255</p>
        </item>
        <item>
          <p>
	    Add a check logic to prevent file descriptor leak</p>
          <p>
	    cover module handle files as raw in export and import.
	    Assert counts of ports are the same at the beginning and
	    at the end of the test case.(Thanks to Shunichi
	    Shinohara)</p>
          <p>
	    Own Id: OTP-9300</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Declare indentation options as "safe" in erlang-mode for
	    Emacs</p>
          <p>
	    Emacs has a facility for setting options on a per-file
	    basis based on comments in the source file. By default,
	    all options are considered "unsafe", and the user is
	    queried before the variable is set. This patch declares
	    the variables erlang-indent-level, erlang-indent-guard
	    and erlang-argument-indent to be safe, if the value
	    specified in the source file is valid.</p>
          <p>
	    Such declarations usually look like this:</p>
          <p>
	    %% -*- erlang-indent-level: 2 -*-</p>
          <p>
	    and appear on the first line of the file. (thanks to
	    Magnus Henoch)</p>
          <p>
	    Own Id: OTP-9122</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Cover has been improved to take less memory and allow
	    parallel analysis of cover data. Data collection from
	    nodes is now done in parallel and it is now possible to
	    issue multiple analyse and analyse_to_file requests at
	    the same time. A new function call async_analyse_to_file
	    has also been introduced, see the documentation for more
	    details.</p>
          <p>
	    Own Id: OTP-9043 Aux Id: seq11771 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>eprof: API sort mismatch has now been fixed. </p>
          <p>
	    Own Id: OTP-8853</p>
        </item>
        <item>
          <p>
	    eprof: fix division by zero in statistics</p>
          <p>
	    Own Id: OTP-8963</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    <c>cover</c> will now show ampersand characters in the
	    source code correctly. (Thanks to Tom Moertel.)</p>
          <p>
	    Own Id: OTP-8776</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>A race condition affecting Cover has been removed.</p>
          <p>
	    Own Id: OTP-8469</p>
        </item>
        <item>
          <p>
	    Emacs improvements:</p>
          <p>
	    Fixed emacs-mode installation problems.</p>
          <p>
	    Fixed a couple of -spec and -type indentation and
	    font-lock problems.</p>
          <p>
	    Fixed error messages on emacs-21.</p>
          <p>
	    Magnus Henoch fixed several issues.</p>
          <p>
	    Ralf Doering, Klas Johansson and Chris Bernard
	    contributed various emacs-eunit improvements.</p>
          <p>
	    Klas Johansson and Dave Peticolas added emacs-flymake
	    support.</p>
          <p>
	    Own Id: OTP-8530</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Xref has been updated to use the <c>re</c> module
	    instead of the deprecated <c>regexp</c> module.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-8472</p>
        </item>
        <item>
	    <p>When given the option <c>{builtins,true}</c> Xref now
	    adds calls to operators.</p>
          <p>
	    Own Id: OTP-8647</p>
        </item>
        <item>
	    <p><c>eprof</c> has been reimplemented with support in
	    the Erlang virtual machine and is now both faster (i.e.
	    slows down the code being measured less) and scales much
	    better. In measurements we saw speed-ups compared to the
	    old eprof ranging from 6 times (for sequential code that
	    only uses one scheduler/core) up to 84 times (for
	    parallel code that uses 8 cores).</p>
	    <p>Note: The API for the <c>eprof</c> has been cleaned up
	    and extended. See the documentation.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-8706</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.5.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
            <p>A bug concerning bit comprehensions has been fixed
            in Cover. The bug was introduced in R13B03. 
            (Thanks to Matthew Sackman.)</p>
          <p>Own Id: OTP-8340</p>
        </item>
      </list>
    </section>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
        Add lock profiling tool.</p>
          <p>
        The Lock profiling tool, lcnt, can make use of the
        internal lock statistics when the runtime system is built
        with this feature enabled.</p>
          <p>
        This provides a mechanism to examine potential lock
        bottlenecks within the runtime itself.</p>
          <p>
        - Add erts_debug:lock_counters({copy_save, bool()}). This
        option enables or disables statistics saving for
        destroyed processes and ets-tables. Enabling this might
        consume a lot of memory.</p>
          <p>
        - Add id-numbering for lock classes which is otherwise
        undefined.</p>
          <p>
        Own Id: OTP-8424</p>
        </item>
        <item>
          <p>
        emacs: Moved code skeletons to a separate file and and
        added a configurable variable to choose skeleton. Thanks
        Dave Peticolas.</p>
          <p>
        Own Id: OTP-8446</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.5</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
            <p>The coverage analysis tool <c>cover</c> has been
            improved when it comes to handling list and bit string
            comprehensions (a counter for each qualifier), bit syntax
            expressions (the Value and Size expressions), and try
            expressions (the body called <c>Exprs</c> in the Reference
            Manual). A few (not all) situations where several
            expressions are put on the same line are also handled
            better than before.</p>
          <p>Own Id: OTP-8188 Aux Id: seq11397</p>
        </item>
        <item>
            <p>When loading Cover compiled code on remote nodes 
            running code in the loaded module, a <c>badarg</c>
            failure was sometimes the result. This bug has been fixed.</p>
          <p>Own Id: OTP-8270 Aux Id: seq11423</p>
        </item>
        <item>
            <p>The short-circuit operators <c>andalso</c> and
            <c>orelse</c> are now handled correctly by the coverage
            analysis tool <c>cover</c> (it is no longer checked
            that the second argument returns a Boolean value.)</p>
          <p>Own Id: OTP-8273</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p><c>cover</c> now properly escapes greater-than and
	    less-than characters in comments in HTML reports. (Thanks
	    to Magnus Henoch.)</p>
          <p>
	    Own Id: OTP-7939</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.3</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            xref:start/1 does now allow anonymous XREF processes to
            be started</p>
          <p>
            Own Id: OTP-7831</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>A bug in the Xref scanner has been fixed.</p>
          <p>
	    Own Id: OTP-7423</p>
        </item>
        <item>
	    <p>A bug in Fprof where the function 'undefined' appeared
	    to call 'undefined' has been corrected.</p>
          <p>
	    Own Id: OTP-7509</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6.1</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>The documentation has been updated so as to reflect
	    the last updates of the Erlang shell as well as the minor
	    modifications of the control sequence <c>p</c> of the
	    <c>io_lib</c> module.</p> <p>Superfluous empty lines have
	    been removed from code examples and from Erlang shell
	    examples.</p>
          <p>
	    Own Id: OTP-6944 Aux Id: OTP-6554, OTP-6911 </p>
        </item>
        <item>
	    <p><c>tuple_size/1</c> and <c>byte_size/1</c> have been
	    substituted for <c>size/1</c>.</p>
          <p>
	    Own Id: OTP-7009</p>
        </item>
        <item>
	    <p>The coverage analysis tool <c>cover</c> now handles
	    the short-circuit Boolean expressions <c>andalso/2</c>
	    and <c>orelse/2</c> properly.</p>
          <p>
	    Own Id: OTP-7095</p>
        </item>
      </list>
    </section>

</section>

<section><title>Tools 2.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The <c>cover</c> tool could use huge amounts of memory
	    when used in a distributed system.</p>
          <p>
	    Own Id: OTP-6758</p>
        </item>
      </list>
    </section>

</section>


  <section>
    <title>Tools 2.5.5</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Missing buffer-local declaration in erlang.el has been
            added. Before this fix there could arise problems in
            other emacs modes after visiting a buffer using the
            erlang mode.</p>
          <p>Own Id: OTP-6721</p>
        </item>
        <item>
          <p>Key-map for 'backward-delete-char-untabif updated to work
            properly with Xemacs.</p>
          <p>Own Id: OTP-6723</p>
        </item>
      </list>
    </section>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>Minor updates of Xref.</p>
          <p>Own Id: OTP-6586</p>
        </item>
        <item>
          <p>Minor Makefile changes.</p>
          <p>Own Id: OTP-6689 Aux Id: OTP-6742 </p>
        </item>
        <item>
          <p>"C-u C-c C-k" now does a compile with both "debug_info"
            and "export_all".</p>
          <p>Own Id: OTP-6741</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5.4.1</title>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>Changes due to internal interface changes in the erts
            application which are needed at compile-time. No
            functionality has been changed.</p>
          <p>Own Id: OTP-6611 Aux Id: OTP-6580 </p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5.4</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Made change to support the function erlang-find-tag for
            xemacs and emacs-21.</p>
          <p>Own Id: OTP-6512</p>
        </item>
      </list>
    </section>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>Minor updates of xref for future compatibility.</p>
          <p>Own Id: OTP-6513</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5.3</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p><c>eprof</c> did not work reliably in the SMP emulator,
            because the trace receiver process could not process the
            trace messages fast enough. Therefore, <c>eprof</c> now
            blocks the other schedulers while profiling.</p>
          <p>Own Id: OTP-6373</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5.2</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Fprof traces could become truncated for the SMP emulator.
            This bug has now been corrected.</p>
          <p>Own Id: OTP-6246</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5.1</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>eprof now works somewhat better in the SMP emulator.</p>
          <p>Own Id: OTP-6152</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.5</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Fixed some bugs in <c>make</c>:</p>
          <p><c>make:files/1,2</c> can now handle a file in another
            directory as argument, similar to <c>make:all/0,1</c>.</p>
          <p>When specifying a file name including the <c>.erl</c>
            extension in <c>Emakefile</c>, <c>make:all/0,1</c> looked
            for the object code in the wrong place.</p>
          <p>When specifying a file name including the <c>.erl</c>
            extension in <c>Emakefile</c> and some compile options
            for the file, <c>make:files/0,1</c> did not use the
            options as it should do.</p>
          <p>Own Id: OTP-6057 Aux Id: seq10299</p>
        </item>
        <item>
          <p><c>cover</c>: When <c>cover:stop()</c> was called,
            the cover compiled code was not unloaded (as stated in
            the documentation) but simply marked as 'old'. This
            meant that processes lingering in (or with funs
            referencing to) the cover compiled code would survive
            even when the cover server and its ETS tables was
            terminated.</p>
          <p>Now the cover compiled code is unloaded, meaning that
            processes lingering in/with references to it will be
            killed when <c>cover:stop</c> is called, instead of
            later crashing with <c>badarg</c> when trying to bump
            counters in ETS tables no longer existing.</p>
        </item>
      </list>
    </section>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>Replaced call to deprecated function
            <c>file:file_info/1</c> with call to
            <c>filelib:is_dir/1</c> and <c>filelib:is_regular/1</c>
            in <c>tags.erl</c>.</p>
          <p>Own Id: OTP-6079</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.7</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>A bug in <c>fprof</c> profiling causing erroneous
            inconsistent trace failure has been corrected.</p>
          <p>Own Id: OTP-5922 Aux Id: seq10203 </p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.6</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Emacs: <c>erlang-man-function</c> and
            <c>erlang-man-module</c> used a pattern matching to find
            the requested module that sometimes yielded unexpected
            results. For example, <c>erlang-man-module file</c> would
            display the man page for <c>CosFileTransfer_File</c>.</p>
          <p>Own Id: OTP-5746 Aux Id: seq10096</p>
        </item>
        <item>
          <p>Some compiler warnings and Dialyzer warnings were
            eliminated in the Tools application.</p>
          <p>When tracing to a port (which <c>fprof</c> does),
            there could be fake schedule out/schedule in messages
            sent for a process that had exited.</p>
          <p>Own Id: OTP-5757</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.5</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>The cross reference tool <c>xref</c> did not handle the new
            <c>fun M:F/A</c> construct properly. This problem has been
            fixed.</p>
          <p>Own Id: OTP-5653</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.4</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>The <c>cover</c> tool did not escape '&lt;' and '&gt;' not
            being part of HTML tags in HTML log files.</p>
          <p>Own Id: OTP-5588</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.3</title>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>It is now possible to encrypt the debug information in
            beam files, to help keep the source code secret. See
            <c>compile(3)</c> for how to provide the key for encrypting,
            and <c>beam_lib(3)</c> for how to provide the key for
            decryption so that tools such as Debugger, <c>xref</c>, or
            <c>cover</c> can be used.</p>
          <p>The <c>beam_lib:chunks/2</c> functions now accepts an
            additional chunk type '<c>compile_info</c>' to retrieve
            the compilation information directly as a term. (Thanks
            to Tobias Lindahl.)</p>
          <p>Own Id: OTP-5460 Aux Id: seq9787</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.2</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>The <c>cover</c> tool could not analyze empty modules on
            module level.</p>
          <p>Own Id: OTP-5418</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Tools 2.4.1</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>The <c>xref</c> analysis <c>locals_not_used</c> could
            return too many functions. This problem has been fixed.</p>
          <p>Own Id: OTP-5071</p>
        </item>
        <item>
          <p>The <c>cover</c> tool could not always compile parse
            transformed modules. This problem has been fixed.</p>
          <p>Own Id: OTP-5305</p>
        </item>
      </list>
    </section>
  </section>
</chapter>