Index: /libcaca/trunk/doc/migrating.dox
===================================================================
--- /libcaca/trunk/doc/migrating.dox	(revision 3604)
+++ /libcaca/trunk/doc/migrating.dox	(revision 3605)
@@ -113,4 +113,6 @@
  - \b caca_init(): use caca_create_canvas() to create a \e libcaca canvas,
    followed by caca_create_display() to attach a \e libcaca display to it.
+   Alternatively, caca_create_display() with a NULL argument will create a
+   canvas automatically.
  - \b caca_set_delay(): use caca_set_display_time().
  - \b caca_get_feature(): deprecated.
@@ -129,4 +131,6 @@
  - \b caca_end(): use caca_free_display() to detach the \e libcaca display,
    followed by caca_free_canvas() to free the underlying \e libcaca canvas.
+   Alternatively, if the canvas was created by caca_create_display(), it
+   will be automatically destroyed by caca_free_display().
 
  \subsection bar2 Event handling