[libdmapsharing] Add notes about g_object_{get, set} to README-Porting



commit 4723d7b369f295470ab55cca63272c2a23885ddc
Author: W. Michael Petullo <mike flyn org>
Date:   Wed Dec 6 22:11:37 2017 -0500

    Add notes about g_object_{get,set} to README-Porting
    
    Signed-off-by: W. Michael Petullo <mike flyn org>

 README-Porting |   21 ++++++++++++++-------
 1 files changed, 14 insertions(+), 7 deletions(-)
---
diff --git a/README-Porting b/README-Porting
index 9260457..09955c7 100644
--- a/README-Porting
+++ b/README-Porting
@@ -25,7 +25,17 @@ instead of "Iface".
 
        dmap_connection_connect became dmap_connection_start.
 
-(3) The "hash" property in the DAAPRecord interface and the "hash"
+(3) The new API replaces the use of GHFunc with DMAPIdRecordFunc and
+DMAPContainerIdFunc.
+
+(4) Setting an object property using g_object_set causes the object to
+duplicate the passed value.  Thus the caller maintains control of the
+original value.
+
+(5) Getting an object property using g_object_set returns a duplicate
+of the value. Thus the caller should free or unref the obtained value.
+
+(6) The "hash" property in the DAAPRecord interface and the "hash"
 and "thumbnail" properties in the DPAPRecord interface are now boxed
 types.  The true type of each of these properties is a GArray. Thus
 implementations of these interfaces should now:
@@ -36,14 +46,11 @@ implementations of these interfaces should now:
 
        (c) use GArray instead of GByteArray.
 
-(4) The "base-uri" property in the DMAPConnection class is now a boxed
+(7) The "base-uri" property in the DMAPConnection class is now a boxed
 type. The real type is SoupURI.
 
-(4) The "db" and "container-db" properties in DMAPShare are now handled
+(8) The "db" and "container-db" properties in DMAPShare are now handled
 as object types instead of pointer types.
 
-(5) The new API replaces the use of GHFunc with DMAPIdRecordFunc and
-DMAPContainerIdFunc.
-
-(6) The properties contained in a DMAPMdnsService must now be accessed
+(9) The properties contained in a DMAPMdnsService must now be accessed
 using g_object_get.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]