diff --git a/ChangeLog b/ChangeLog
index ada5e1b177..7deb8a78ac 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2008-05-29  Sven Neumann  <sven@gimp.org>
+
+	* themes/Default/images/Makefile.am (STOCK_TOOL_IMAGES): 
+	* themes/Default/images/tools/stock-tool-polygon-select-16.png
+	* themes/Default/images/tools/stock-tool-polygon-select-22.png:
+	removed unused tool icon.
+
+	* libgimpwidgets/gimpstock.[ch]: don't register
+	GIMP_STOCK_TOOL_POLYGON_SELECT.
+
+	* libgimpwidgets/gimphruler.c
+	* libgimpwidgets/gimpvruler.c: added missing API docs.
+
 2008-05-29  Sven Neumann  <sven@gimp.org>
 
 	* plug-ins/common/blur-gauss-selective.c (matrixmult_mmx): avoid
diff --git a/libgimpwidgets/gimphruler.c b/libgimpwidgets/gimphruler.c
index c487c6cf78..229b3d3155 100644
--- a/libgimpwidgets/gimphruler.c
+++ b/libgimpwidgets/gimphruler.c
@@ -87,7 +87,15 @@ gimp_hruler_init (GimpHRuler *hruler)
   widget->requisition.height = widget->style->ythickness * 2 + RULER_HEIGHT;
 }
 
-
+/**
+ * gimp_hruler_new:
+ *
+ * Creates a new horizontal ruler.
+ *
+ * Return value: a new #GimpHRuler widget.
+ *
+ * Since: GIMP 2.8
+ **/
 GtkWidget*
 gimp_hruler_new (void)
 {
diff --git a/libgimpwidgets/gimpstock.c b/libgimpwidgets/gimpstock.c
index 8001c2bf2a..f5975b9ba3 100644
--- a/libgimpwidgets/gimpstock.c
+++ b/libgimpwidgets/gimpstock.c
@@ -313,7 +313,6 @@ static const GtkStockItem gimp_stock_items[] =
   { GIMP_STOCK_TOOL_PENCIL,              NULL,        0, 0, LIBGIMP_DOMAIN },
   { GIMP_STOCK_TOOL_PERSPECTIVE,  N_("_Transform"),   0, 0, LIBGIMP_DOMAIN },
   { GIMP_STOCK_TOOL_PERSPECTIVE_CLONE,   NULL,        0, 0, LIBGIMP_DOMAIN },
-  { GIMP_STOCK_TOOL_POLYGON_SELECT,      NULL,        0, 0, LIBGIMP_DOMAIN },
   { GIMP_STOCK_TOOL_POSTERIZE,           NULL,        0, 0, LIBGIMP_DOMAIN },
   { GIMP_STOCK_TOOL_RECT_SELECT,         NULL,        0, 0, LIBGIMP_DOMAIN },
   { GIMP_STOCK_TOOL_ROTATE,       N_("_Rotate"),      0, 0, LIBGIMP_DOMAIN },
@@ -464,7 +463,6 @@ gimp_stock_button_pixbufs[] =
   { GIMP_STOCK_TOOL_PENCIL,              stock_tool_pencil_22              },
   { GIMP_STOCK_TOOL_PERSPECTIVE,         stock_tool_perspective_22         },
   { GIMP_STOCK_TOOL_PERSPECTIVE_CLONE,   stock_tool_perspective_clone_22   },
-  { GIMP_STOCK_TOOL_POLYGON_SELECT,      stock_tool_polygon_select_22      },
   { GIMP_STOCK_TOOL_POSTERIZE,           stock_tool_posterize_22           },
   { GIMP_STOCK_TOOL_RECT_SELECT,         stock_tool_rect_select_22         },
   { GIMP_STOCK_TOOL_ROTATE,              stock_tool_rotate_22              },
@@ -627,7 +625,6 @@ gimp_stock_menu_pixbufs[] =
   { GIMP_STOCK_TOOL_PENCIL,              stock_tool_pencil_16              },
   { GIMP_STOCK_TOOL_PERSPECTIVE,         stock_tool_perspective_16         },
   { GIMP_STOCK_TOOL_PERSPECTIVE_CLONE,   stock_tool_perspective_clone_16   },
-  { GIMP_STOCK_TOOL_POLYGON_SELECT,      stock_tool_polygon_select_16      },
   { GIMP_STOCK_TOOL_POSTERIZE,           stock_tool_posterize_16           },
   { GIMP_STOCK_TOOL_RECT_SELECT,         stock_tool_rect_select_16         },
   { GIMP_STOCK_TOOL_ROTATE,              stock_tool_rotate_16              },
diff --git a/libgimpwidgets/gimpstock.h b/libgimpwidgets/gimpstock.h
index d194eaa506..c402e22989 100644
--- a/libgimpwidgets/gimpstock.h
+++ b/libgimpwidgets/gimpstock.h
@@ -130,7 +130,6 @@ G_BEGIN_DECLS
 #define GIMP_STOCK_TOOL_PENCIL              "gimp-tool-pencil"
 #define GIMP_STOCK_TOOL_PERSPECTIVE         "gimp-tool-perspective"
 #define GIMP_STOCK_TOOL_PERSPECTIVE_CLONE   "gimp-tool-perspective-clone"
-#define GIMP_STOCK_TOOL_POLYGON_SELECT      "gimp-tool-polygon-select"
 #define GIMP_STOCK_TOOL_POSTERIZE           "gimp-tool-posterize"
 #define GIMP_STOCK_TOOL_RECT_SELECT         "gimp-tool-rect-select"
 #define GIMP_STOCK_TOOL_ROTATE              "gimp-tool-rotate"
diff --git a/libgimpwidgets/gimpvruler.c b/libgimpwidgets/gimpvruler.c
index cf58ef62e7..2eb4a511e5 100644
--- a/libgimpwidgets/gimpvruler.c
+++ b/libgimpwidgets/gimpvruler.c
@@ -87,13 +87,21 @@ gimp_vruler_init (GimpVRuler *vruler)
   widget->requisition.height = widget->style->ythickness * 2 + 1;
 }
 
