diff options
Diffstat (limited to 'lib/jinterface/doc/src/notes.xml')
| -rw-r--r-- | lib/jinterface/doc/src/notes.xml | 306 |
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> + |