[libdmapsharing] Update README-Porting after beginning to port Rhythmbox's DAAP plugin

[W. Michael Petullo <wmpetullo src gnome org>]

commit e6d49f6235cce88836104ea9bf09024f09ab435d
Author: W. Michael Petullo <mike flyn org>
Date:   Thu Jul 12 00:22:57 2018 -0400

    Update README-Porting after beginning to port Rhythmbox's DAAP plugin
    
    Signed-off-by: W. Michael Petullo <mike flyn org>

 README-Porting | 67 ++++++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 46 insertions(+), 21 deletions(-)
---
diff --git a/README-Porting b/README-Porting
index 0ac6bd1..fcbc2b8 100644
--- a/README-Porting
+++ b/README-Porting
@@ -1,12 +1,11 @@
 Version 4.0 of the libdmapsharing API is incompatible with previous
-versions. The primary reason for these changes is to better support
+versions. The primary reason for the changes is to better support
 GObject introspection and thus languages such as Python. The following
-are the key differences between the new and old APIs:
+are the key differences between the new and old APIs. Refer also to the
+libdmapsharing API documentation and the programs distributed along with
+the libdmapsharing source in the "tests" directory.
 
-(1)  A program which shares a DMAP service must explicitly call
-dmap_share_serve() and dmap_share_publish().
-
-(2)  All symbols now exist in the DMAP/Dmap/dmap namespace.
+(1)  All symbols now exist in the DMAP/Dmap/dmap namespace.
 
        (a) For example, DMAPDb is now DmapDb.
 
@@ -16,42 +15,62 @@ dmap_share_serve() and dmap_share_publish().
 
        (d) DAAPRecord is now DmapAvRecord.
 
-       (d) DPAPRecord is now DmapImageRecord.
+       (e) daap_share_new is now dmap_av_share_new.
+
+       (f) DAAP_TYPE_RECORD is now DMAP_TYPE_AV_RECORD.
+
+       (g) DPAPRecord is now DmapImageRecord.
+
+       (h) dpap_share_new is now dmap_image_share_new.
+
+       (i) DPAP_TYPE_RECORD is now DMAP_TYPE_IMAGE_RECORD.
+
+       (j) DACPPlayer is now DmapControlPlayer.
+
+       (k) dacp_share_new is now dmap_control_share_new.
 
-       (e) DACPPlayer is now DmapControlPlayer.
+       (l) DACP_TYPE_RECORD is now DMAP_TYPE_CONTROL_RECORD.
+
+(2)  A program which shares a DMAP service must explicitly call
+dmap_share_serve() and dmap_share_publish().
 
 (3)  The interface names exported by libdmapsharing now end in "Interface"
 instead of "Iface".
 
 (4)  The new API renames the following symbols as indicated:
 
-       DMAP_TYPE_DMAP_MDNS_BROWSER_TRANSPORT_PROTOCOL became
+       (a) DMAP_TYPE_DMAP_MDNS_BROWSER_TRANSPORT_PROTOCOL became
        DMAP_TYPE_DMAP_MDNS_SERVICE_TRANSPORT_PROTOCOL.
 
-       DMAPMdnsBrowserTransportProtocol became DMAPMdnsServiceTransportProtocol.
+       (b) DMAPMdnsBrowserTransportProtocol became DmapMdnsServiceTransportProtocol.
+
+       (c) DMAPMdnsBrowserServiceType became DmapMdnsServiceType.
+
+       (d) DMAPMdnsBrowserService became DmapMdnsService.
 
-       DMAPMdnsBrowserServiceType became DMAPMdnsServiceType.
+       (e) DMAPConnectionCallback became DmapConnectionFunc.
 
-       DMAPMdnsBrowserService became DMAPMdnsService.
+       (f) DMAP_MDNS_BROWSER_TRANSPORT_PROTOCOL* became
+       DMAP_MDNS_SERVICE_TRANSPORT_PROTOCOL*.
 
-       DMAPConnectionCallback became DMAPConnectionFunc.
+       (g) DMAP_MDNS_BROWSER_SERVICE_TYPE_* became DMAP_MDNS_SERVICE_TYPE_*.
 
-       DMAP_MDNS_BROWSER_TRANSPORT_PROTOCOL* became DMAP_MDNS_SERVICE_TRANSPORT_PROTOCOL*.
+       (h) dmap_connection_connect became dmap_connection_start.
 
-       DMAP_MDNS_BROWSER_SERVICE_TYPE_* became DMAP_MDNS_SERVICE_TYPE_*.
+       (i) The dmap_hash functions became dmap_md5 functions.
 
-       dmap_connection_connect became dmap_connection_start.
+       (j) DACP_PLAY_STOPPED and so on became, for example, DMAP_CONTROL_PLAY_STOPPED.
 
-       The dmap_hash functions became dmap_md5 functions.
+       (k) DACPRepeatState became DmapControlRepeatState.
 
-       DACP_PLAY_STOPPED and so on became, for example, CONTROL_PLAY_STOPPED.
+       (l) DACPPlayState became DmapControlPlayState.
 
-       DACPRepeatState became DmapControlRepeatState.
+       (m) DMAP_GET_SONGS became DMAP_GET_MEDIA
 
-       DACPPlayState became DmapControlPlayState.
+       (n) dmap_connection_disconnect became dmap_connection_stop
 
 (5)  The new API replaces the use of GHFunc with DmapIdRecordFunc and
-DmapContainerIdFunc.
+DmapIdContainerRecordFunc.
 
 (6)  Setting an object property using g_object_set causes the object to
 duplicate the passed value.  Thus the caller maintains control of the
@@ -91,3 +110,9 @@ using g_object_get.
        (d) dmap_share_publish().
 
        (e) dmap_container_record_add_entry().
+
+       (f) dmap_container_record_add_entry().
+
+       (g) dmap_control_share_start_lookup().
+
+       (h) dmap_control_share_stop_lookup().