From 4b94485efd590106648bfb193893a1075602158d Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Sun, 26 Apr 2020 11:31:11 +0200
Subject: Doc: more detail about fl_clip_region() when drawing elsewhere than
 on the display

---
 FL/fl_draw.H | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/FL/fl_draw.H b/FL/fl_draw.H
index 9ae32f3c4..7f1a63451 100644
--- a/FL/fl_draw.H
+++ b/FL/fl_draw.H
@@ -173,12 +173,18 @@ inline void fl_restore_clip() {
  Replaces the top of the clipping stack with a clipping region of any shape.
  
  Fl_Region is an operating system specific type.
+ \note This function is mostly intended for internal use by the FLTK library
+ when drawing to the display.
+ Its effect can be null if the current drawing surface is not the display.
  \param[in] r clipping region
  */
 inline void fl_clip_region(Fl_Region r) { fl_graphics_driver->clip_region(r); }
 
 /**
  Returns the current clipping region.
+ \note This function is mostly intended for internal use by the FLTK library
+ when drawing to the display.
+ Its return value can be always NULL if the current drawing surface is not the display.
  */
 inline Fl_Region fl_clip_region() { return fl_graphics_driver->clip_region(); }
 
-- 
cgit v1.2.3