[cairo-bugs] [Bug 82741] cairo 1.12.16: minor fixes to the docs

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=82741

--- Comment #6 from Bryce Harrington <bryce at osg.samsung.com> ---
I'll go ahead and take the removal of the doxygen for cairo_set_opacity().  I
can't discern why it was disabled or what side effects re-enabling it might
incur, but looks like it deserves future study if/when someone has the
inclination.  Potentially it could be removed, as it's been 7 years with no
complaints about its omission...

commit 35fccff6ec393ccca3d3ced79093ca491ce32df4
Author:     Bryce Harrington <bryce at osg.samsung.com>
AuthorDate: Mon Nov 6 12:09:53 2017 -0800
Commit:     Bryce Harrington <bryce at osg.samsung.com>
CommitDate: Mon Nov 6 12:18:37 2017 -0800

    Un-doxygen disabled cairo_set_opacity

    The cairo_set_opacity() routine has been disabled since 2010.  There
    appears to be support for it internally in the backend, so it is unclear
    why it is not enabled or what might break if it were re-enabled.  Given
    the lack of bug reports about its omission, it may be vestigal.  For
    now, just hide the doxygen for it to suppress warnings.  It may be worth
    deeper review to either re-enable it or remove it entirely.

    Reported-by: Rafał Mużyło (See fdo bugzilla #82741)
    Signed-off-by: Bryce Harrington <bryce at osg.samsung.com>

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.cairographics.org/archives/cairo-bugs/attachments/20171106/d2eb87f5/attachment.html>