From 9f98ec6eb915204d59820cf57d32f347f9933517 Mon Sep 17 00:00:00 2001
From: M Joonas Pihlaja <jpihlaja@cc.helsinki.fi>
Date: Sun, 29 Aug 2010 00:05:51 +0300
Subject: [PATCH] device: Refer the user to per-backend docs about devices.

The exact semantics of the device API can't be spelled out
out in the device API docs since the effects are so tied
to the specific backend.  To use a particular device in
practice the user should refer to the backend docs.
---
 src/cairo-device.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/cairo-device.c b/src/cairo-device.c
index dac1b3b6b..15b048477 100644
--- a/src/cairo-device.c
+++ b/src/cairo-device.c
@@ -86,6 +86,12 @@
  *   cairo_device_release (device);
  * }
  * </programlisting></informalexample>
+ *
+ * <note><para>Please refer to the documentation of each backend for
+ * additional usage requirements, guarantees provided, and
+ * interactions with existing surface API of the device functions for
+ * surfaces of that type.
+ * </para></note>
  */
 
 static const cairo_device_t _nil_device = {