[cairo-bugs] [Bug 12659] New: cairo_image_surface_get_data documentation

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=12659

           Summary: cairo_image_surface_get_data documentation
           Product: cairo
           Version: 1.5.1
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: general
        AssignedTo: cworth at cworth.org
        ReportedBy: stevech1097 at yahoo.com.au
         QAContact: cairo-bugs at cairographics.org


The documentation for cairo_image_surface_get_data is incomplete.
It says
"Returns :       a pointer to the image data of this surface or NULL if surface
is not an image surface."

I think it should say
Returns :        a pointer to the image data of this surface or NULL if surface
is not an image surface, or if cairo_surface_finish has been called."

Its important for cairo bindings to know that the surface can be an image
surface AND NULL can be returned, and if NULL is not checked for a segmentation
fault could occur.


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug, or are watching the QA contact.