From 75ad052ac9debc598789e2221d26afe07e280594 Mon Sep 17 00:00:00 2001
From: jj <john-git@ofjj.net>
Date: Thu, 13 Dec 2012 00:29:56 +0100
Subject: [PATCH] move create-items out of devel/, add Readme entry

---
 NEWS                                |  2 +-
 Readme.rst                          | 28 ++++++++++++++++++++++++++++
 scripts/{devel => }/create-items.rb |  0
 3 files changed, 29 insertions(+), 1 deletion(-)
 rename scripts/{devel => }/create-items.rb (100%)

diff --git a/NEWS b/NEWS
index 73c205c18..ed6290261 100644
--- a/NEWS
+++ b/NEWS
@@ -25,7 +25,7 @@ DFHack future
     - lever: list and pull fort levers from the dfhack console.
     - stripcaged: mark items inside cages for dumping, eg caged goblin weapons.
     - soundsense-season: writes the correct season to gamelog.txt on world load.
-    - devel/create-items: spawn items
+    - create-items: spawn items
   New GUI scripts:
     - gui/guide-path: displays the cached path for minecart Guide orders.
     - gui/workshop-job: displays inputs of a workshop job and allows tweaking them.
diff --git a/Readme.rst b/Readme.rst
index 150f0d488..2eaa7318e 100644
--- a/Readme.rst
+++ b/Readme.rst
@@ -1942,6 +1942,7 @@ deathcause
 ==========
 Focus a body part ingame, and this script will display the cause of death of
 the creature.
+Also works when selecting units from the 'u'nitlist viewscreen.
 
 lua
 ===
@@ -2004,6 +2005,33 @@ alternatively pass cage IDs as arguments::
 
   stripcaged weapons 25321 34228
 
+create-items
+============
+Spawn arbitrary items under the cursor.
+
+The first argument gives the item category, the second gives the material,
+and the optionnal third gives the number of items to create (defaults to 20).
+
+Currently supported item categories: ``boulder``, ``bar``, ``plant``, ``log``,
+``web``.
+
+Instead of material, using ``list`` makes the script list eligible materials.
+
+The ``web`` item category will create an uncollected cobweb on the floor.
+
+Note that the script does not enforce anything, and will let you create
+boulders of toad blood and stuff like that.
+However the ``list`` mode will only show 'normal' materials.
+
+Exemples::
+
+    create-items boulders COAL_BITUMINOUS 12
+    create-items plant tail_pig
+    create-items log list
+    create-items web CREATURE:SPIDER_CAVE_GIANT:SILK
+    create-items bar CREATURE:CAT:SOAP
+    create-items bar adamantine
+
 =======================
 In-game interface tools
 =======================
diff --git a/scripts/devel/create-items.rb b/scripts/create-items.rb
similarity index 100%
rename from scripts/devel/create-items.rb
rename to scripts/create-items.rb