diff --git a/doc/lua_api.txt b/doc/lua_api.txt
index 7fa8870aa..6c06d558f 100644
--- a/doc/lua_api.txt
+++ b/doc/lua_api.txt
@@ -1254,6 +1254,8 @@ Environment access:
 minetest.set_node(pos, node)
 minetest.add_node(pos, node): alias set_node(pos, node)
 ^ Set node at position (node = {name="foo", param1=0, param2=0})
+minetest.swap_node(pos, node)
+^ Set node at position, but don't remove metadata
 minetest.remove_node(pos)
 ^ Equivalent to set_node(pos, "air")
 minetest.get_node(pos)