Fixing UI_update_last_created/give_last_created documentation

Author: marzojr

seventowers/usecode/intrinsics/defs/give_last_created.dat

@@ -1,3 +1,3 @@
 <?php
-	code_block("UI_give_last_created(object obj)\nobj->give_last_created()");
+	code_block("bool UI_give_last_created(object obj)\nbool obj->give_last_created()");
 ?>

seventowers/usecode/intrinsics/defs/update_last_created.dat

@@ -1,14 +1,3 @@
 <?php
-	add_box(
-		array(
-				"BG SPECIFIC",
-				inline_code("int UI_update_last_created(int pos[])")
-			)
-		);
-	add_box(
-		array(
-				"SI SPECIFIC",
-				inline_code("object UI_update_last_created(int pos[])")
-			)
-		);
+	code_block("bool UI_update_last_created(int pos[])");
 ?>

seventowers/usecode/intrinsics/update_last_created.dat

@@ -9,24 +9,18 @@
 	text("The location can be specified by arrays ranging from 1 to 4 components. The meaning of these components is as follows:");
 	add_list(
 		array(
-				"1 element: the object will be deleted (equivalent to '" . inline_code("remove_item") . "' intrinsic);",
-				"2 elements: mean a (x, y) location. The object is placed at z = 0 in the current game map;",
-				"3 elements: mean a (x, y, z) location. The object is placed in the current game map;",
-				"4 elements: mean a (x, y, z, map) location. The object is placed in the specified map unless it is -1, in which case it will be placed in the current game map.",
+				"1 element: the object will be deleted (equivalent to '" . inline_code("remove_item") . "' intrinsic). The original usecode generally passed '" . inline_code("-358") . "' for this parameter, but this is likely just by convention as any value works.",
+				"2 elements: mean a (x, y) location. In Exult, the object is placed at " . inline_code("z = 0") . " in the current game map; in the original games, nothing is done and the update fails.",
+				"3 elements: mean a (x, y, z) location. The object is placed in the current game map. In Exult, this always succeeds; it could fail in the original games.",
+				"4 elements: mean a (x, y, z, map) location. Exult-only. The object is placed in the specified map unless it is -1, in which case it will be placed in the current game map.",
 			), true, 4
 		);
 	make_header("Return", 0);
-	text("Zero if the 'last created' stack is empty and '1' if the object was deleted. Otherwise:");
+	text("For the 1-element version, $false if the 'last created' stack is empty or $true if the object was deleted. Otherwise, returns $true if object was successfully placed on the map, $false otherwise.");
 	add_box(
 		array(
-				"BG SPECIFIC",
-				"If successful, returns 1."
-			)
-		);
-	add_box(
-		array(
-				"SI SPECIFIC",
-				"If successful, returns a reference to the object."
+			"NOTES ABOUT ORIGINAL GAMES",
+			"In the original games, the function could fail to place the item in the map. In this case, it would try to delete an unrelated on-screen object flagged with the TEMPORARY flag to make room for the updated object and retry. The retry could fail again, in which case the update fails; otherwise, it would succeed. This means that, on occasion, using this function could cause objects to be deleted in the original."
 			)
 		);
 ?>