diff --git a/doc/images/qtcreator-refactoring-replace.png b/doc/images/qtcreator-refactoring-replace.png
index 4c62c5f0656377d3e1b769d023b674c10afc8ce1..d0fa9dec4754a34ea4fabb9701ca1c611d3df290 100644
Binary files a/doc/images/qtcreator-refactoring-replace.png and b/doc/images/qtcreator-refactoring-replace.png differ
diff --git a/doc/src/editors/creator-editors.qdoc b/doc/src/editors/creator-editors.qdoc
index 9b55aad11a377b4d299a7a732b8607c5866e0ba0..26e77776ed3201b8726ec6d2bc994cef209b785a 100644
--- a/doc/src/editors/creator-editors.qdoc
+++ b/doc/src/editors/creator-editors.qdoc
@@ -1956,6 +1956,9 @@
 
     \section1 Renaming Symbols
 
+    You can rename symbols in all files in a project. When you rename a class,
+    you can also change filenames that match the class name.
+
     To rename a specific symbol in a Qt project:
 
     \list 1
@@ -1973,15 +1976,18 @@
             \image qtcreator-refactoring-replace.png
 
         \li To replace all selected instances, enter the name of the new symbol
-            in the \uicontrol {Replace with} text box and click
-            \uicontrol Replace.
+            in the \uicontrol {Replace with} text box.
 
             To omit an instance, uncheck the check-box next to the instance.
 
+        \li If the symbol is a class, select the \uicontrol {Rename files} check
+            box to also change the filenames that match the class name.
+
+        \li  Select \uicontrol Replace.
+
             \note This action replaces all selected instances of the symbol in
             all files listed in the \uicontrol {Search Results} pane. You cannot
             undo this action.
-
     \endlist
 
     \note Renaming local symbols does not open the \uicontrol {Search Results}