doc: Generate a valid cogl-context.xml

The automagic paragraph support of gtk-doc is way too simple to support
things like multi-paragraphs <note>s. Let's trick gtk-doc and make it
generate a valid docbook snippet for cogl-context.

Without this, cogl-context remains absent of the reference
documentation, how sad is this?!

(cherry picked from commit 606b472d91450e3221da6631020f534892e866a9)
This commit is contained in:
Damien Lespiau 2012-12-29 20:12:13 +00:00 committed by Robert Bragg
parent 9cc076b14c
commit 70f71e2627

View File

@ -67,7 +67,7 @@ G_BEGIN_DECLS
* that can all access the same GPU without having to worry about * that can all access the same GPU without having to worry about
* what state other components have left you with. * what state other components have left you with.
* *
* <note>Cogl does not maintain internal references to the context for * <note><para>Cogl does not maintain internal references to the context for
* resources that depend on the context so applications. This is to * resources that depend on the context so applications. This is to
* help applications control the lifetime a context without us needing to * help applications control the lifetime a context without us needing to
* introduce special api to handle the breakup of internal circular * introduce special api to handle the breakup of internal circular
@ -84,7 +84,7 @@ G_BEGIN_DECLS
* times throughout their lifetime (such as Android applications) they * times throughout their lifetime (such as Android applications) they
* should be careful to destroy all context dependant resources, such as * should be careful to destroy all context dependant resources, such as
* framebuffers or textures etc before unrefing and destroying the * framebuffers or textures etc before unrefing and destroying the
* context.<note> * context.</para></note>
*/ */
#ifdef COGL_ENABLE_EXPERIMENTAL_API #ifdef COGL_ENABLE_EXPERIMENTAL_API