+/**
+ * gimp_vruler_new:
+ *
+ * Creates a new vertical ruler.
+ *
+ * Return value: a new #GimpVRuler widget.
+ *
+ * Since: GIMP 2.8
+ **/
 GtkWidget*
 gimp_vruler_new (void)
 {
   return g_object_new (GIMP_TYPE_VRULER, NULL);
 }
 
-
 static gint
 gimp_vruler_motion_notify (GtkWidget      *widget,
                           GdkEventMotion *event)
diff --git a/themes/Default/images/Makefile.am b/themes/Default/images/Makefile.am
index 0acd3d676c..3c41ad35fe 100644
--- a/themes/Default/images/Makefile.am
+++ b/themes/Default/images/Makefile.am
@@ -317,8 +317,6 @@ STOCK_TOOL_IMAGES = \
 	tools/stock-tool-perspective-22.png		\
 	tools/stock-tool-perspective-clone-16.png	\
 	tools/stock-tool-perspective-clone-22.png	\
-	tools/stock-tool-polygon-select-16.png		\
-	tools/stock-tool-polygon-select-22.png		\
 	tools/stock-tool-posterize-16.png		\
 	tools/stock-tool-posterize-22.png		\
 	tools/stock-tool-rect-select-16.png		\
diff --git a/themes/Default/images/tools/stock-tool-polygon-select-16.png b/themes/Default/images/tools/stock-tool-polygon-select-16.png
deleted file mode 100644
index 568639dc0a..0000000000
Binary files a/themes/Default/images/tools/stock-tool-polygon-select-16.png and /dev/null differ
diff --git a/themes/Default/images/tools/stock-tool-polygon-select-22.png b/themes/Default/images/tools/stock-tool-polygon-select-22.png
deleted file mode 100644
index f6efd135fa..0000000000
Binary files a/themes/Default/images/tools/stock-tool-polygon-select-22.png and /dev/null differ