The R13B03 release.OTP_R13B03

1 files changed, 306 insertions, 0 deletions

diff --git a/lib/jinterface/doc/src/notes.xml b/lib/jinterface/doc/src/notes.xml
new file mode 100644
index 0000000000..90ac2991f3
--- /dev/null
+++ b/lib/jinterface/doc/src/notes.xml
@@ -0,0 +1,306 @@
+<?xml version="1.0" encoding="latin1" ?>
+<!DOCTYPE chapter SYSTEM "chapter.dtd">
+
+<chapter>
+  <header>
+    <copyright>
+      <year>2000</year><year>2009</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>Jinterface Release Notes</title>
+    <prepared>otp_appnotes</prepared>
+    <docno>nil</docno>
+    <date>nil</date>
+    <rev>nil</rev>
+    <file>notes.xml</file>
+  </header>
+  <p>This document describes the changes made to the Jinterface application.</p>
+
+<section><title>Jinterface 1.5.2</title>
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+          <p>
+	    The documentation is now built with open source tools
+	    (xsltproc and fop) that exists on most platforms. One
+	    visible change is that the frames are removed.</p>
+          <p>
+	    Own Id: OTP-8201</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Jinterface 1.5.1</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    Many Erlang classes, e.g. OtpErlangRef, was missing an
+	    implementation of the hashCode() method, making it futile
+	    to put them in hash structures such as HashMap. Bug and
+	    patch provided by Paul Guyot. We extended the patch to
+	    all classes and improved (?) on the hash algorithm.</p>
+          <p>
+	    Own Id: OTP-7899</p>
+        </item>
+      </list>
+    </section>
+
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+          <p>
+	    jinterface uses the new environment variable
+	    ERL_EPMD_PORT the same way that erl, epmd and
+	    erl_interface do since R13A.</p>
+          <p>
+	    Own Id: OTP-7885</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Jinterface 1.5</title>
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+          <p>
+	    A number of fixes and improvements from the ErlIDE group;
+	    Vlad Dumitrescu and Jakob Cederlund: JDK 1.5 is now a
+	    minimal requirement for building Jinterface. New method:
+	    OtpEpmd.lookupNames. OtpErlangList is now iterable.
+	    Non-proper lists are now allowed - you have to test if a
+	    list is proper or not. Non-proper lists can also be
+	    created. New methods: isProper, getHead, getTail and
+	    getNthTail. The get tail methods creates a sublist object
+	    that re-uses the original list. OtpErlangPid is now
+	    Comparable. Empty atoms can now be constructed, a missing
+	    feature pointed out by Sebastien Boisgerault on
+	    erlang-questions.</p>
+          <p>
+	    *** POTENTIAL INCOMPATIBILITY ***</p>
+          <p>
+	    Own Id: OTP-7832</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Jinterface 1.4.2</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    A bug when Jinterface did not detect remote node
+	    disconnects has been corrected.</p>
+          <p>
+	    Own Id: OTP-7624</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Jinterface 1.4.1</title>
+
+    <section><title>Fixed Bugs and Malfunctions</title>
+      <list>
+        <item>
+          <p>
+	    Jinterface has been fixed to use the loopback interface
+	    when connecting to the Erlang Port Mapper Daemon - epmd.
+	    This facilitates firewall configuration and saves
+	    resources.</p>
+          <p>
+	    Own Id: OTP-7103</p>
+        </item>
+        <item>
+	    <p>Jinterface now refuses to connect to another node that
+	    does not agree on the other node's name. This has been a
+	    problem in that a connection was set up, but not used on
+	    a following send, which caused a second erroneous
+	    connection attempt to fail since the other (Erlang) node
+	    rejects a connection due to name disagreement.</p>
+	    <p>Problem reported and dissected by Alexander Lamb</p>
+          <p>
+	    Own Id: OTP-7330</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+<section><title>Jinterface 1.4</title>
+
+    <section><title>Improvements and New Features</title>
+      <list>
+        <item>
+	    <p>Jinterface has been updated to handle compressed
+	    terms, bitstring, new (IEEE) floats and bignums. This has
+	    caused a few incompatibilities.</p>
+	    <p>com.ericsson.otp.erlang.OtpOutputStream now extends
+	    java.io.ByteArrayOutputStream, previously
+	    java.lang.Object, and hence the method size() now return
+	    the number of bytes in the stream as dictated by the new
+	    parent class and not the buffer length as before. The new
+	    method length() returns what the old size() did return.
+	    The method count() is deprecated as it returns the same
+	    as the new size().</p>
+	    <p>com.ericsson.otp.erlang.OtpErlangLong now can handle
+	    larger values than 64-bit. Previously when larger than
+	    64-bit integers were sent to a Jinterface node, it caused
+	    an com.ericsson.otp.erlang.OtpDecodeException. Now the
+	    integer is accepted, but the return value of longValue()
+	    is silently truncated, as opposed to the return value of
+	    intValue() that now and previously raises an
+	    com.ericsson.otp.erlang.OtpRangeException for
+	    unrepresentable values. The new methods isLong() and
+	    isULong() can be used to determine if the value fits in a
+	    long.</p>
+          <p>
+	    *** POTENTIAL INCOMPATIBILITY ***</p>
+          <p>
+	    Own Id: OTP-6809</p>
+        </item>
+      </list>
+    </section>
+
+</section>
+
+  <section>
+    <title>Jinterface 1.3</title>
+
+    <section>
+      <title>Fixed Bugs and Malfunctions</title>
+      <list type="bulleted">
+        <item>
+          <p><c>OtpMbox.receive()</c> and <c>OtpMbox.receive(long timeout)</c> can now throw
+            <c>OtpErlangDecodeException</c> if the received message
+            can not be decoded. <c>null</c> is now only returned from
+            <c>OtpMbox.receive(long timeout)</c> if a timeout occurs.
+            <c>OtpMbox.receive()</c> will never return <c>null</c>.</p>
+          <p>*** POTENTIAL INCOMPATIBILITY ***</p>
+          <p>Own Id: OTP-3932 Aux Id: seq5196 </p>
+        </item>
+        <item>
+          <p>Strings longer than 65535 bytes were encoded wrong by
+            jinterface.</p>
+          <p>Own Id: OTP-4883 Aux Id: OTP-4865 </p>
+        </item>
+        <item>
+          <p>Misc bugfixes: </p>
+          <list type="bulleted">
+            <item>
+              <p>A node pinging itself does no
+                longer cause the java program to hang.</p>
+              <p></p>
+            </item>
+            <item>
+              <p><c>OtpMbox.close()</c> uses exit reason
+                <c>'normal'</c> (atom) instead of <c>"normal"</c>
+                (string).</p>
+              <p></p>
+            </item>
+            <item>
+              <p>Added <c>OtpNode.closeMbox(OtpMbox mbox, OtpErlangObject reason)</c>.</p>
+              <p></p>
+            </item>
+            <item>
+              <p>Added <c>OtpMbox.exit(OtpErlangObject reason)</c>
+                and <c>OtpMbox.exit(String reason)</c>.</p>
+              <p></p>
+            </item>
+            <item>
+              <p>Added <c>OtpMbox.exit(OtpErlangPid to, OtpErlangObject reason)</c>.</p>
+              <p></p>
+            </item>
+            <item>
+              <p><c>OtpMbox.exit(OtpErlangPid to, String reason)</c>
+                is now equivalent to <c>OtpMbox.exit(to, new OtpErlangAtom(reason))</c>.</p>
+              <p></p>
+            </item>
+            <item>Exit signals from an Erlang node can now contain
+             any erlang term as reason, not only atoms. </item>
+          </list>
+          <p>Own Id: OTP-5088</p>
+        </item>
+        <item>
+          <p>For java versions 1.3.1 or later, <c>localStatus</c> was
+            not sent to registered status handler when
+            <c>OtpNode.close()</c> was called. This is now corrected.</p>
+          <p>Own Id: OTP-5169</p>
+        </item>
+      </list>
+    </section>
+
+    <section>
+      <title>Improvements and New Features</title>
+      <list type="bulleted">
+        <item>
+          <p>Process identifiers and port identifiers have been
+            made more unique. Previously 18 bits were used as id in
+            the internal representation of process and port
+            identifiers. Now 28 bits are used. </p>
+          <p>The maximum
+            limit on the number of concurrently existing processes
+            due to the representation of pids has been increased to
+            268435456 processes. The same is true for ports. This
+            limit will at least on a 32-bit architecture be
+            impossible to reach due to memory shortage. </p>
+          <p><em>NOTE:</em> By default, the <c>ERTS</c>, and the
+            <c>erl_interface</c>, <c>ei</c>, and <c>jinterface</c>
+            libraries are now only guaranteed to be compatible with
+            other Erlang/OTP components from the same release. It is
+            possible to set each component in compatibility mode of
+            an earlier release, though. See the documentation for
+            respective component on how to set it in compatibility
+            mode. </p>
+          <p>*** POTENTIAL INCOMPATIBILITY ***</p>
+          <p>Own Id: OTP-4968 Aux Id: OTP-4196 </p>
+        </item>
+      </list>
+    </section>
+  </section>
+
+  <section>
+    <title>Jinterface 1.2.1.2</title>
+
+    <section>
+      <title>Fixed Bugs and Malfunctions</title>
+      <list type="bulleted">
+        <item>
+          <p>Output of Java long was truncated to 32 bits. IDL long
+            long and unsigned long long could not be used in a struct
+            for the Java backend. All unsigned integer types for the
+            Java backend had broken marshalling for large values.
+            These bugs has now been fixed.</p>
+          <p>Own Id: OTP-4763 Aux Id: seq8024 </p>
+        </item>
+      </list>
+    </section>
+  </section>
+</chapter>
+