[cairo-commit] cairo/doc/public/tmpl cairo.sgml,1.11,1.12

[Owen Taylor]

Committed by: otaylor

Update of /cvs/cairo/cairo/doc/public/tmpl
In directory gabe:/tmp/cvs-serv17943/doc/public/tmpl

Modified Files:
	cairo.sgml 
Log Message:
2005-04-28  Owen Taylor  <otaylor at redhat.com>

        * src/cairo-surface.c src/cairoint.h: Add _cairo_surface_begin/end
        to save and restore the clip state of a surface. Copy and store
        clip regions set on a surface so that we can save and restore them.

        * src/cairo.[ch]: Add a CAIRO_STATUS_BAD_NESTING error
        for interleaved use of two cairo_t's on the same surface. Also,
        add a skeleton doc comment for cairo_status_t.

        * src/cairo.c src/cairo-gstate.c src/cairoint.h: Use
        _cairo_surface_begin/end to replace
        _cairo_gstate_restore_external_state.

        * src/cairo-gstate.c: Use _cairo_surface_begin/end to save the
        state of a surface when we start drawing at it and restore it
        at the end. Check that the save level of the surface is what
        we expect on drawing operations and fail with CAIRO_STATUS_BAD_NESTING
        otherwise.

        * src/cairo-pattern.c src/cairoint.h (_cairo_pattern_acquire_surface_for_surface)
        (_cairo_pattern_release_surface): Surround use of pattern->surface
        with _cairo_surface->begin/end so we don't clip surfaces used as
        sources.

        * test/clip-nesting.c test/Makefile.am: Test of destinatin
        clipping with the nested creation of cairo_t's for the same
        context.

        * test/source-clip.c test/Makefile.am: Test that clipping on
        a source as a destination doesn't affect use of it as a source.

        * test/self-copy.c: XFAIL test for copying from a surface as
        a source to itself as a destination with a clip.


Index: cairo.sgml
===================================================================
RCS file: /cvs/cairo/cairo/doc/public/tmpl/cairo.sgml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- cairo.sgml	2 May 2005 18:01:18 -0000	1.11
+++ cairo.sgml	2 May 2005 20:39:33 -0000	1.12
@@ -1042,6 +1042,7 @@
 @CAIRO_STATUS_WRITE_ERROR: 
 @CAIRO_STATUS_SURFACE_FINISHED: 
 @CAIRO_STATUS_SURFACE_TYPE_MISMATCH: 
+ at CAIRO_STATUS_BAD_NESTING: 
 
 <!-- ##### FUNCTION cairo_status ##### -->
 <para>