document the widget parameter

diff --git a/Changes b/Changes
index f8fcf13fcc853de0f5824a93dad75570147c1169..28e9d919f429ea647afd32ac888db70d514400d2 100755 (executable)
--- a/Changes
+++ b/Changes
@@ -13,6 +13,9 @@
 - added --incpath and --libpath options to Makefile.PL and also look
   in $ENV{IM_INCPATH} and $ENV{IM_LIBPATH} like Imager.
 
+- document the widget parameter
+  https://rt.cpan.org/Ticket/Display.html?id=32855
+
 0.005 12 Mar 2007
        - 0.005 release
        - added a TODO section to the POD

diff --git a/Screenshot.pm b/Screenshot.pm
index 826f43031c0e45583750bef05d7bd9c79dcf15a7..215eb70ea514a8460010ed78108238cd9d61d2d0 100644 (file)
--- a/Screenshot.pm
+++ b/Screenshot.pm
@@ -182,9 +182,22 @@ the display specified by $ENV{DISPLAY}.
 
 Note: taking a screenshot of a remote display is slow.
 
+=item screenshot widget => I<widget>
+
+=item screenshot widget => I<widget>, display => I<display>
+
+=item screenshot widget => I<widget>, decor => I<capture decorations>
+
+Retrieve a screenshot of a Tk widget, under Win32 or X11, depending on
+how Tk has been built.
+
+If Tk was built for X11 then the display parameter applies.
+
+If Tk was built for Win32 then the decor parameter applies.
+
 =item screenshot
 
-If no C<id> or C<hwnd> parameter is supplied:
+If no C<id>, C<hwnd> or C<widget> parameter is supplied:
 
 =over