cairo-copy-page (cr)

cr -- a cairo-t context

Emits the current page for backends that support multiple pages, but does not clear it, so, the contents of the current page will be retained for the next page too. Use the cairo-show-page function if you want to get an empty page after the emission.

This is a convenience function that simply calls the cairo-surface-copy-page function on the target of cr.