diff --git a/FL/Fl_Image.H b/FL/Fl_Image.H
index 8b8b433e8..7c6336542 100644
--- a/FL/Fl_Image.H
+++ b/FL/Fl_Image.H
@@ -287,9 +287,14 @@ public:
(upper-left corner) of the image offset by the \c cx
and \c cy arguments.
- In other words: fl_push_clip(X,Y,W,H) is applied,
- the image is drawn with its upper-left corner at X-cx,Y-cy and its own width and height,
- fl_pop_clip() is applied.
+ Another way to see what part of the image gets drawn and where, is to consider this alternative writing producing the same output:
+ \verbatim
+ fl_push_clip(X,Y,W,H);
+ this->draw(X - cx, Y - cy);
+ fl_pop_clip();
+ \endverbatim
+ Repeated calls to this member function with the same image but varying W, H, cx, or cy arguments
+ may be more efficiently processed using the above alternative writing.
*/
virtual void draw(int X, int Y, int W, int H, int cx=0, int cy=0); // platform dependent
/**