diff options
| author | Owen W. Taylor <otaylor@fishsoup.net> | 2010-02-25 15:18:22 -0500 |
|---|---|---|
| committer | Chris Wilson <chris@chris-wilson.co.uk> | 2010-05-13 10:08:32 +0100 |
| commit | 986ae4232067d4f33931d98fb6324871a1025633 (patch) | |
| tree | c0bf0b5f471358eca14e169b16334eb4e6c9faa7 /doc | |
| parent | 18b48a6ebc044c07f08bafd0abcb68c595c5746c (diff) | |
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.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/public/language-bindings.xml | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/public/language-bindings.xml b/doc/public/language-bindings.xml index 8d98b56bc..f405fdaf9 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 |