From eeeb7d467f5aa076ee18821b24548e9c2c2d154a Mon Sep 17 00:00:00 2001
From: Nicola Fontana <ntd@entidi.it>
Date: Sat, 9 Jan 2010 17:33:42 +0100
Subject: [PATCH] [docs] Specified setter conventions for pairs

Fixing issue #8: http://dev.entidi.com/p/adg/issues/8/
---
 docs/gnu/CONTRIBUTING.xml | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/docs/gnu/CONTRIBUTING.xml b/docs/gnu/CONTRIBUTING.xml
index 8cf87e3c..9ea14d43 100644
--- a/docs/gnu/CONTRIBUTING.xml
+++ b/docs/gnu/CONTRIBUTING.xml
@@ -77,20 +77,34 @@ and <code>CPML</code>, <code>Cpml</code> and <code>cpml</code> for the cairo pat
 addition, the following suggestions/rules also apply:</para>
 
 <informalexample><programlisting language="c">/* Method emitting "signal-name" */
-void            adg_object_signal_name  (AdgObject      *object,
-                                         /* Additional parameters */);
+void            adg_object_signal_name          (AdgObject      *object,
+                                                 /* Other parameters */);
 
 /* Setter method */
-void            adg_object_set_value    (AdgObject      *object,
-                                         const ValueType value);
+void            adg_object_set_value            (AdgObject      *object,
+                                                 const AdgValue *value);
 
 /* Getter method */
-const ValueType adg_object_get_value    (AdgObject      *object);
+const AdgValue *adg_object_get_value            (AdgObject      *object);
+
+/* Getter method returning scalar values must not be const */
+double          adg_object_get_double_value     (AdgObject      *object);
 
 /* Alternative getter method to be used when the previous syntax is
  * not allowed, such as when the value is dynamically generated */
-void            adg_object_put_value    (AdgObject      *object,
-                                         ValueType      *value);</programlisting></informalexample>
+void            adg_object_put_value            (AdgObject      *object,
+                                                 AdgValue       *value);
+
+/* Different version of the same setter method for pair values */
+void            adg_object_set_value            (AdgObject      *object,
+                                                 const AdgPair  *value);
+void            adg_object_set_value_explicit   (AdgObject      *object,
+                                                 gdouble         value_x,
+                                                 gdouble         value_y);
+void            adg_object_set_value_from_model (AdgADim        *adim,
+                                                 AdgModel       *model,
+                                                 const gchar    *named_pair);
+</programlisting></informalexample>
 
 <para>
 For any other non-C contribution (makefiles, translations, bindings,
-- 
2.11.4.GIT