From: Paramat <paramat@users.noreply.github.com>
Date: Mon, 30 Sep 2019 20:34:43 +0000 (+0100)
Subject: Document node drop tool filtering by string matching as deprecated (#9009)
X-Git-Tag: 5.1.0~15
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=653d7b8112ccac491daf42a2b6b73ff10612ad68;p=oweals%2Fminetest.git

Document node drop tool filtering by string matching as deprecated (#9009)
---

diff --git a/doc/lua_api.txt b/doc/lua_api.txt
index b4cf65e54..bbd11c867 100644
--- a/doc/lua_api.txt
+++ b/doc/lua_api.txt
@@ -6526,7 +6526,9 @@ Used by `minetest.register_node`.
         drop = "",
         -- Name of dropped item when dug.
         -- Default dropped item is the node itself.
-        -- Using a table allows multiple items, drop chances and tool filtering:
+        -- Using a table allows multiple items, drop chances and tool filtering.
+        -- Tool filtering was undocumented until recently, tool filtering by string
+        -- matching is deprecated.
         drop = {
             max_items = 1,
             -- Maximum number of item lists to drop.
@@ -6557,7 +6559,8 @@ Used by `minetest.register_node`.
                 },
                 {
                     -- Only drop if using a tool whose name contains
-                    -- "default:shovel_".
+                    -- "default:shovel_" (this tool filtering by string matching
+                    -- is deprecated).
                     tools = {"~default:shovel_"},
                     rarity = 2,
                     -- The item list dropped.