From 4c095a76c03a5a233c5bd54fccea98a80316c8cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Peter=20W=C3=BCrtz?= <pwuertz@gmail.com>
Date: Fri, 21 Apr 2017 12:21:54 +0200
Subject: [PATCH] Add docstring for UMat::handle

---
 modules/core/include/opencv2/core/mat.hpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/modules/core/include/opencv2/core/mat.hpp b/modules/core/include/opencv2/core/mat.hpp
index 0a74e72817..d8adaeed04 100644
--- a/modules/core/include/opencv2/core/mat.hpp
+++ b/modules/core/include/opencv2/core/mat.hpp
@@ -2464,6 +2464,10 @@ public:
     UMat& operator = (UMat&& m);
 #endif
 
+    /*! Returns the OpenCL buffer handle on which UMat operates on.
+        The UMat instance should be kept alive during the use of the handle to prevent the buffer to be
+        returned to the OpenCV buffer pool.
+     */
     void* handle(int accessFlags) const;
     void ndoffset(size_t* ofs) const;