[cairo] [PATCH] doc: fix some broken references

Maarten Bosmans mkbosmans at gmail.com
Thu Dec 30 02:01:31 PST 2010


2010/12/29 Andrea Canciani <ranma42 at gmail.com>:
>> Am 28.12.2010 13:50, Maarten Bosmans wrote:
>>> This fixes some obvious mistakes in the docs.
>
> The attachment is a patch that should probably be merged with yours.

Attached is a new version of my patch and a modified version of yours,
with duplicate changes removed

> Cairo docs would use some more love and I have a couple of items in my
> TODO list, but I haven't fixed them yet.

Any suggestions? I was thinking of adding some more cross references
('see also' links) between relevant functions.

> In particular, if you are knowledgeable about gtk-doc, could you have a
> look at https://bugs.freedesktop.org/show_bug.cgi?id=28060 ?

It's a gtk-doc bug, solved now. What's the procedure for getting
updated documentation on the website?

> I hope someone who knows how the remaining brokenness should be
> fixed will speak up, because I'm unable to add anything useful to what
> Uli already said.

As per comments of Uli I changed the references xcb functions. Gtk-doc
still complains because the new functions from egl and xcb are not
documented, but at least the docs point to functions that exist within
the cairo codebase.

> Thank you for your patch, I'll try to make sure it doesn't just get lost
> in the ML ;)
>
> Andrea

Maarten
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-doc-Fix-some-broken-references-and-gtk-doc-warnings.patch
Type: application/octet-stream
Size: 17436 bytes
Desc: not available
URL: <http://lists.cairographics.org/archives/cairo/attachments/20101230/7c96331e/attachment-0002.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0002-doc-Fix-links.patch
Type: application/octet-stream
Size: 3306 bytes
Desc: not available
URL: <http://lists.cairographics.org/archives/cairo/attachments/20101230/7c96331e/attachment-0003.obj>


More information about the cairo mailing list