diff --git a/doc/classes/Image.xml b/doc/classes/Image.xml
index 83c1bad8e3..54eaf6cc7a 100644
--- a/doc/classes/Image.xml
+++ b/doc/classes/Image.xml
@@ -318,7 +318,7 @@
 			<return type="void">
 			</return>
 			<description>
-				Locks the data and prevents changes.
+				Locks the data for writing access.
 			</description>
 		</method>
 		<method name="normalmap_to_xy">
@@ -379,10 +379,10 @@
 				Sets the [Color] of the pixel at [code](x, y)[/code] if the image is locked. Example:
 				[codeblock]
 				var img = Image.new()
-				img.unlock()
-				img.set_pixel(x, y, color) # Does not have an effect
 				img.lock()
 				img.set_pixel(x, y, color) # Works
+				img.unlock()
+				img.set_pixel(x, y, color) # Does not have an effect
 				[/codeblock]
 			</description>
 		</method>
@@ -404,7 +404,7 @@
 			<return type="void">
 			</return>
 			<description>
-				Unlocks the data for writing access.
+				Unlocks the data and prevents changes.
 			</description>
 		</method>
 	</methods>