[libnet-sip-perl] 03/04: Add debian/NEWS to mention API changes.

[gregor herrmann]

This is an automated email from the git hooks/post-receive script.

gregoa pushed a commit to branch master
in repository libnet-sip-perl.

commit 272ff1d184b4819caedb6634e121f3b5f4385ec2
Author: gregor herrmann <gregoa at debian.org>
Date:   Thu Nov 17 18:37:24 2016 +0100

    Add debian/NEWS to mention API changes.
---
 debian/NEWS | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/debian/NEWS b/debian/NEWS
new file mode 100644
index 0000000..d1a0e34
--- /dev/null
+++ b/debian/NEWS
@@ -0,0 +1,37 @@
+libnet-sip-perl (0.700-1) unstable; urgency=medium
+
+  From upstream Changes:
+
+  - major API changes !!!
+    - proxies, registrars etc are no longer given with udp:/tcp: prefix to signal
+      which protocol gets used but instead SIP URL's are used:
+        sip:...  - SIP over UDP
+        sip:...;transport=TCP - SIP over TCP
+        sips:... - SIP over TLS
+      the simplified syntax without protocol specification still works and is
+      considered as before as SIP over UDP
+    - Util: result of sip_uri2parts changed
+      from (domain,user,proto,param,data)
+      to   (domain,user,proto,data,param)
+    - Eventloop - addFD, delFD now take argument $rw to specify if the handler is
+      for read or for write. If omitted in delFD it will remove all handlers for
+      fd as before. Wrong (old) usage with addFD will result in Carp::confess.
+      !!! When integrating with its own eventloop this is also the interface this
+      loop is expected to provide !!!
+    - Dispatcher::deliver: arguments dst_addr now [proto,ip,port,family] instead
+      of string. Using string with SIP URI is also still supported but not
+      official API but existing code without protocol specification in string
+      should thus still work.
+    - Endpoint::register expects SIP URI, i.e. no longer adds 'sip:' prefix
+    - fields or meaning of fields in Leg, Packet, Dispatcher::Packet changed but
+      nobody should have accessed these internals anyway
+    - Leg::deliver: destination given as [proto,ip,port,family] instead of
+      ip:port string
+    - Leg::sendto takes packet object instead of packet string, dst as single
+      argument with [host,port,family] instead of separate addr and port arguments
+    - Leg::receive now gets (packet,from) and returns the same (might modify data
+      but currently doesn't). Previously reading of the packet was done inside
+      this function but now reading is done by SocketPool and Leg just has the
+      option to process packet.
+
+ -- gregor herrmann <gregoa at debian.org>  Thu, 17 Nov 2016 18:36:18 +0100

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libnet-sip-perl.git