diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index bd09d915d8..2827fd66ad 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2003-06-23  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/Makefile.am (HTML_IMAGES): Add RTL variants of stock icons.
+
+	* gtk/tmpl/gtkstock.sgml: Document RTL variants of stock icons. 
+
 2003-06-22  Matthias Clasen  <matthias@localhost.localdomain>
 
 	* gdk-pixbuf/tmpl/gdk-pixbuf.sgml: Typo fix.
diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 80a4ca53fb..b4f64f6884 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -119,6 +119,7 @@ HTML_IMAGES = \
 	$(top_srcdir)/gtk/stock-icons/stock_index_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_text_italic_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_jump_to_24.png		\
+	$(top_srcdir)/gtk/stock-icons/stock_jump_to_rtl_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_align_center_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_align_justify_24.png	\
 	$(top_srcdir)/gtk/stock-icons/stock_align_left_24.png		\
@@ -135,13 +136,15 @@ HTML_IMAGES = \
 	$(top_srcdir)/gtk/stock-icons/stock_properties_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_exit_24.png			\
 	$(top_srcdir)/gtk/stock-icons/stock_redo_24.png			\
+	$(top_srcdir)/gtk/stock-icons/stock_redo_rtl_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_refresh_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_remove_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_revert_24.png		\
+	$(top_srcdir)/gtk/stock-icons/stock_revert_rtl_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_save_24.png			\
 	$(top_srcdir)/gtk/stock-icons/stock_save_as_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_colorselector_24.png	\
-	$(top_srcdir)/gtk/stock-icons/stock_color_picker_25.png	\
+	$(top_srcdir)/gtk/stock-icons/stock_color_picker_25.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_font_24.png			\
 	$(top_srcdir)/gtk/stock-icons/stock_sort_ascending_24.png	\
 	$(top_srcdir)/gtk/stock-icons/stock_sort_descending_24.png	\
@@ -149,8 +152,10 @@ HTML_IMAGES = \
 	$(top_srcdir)/gtk/stock-icons/stock_stop_24.png			\
 	$(top_srcdir)/gtk/stock-icons/stock_text_strikethrough_24.png	\
 	$(top_srcdir)/gtk/stock-icons/stock_undelete_24.png		\
+	$(top_srcdir)/gtk/stock-icons/stock_undelete_rtl_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_text_underline_24.png	\
 	$(top_srcdir)/gtk/stock-icons/stock_undo_24.png			\
+	$(top_srcdir)/gtk/stock-icons/stock_undo_rtl_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_yes_20.png			\
 	$(top_srcdir)/gtk/stock-icons/stock_zoom_1_24.png		\
 	$(top_srcdir)/gtk/stock-icons/stock_zoom_fit_24.png		\
diff --git a/docs/reference/gtk/tmpl/gtkstock.sgml b/docs/reference/gtk/tmpl/gtkstock.sgml
index 122b84d179..d7c9d1e4d4 100644
--- a/docs/reference/gtk/tmpl/gtkstock.sgml
+++ b/docs/reference/gtk/tmpl/gtkstock.sgml
@@ -23,7 +23,8 @@ linkend="gtk-Themeable-Stock-Images">GtkIconFactory</link> for
 more information on stock icons. The connection between a
 #GtkStockItem and stock icons is purely conventional (by virtue of
 using the same stock ID); it's possible to register a stock item but
-no icon, and vice versa.
+no icon, and vice versa. Stock icons may have a RTL variant which gets
+used for right-to-left locales. 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -284,6 +285,8 @@ The "Bottom" item.
 <para>
 The "First" item.
 <inlinegraphic fileref="stock_first_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_last_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -292,6 +295,8 @@ The "First" item.
 <para>
 The "Last" item.
 <inlinegraphic fileref="stock_last_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_first_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -308,6 +313,8 @@ The "Top" item.
 <para>
 The "Back" item.
 <inlinegraphic fileref="stock_left_arrow_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_right_arrow_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -324,6 +331,8 @@ The "Down" item.
 <para>
 The "Forward" item.
 <inlinegraphic fileref="stock_right_arrow_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_left_arrow_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -372,6 +381,8 @@ The "Italic" item.
 <para>
 The "Jump to" item.
 <inlinegraphic fileref="stock_jump_to_24.png" format="PNG"></inlinegraphic>
+RTL-variant 
+<inlinegraphic fileref="stock_jump_to_rtl_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -500,6 +511,8 @@ The "Quit" item.
 <para>
 The "Redo" item.
 <inlinegraphic fileref="stock_redo_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_redo_rtl_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -524,6 +537,8 @@ The "Remove" item.
 <para>
 The "Revert" item.
 <inlinegraphic fileref="stock_revert_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_revert_rtl_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -604,6 +619,8 @@ The "Strikethrough" item.
 <para>
 The "Undelete" item.
 <inlinegraphic fileref="stock_undelete_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_undelete_rtl_24.png" format="PNG"></inlinegraphic>
 </para>
 
 
@@ -620,6 +637,8 @@ The "Underline" item.
 <para>
 The "Undo" item.
 <inlinegraphic fileref="stock_undo_24.png" format="PNG"></inlinegraphic>
+RTL variant
+<inlinegraphic fileref="stock_undo_rtl_24.png" format="PNG"></inlinegraphic>
 </para>