diff --git a/gst-libs/gst/video/video-frame.c b/gst-libs/gst/video/video-frame.c
index cc5073c82c..30a2d85749 100644
--- a/gst-libs/gst/video/video-frame.c
+++ b/gst-libs/gst/video/video-frame.c
@@ -199,7 +199,7 @@ invalid_size:
  *   GstVideoFrame vframe;
  *   ...
  *   // set RGB pixels to black one at a time
- *   if (gst_video_frame_map (&vframe, video_info, video_buffer)) {
+ *   if (gst_video_frame_map (&vframe, video_info, video_buffer, GST_MAP_WRITE)) {
  *     guint8 *pixels = GST_VIDEO_FRAME_PLANE_DATA (vframe, 0);
  *     guint stride = GST_VIDEO_FRAME_PLANE_STRIDE (vframe, 0);
  *     guint pixel_stride = GST_VIDEO_FRAME_COMP_PSTRIDE (vframe, 0);
@@ -211,6 +211,8 @@ invalid_size:
  *         memset (pixel, 0, pixel_stride);
  *       }
  *     }
+ *
+ *     gst_video_frame_unmap (&vframe);
  *   }
  *   ...
  * ]|