[cairo-commit] doc/public

[Chris Wilson]

 doc/public/language-bindings.xml |    9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

New commits:
commit 986ae4232067d4f33931d98fb6324871a1025633
Author: Owen W. Taylor <otaylor at fishsoup.net>
Date:   Thu Feb 25 15:18:22 2010 -0500

    language bindings guide: clarify mapping for cairo_pattern_create_rgb[a]
    
    Clarify that cairo_pattern_create_rgb() and cairo_pattern_create_rgba()
    should be be overloaded as a single constructor for SolidPattern, but
    instead should be static methods.

diff --git a/doc/public/language-bindings.xml b/doc/public/language-bindings.xml
index 8d98b56..f405fda 100644
--- a/doc/public/language-bindings.xml
+++ b/doc/public/language-bindings.xml
@@ -506,8 +506,13 @@ CAIRO_STATUS_WRITE_ERROR
       linkend="cairo-pattern-t"><type>cairo_pattern_t</type></link>
       in C, but in an object oriented language, there should instead
       be a hierarchy of types. (The functions that should map to
-      constructors for the various types are listed after the type,
-      methods on that type are listed below)
+      constructors or static methods for the various types are listed
+      after the type, methods on that type are listed below. Note that
+      cairo_pattern_create_rgb() and cairo_pattern_create_rgba()
+      should not be overloaded with each other as a SolidPattern()
+      constructor, but should appear as static methods instead.  This
+      is to maintain code clarity by making it clear how the arguments
+      relate to color components.)
     </para>
     <programlisting>
 cairo_pattern_t