[cairo-bugs] [Bug 20180] New: There are misprints in the spec for " Base class for font faces" and "How a font should be rendered" groups

[bugzilla-daemon at freedesktop.org]

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

           Summary: There are misprints in the spec for "Base class for font
                    faces" and "How a font should be rendered" groups
           Product: cairo
           Version: 1.8.6
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: medium
         Component: general
        AssignedTo: cworth at cworth.org
        ReportedBy: tructv at necsv.com
         QAContact: cairo-bugs at cairographics.org


There are misprints in the spec. They are no harm, but if they are fixed, it
will raise the quality of cairo documentation a notch higher.

- In the spec for cairo_font_options_destroy(), the standard states:
"Destroys a cairo_font_options_t object created with with
cairo_font_options_create() or cairo_font_options_copy()."

Remove the extra text as follows:
"Destroys a cairo_font_options_t object created with 
cairo_font_options_create() or cairo_font_options_copy()."

- In the spec for cairo_font_options_hash(), the standard states:
"Compute a hash for the font options object;"

Add the character as follows:
"Computes a hash for the font options object;"

- In the spec for cairo_subpixel_order_t, the standard states:
"CAIRO_SUBPIXEL_ORDER_DEFAULT 
Use the default subpixel order for for the target device"

Remove the extra text as follows:
"CAIRO_SUBPIXEL_ORDER_DEFAULT
Use the default subpixel order for the target device"

- In the spec for cairo_font_face_get_user_data(), the standard states:
"Return user data previously attached to font_face using the specified key. If
no user data has been attached with the given key this function returns NULL."

Add the character as follows:
"Returns user data previously attached to font_face using the specified key. If
no user data has been attached with the given key this function returns NULL."

- In the spec for cairo_font_face_set_user_data(), the standard states:
"Attach user data to font_face. To remove user data from a font face, call this
function with the key that was used to set it and NULL for data."

Add the character as follows:
"Attachs user data to font_face. To remove user data from a font face, call
this function with the key that was used to set it and NULL for data."

Please, give us your decision.

Thank you very much for your time.


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