diff options
Diffstat (limited to 'system')
| -rw-r--r-- | system/doc/top/Makefile | 14 | ||||
| -rw-r--r-- | system/doc/top/highlights.xml | 110 | ||||
| -rw-r--r-- | system/doc/top/incompatible.xml | 271 |
3 files changed, 3 insertions, 392 deletions
diff --git a/system/doc/top/Makefile b/system/doc/top/Makefile index 37466fa2d9..20ef9fe781 100644 --- a/system/doc/top/Makefile +++ b/system/doc/top/Makefile @@ -38,13 +38,6 @@ INFO_FILES = ../../README ../../COPYRIGHT PR.template TOPDOCDIR=. -TOP_HTML_GEN_FILES = \ - $(HTMLDIR)/incompatible.html \ - $(HTMLDIR)/highlights.html - -TOP_HTML_FILES = \ - $(TOP_HTML_GEN_FILES) - include ../installation_guide/xmlfiles.mk include ../system_principles/xmlfiles.mk include ../embedded/xmlfiles.mk @@ -229,7 +222,7 @@ $(TOP_PDF_FILE): $(XML_FILES) pdf: $(TOP_PDF_FILE) -html: $(INDEX_FILES) $(TOP_HTML_FILES) \ +html: $(INDEX_FILES) \ $(MAN_INDEX) $(JAVASCRIPT) debug opt: @@ -237,7 +230,7 @@ debug opt: clean: rm -rf ../html/js rm -f PR.template - rm -f $(INDEX_FILES) $(TOP_HTML_FILES) $(MAN_INDEX) + rm -f $(INDEX_FILES) $(MAN_INDEX) rm -f $(TOP_PDF_FILE) $(TOP_PDF_FILE:%.pdf=%.fo) rm -f $(INDEX_SCRIPT) $(GLOSSARY_SCRIPT) \ $(JAVASCRIPT_BUILD_SCRIPT) @@ -256,11 +249,10 @@ release_docs_spec: docs $(INSTALL_DIR) $(RELSYSDIR)/pdf $(INSTALL_DATA) \ $(TOP_PDF_FILE) $(RELSYSDIR)/pdf - $(INSTALL_DATA) $(TOP_HTML_FILES) $(RELSYSDIR) $(INSTALL_DIR) $(RELSYSDIR)/js $(INSTALL_DATA) \ $(JAVASCRIPT) $(RELSYSDIR)/js - $(INSTALL_DATA) $(INDEX_FILES) $(MAN_INDEX) $(TOP_HTML_FILES) $(RELSYSDIR) + $(INSTALL_DATA) $(INDEX_FILES) $(MAN_INDEX) $(RELSYSDIR) $(INSTALL_DIR) $(RELSYSDIR)/docbuild $(INSTALL_DATA) $(INDEX_SCRIPT) $(MAN_INDEX_SCRIPT) $(JAVASCRIPT_BUILD_SCRIPT) \ $(INDEX_SRC) $(MAN_INDEX_SRC) $(JAVASCRIPT_BUILD_SCRIPT_SRC) \ diff --git a/system/doc/top/highlights.xml b/system/doc/top/highlights.xml deleted file mode 100644 index 251bb1a47d..0000000000 --- a/system/doc/top/highlights.xml +++ /dev/null @@ -1,110 +0,0 @@ -<?xml version="1.0" encoding="latin1" ?> -<!DOCTYPE chapter SYSTEM "chapter.dtd"> - -<chapter> - <header> - <copyright> - <year>2006</year><year>2010</year> - <holder>Ericsson AB. All Rights Reserved.</holder> - </copyright> - <legalnotice> - 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 online 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. - - </legalnotice> - - <title>Highlights</title> - <prepared></prepared> - <docno></docno> - <date></date> - <rev>A</rev> - <file>highlights.xml</file> - </header> - <p>This document lists some highlights of Erlang 5.8/OTP R14A - (unpatched), compared to the previous version Erlang 5.7.1/OTP R13B, - with focus on things not already released as R13B patches.</p> - <p>Note: This document was compiled at the time when R14A was released - and does not list any features introduced in R14 patches.</p> - - <section> - <title>Erlang Language and Run-time System</title> - <section> - <title>New NIF features</title> - <list type="bulleted"> - <item><p>Send messages from a NIF, or from thread created by NIF, to - any local process (enif_send)</p></item> - - <item><p>Store terms between NIF calls (enif_alloc_env, - enif_make_copy)</p></item> - - <item><p>Create binary terms with user defined memory management - (enif_make_resource_binary)</p></item> - - <item><p>Some incompatible changes made to the API. For more - information see the warning text in erl_nif(3).</p></item> - </list> - </section> - <section> - <title>Receive optimizations</title> - <p>Receive statements that can only read out a newly created - reference are now specially optimized so that it will execute - in constant time regardless of the number of messages in the - receive queue for the process. That optimization will benefit - calls to gen_server:call(). (See gen:do_call/4 for an example - of a receive statement that will be optimized.)</p> - </section> - <section> - <title>Improved eprof</title> - <p>eprof 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 eprof has been cleaned up and extended. - See the documentation.</p> - </section> - </section> - <section> - <title>New features in Existing Applications</title> - - <section> - <title>Common_test</title> - - <p> - It is now possible for the user to provide specific callback - modules that handle test configuration data, so that data on - arbitray form can be accessed (e.g. by reading files or by - communicating with a configuration server process). Two - default callback modules have been introduced in Common Test: - ct_config_plain and ct_config_xml. The former is used to - handle the traditional Common Test configuration files (with - terms on key-value tuple form) and the latter to handle - configuration data on XML representation. - </p> - <p> - The run_test script has been replaced by a program (with the - same name) which can be executed without explicit - installation. The start flags are the same as for the legacy - start script. - </p> - </section> - <section> - <title>STDLIB</title> - <p> - The module binary from EEP31 (and EEP9) is implemented. - </p> - </section> - </section> -</chapter> - diff --git a/system/doc/top/incompatible.xml b/system/doc/top/incompatible.xml deleted file mode 100644 index e09fa7272f..0000000000 --- a/system/doc/top/incompatible.xml +++ /dev/null @@ -1,271 +0,0 @@ -<?xml version="1.0" encoding="latin1" ?> -<!DOCTYPE chapter SYSTEM "chapter.dtd"> - -<chapter> - <header> - <copyright> - <year>2006</year><year>2010</year> - <holder>Ericsson AB. All Rights Reserved.</holder> - </copyright> - <legalnotice> - 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 online 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. - - </legalnotice> - - <title>Potential Incompatibilities</title> - <prepared></prepared> - <docno></docno> - <date></date> - <rev></rev> - <file>incompatible.xml</file> - </header> - <p>This document contains a list of potential incompatibilities - between Erlang 5.8/OTP R14A and Erl 5.7.5/OTP R13B04, - and is an extract from the release notes for the respective applications.</p> - - <section> - <title>Tools</title> - <list type="bulleted"> - <item> - <p> - Xref has been updated to use the re module instead of the - deprecated regexp module.</p> - <p>*** INCOMPATIBILITY with R12B ***</p> - <p> - Own Id: OTP-8472</p> - </item> - <item> - <p>eprof 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 eprof has been cleaned up and extended. - See the documentation.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8706</p> - </item> - </list> - </section> - - <section> - <title>Odbc</title> - <list type="bulleted"> - <item> - <p> - Now supports SQL_TYPE_TIMESTAMP on the format {{YY, MM, DD}, - {HH, MM, SS}}. Thanks to Juhani Ränkimies. - </p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8511</p> - </item> - </list> - </section> - - <section> - <title>Ssh</title> - <list type="bulleted"> - <item> - <p> - The configuration parameter ip_v6_disabled is now available, - which makes it possible for the user to alter the IP version - SSH shall use.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8535</p> - </item> - <item> - <p> - Removed deprecated modules (ssh_ssh, ssh_sshd and ssh_cm) and - functions (ssh_sftp:connect and ssh_sftp:stop).</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8596</p> - </item> - <item> - <p> - Aligned error message with used version (SSH_FX_FAILURE vs - SSH_FX_NOT_A_DIRECTORY, the latter introduced in version 6).</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8644</p> - </item> - </list> - </section> - - <section> - <title>ERTS</title> - <list> - <item> - <p>Some incompatible changes made to the NIF API. For more - information see the warning text in erl_nif(3).</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8555</p> - </item> - </list> - </section> - - <section> - <title>STDLIB</title> - <list type="bulleted"> - <item> - <p>When defining macros the closing right parenthesis before the - dot is now mandatory.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8562</p> - </item> - </list> - </section> - - <section> - <title>Compiler and STDLIB</title> - <list type="bulleted"> - <item> - <p> - Local and imported functions now override the auto-imported - BIFs when the names clash. The pre R14 behaviour was that - auto-imported BIFs would override local functions. To avoid - that old programs change behaviour, the following will - generate an error:</p> - - <list type="bulleted"> - <item>Doing a call without explicit module name to a local function - having a name clashing with the name of an auto-imported BIF - that was present (and auto-imported) before OTP R14A</item> - - <item>Explicitly importing a function having a name clashing with - the name of an autoimported BIF that was present (and - autoimported) before OTP R14A</item> - - <item>Using any form of the old compiler directive nowarn_bif_clash</item> - </list> - - <p>If the BIF was added or auto-imported in OTP R14A or later, - overriding it with an import or a local function will only - result in a warning.</p> - - <p>To resolve clashes, you can either use the explicit module - name erlang to call the BIF, or you can remove the - auto-import of that specific BIF by using the new compiler - directive -compile({no_auto_import,[F/A]})., which makes all - calls to the local or imported function without explicit - module name pass without warnings or errors.</p> - - <p>The change makes it possible to add auto-imported BIFs - without breaking or silently changing old code in the future. - However some current code ingeniously utilizing the old - behaviour or the nowarn_bif_clash compiler directive, might - need changing to be accepted by the compiler.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8579</p> - </item> - <item> - <p> - The recently added BIFs erlang:min/2, erlang:max/2 and - erlang:port_command/3 are now auto-imported (as they were - originally intended to be). Due to the recent compiler change - (OTP-8579), the only impact on old code defining it's own - min/2, max/2 or port_command/3 functions will be a warning, - the local functions will still be used. The warning can be - removed by using - -compile({no_auto_import,[min/2,max/2,port_command/3]}). in - the source file.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8669</p> - </item> - <item> - <p> - Now, binary_to_term/2 is auto-imported. This will cause a - compile warning if and only if a module has got a local - function with that name.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8671</p> - </item> - </list> - </section> - - <section> - <title>Erl_interface</title> - <list type="bulleted"> - <item> - <p>Compact IEEE 754 double encoding in external binary format - for ei</p> - - <p>Implement the compact IEEE 754 double encoding in external - binary format for ei. Encoding for ei now always produces the - NEW_FLOAT_EXT format. Decoding and term printing handle both - the old ERL_FLOAT_EXT encoding and the new NEW_FLOAT_EXT - encoding.</p> - - <p>Legacy erl_interface code also handles the new encoding, but - still produces the ERL_FLOAT_EXT encoding by default.</p> - - <p>Also enable the DFLAG_NEW_FLOATS distribution flag.</p> - - <p>ei_get_type() will return ERL_FLOAT_EXT regardless if the - external format is encoded with ERL_FLOAT_EXT or - NEW_FLOAT_EXT for doubles.</p> - - <p>Reduce the number of copies of the code for encoding and - decoding doubles throughout ei and erl_interface by instead - calling the ei encoding and decoding functions wherever - possible.</p> - - <p>Restore commented-out float tests in ei_decode_SUITE and - ei_encode_SUITE in lib/erl_interface/test. Modify them to - make them match the style of other tests in the same suites.</p> - - <p>These changes are based on an ei float patch from Serge - Aleynikov originally submitted against R12B-2 in July 2008 - and reworked by Steve Vinoski May 2010.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8684</p> - </item> - </list> - </section> - <section> - <title>Debugger and STDLIB</title> - <list type="bulleted"> - <item> - <p> The predefined builtin type tid() has been removed. Instead, - ets:tid() should be used.</p> - <p> - *** POTENTIAL INCOMPATIBILITY ***</p> - <p> - Own Id: OTP-8687</p> - </item> - </list> - </section> -</chapter> - |