Merge branch 'develop' into testing

Author: myk002

docs/changelog.txt

@@ -52,10 +52,26 @@ Template for new versions:
 # Future
 
 ## New Tools
-- `preserve-rooms`: manage room assignments for off-map units and noble roles. reserves rooms owned by traveling units and reinstates their ownership when they return to the site. also allows you to assign rooms to noble/administrator roles, and the rooms will be automatically assigned whenever the holder of the role changes
 
 ## New Features
 
+## Fixes
+
+## Misc Improvements
+
+## Documentation
+
+## API
+
+## Lua
+
+## Removed
+
+# 50.13-r5
+
+## New Tools
+- `preserve-rooms`: manage room assignments for off-map units and noble roles. reserves rooms owned by traveling units and reinstates their ownership when they return to the site. also allows you to assign rooms to noble/administrator roles, and the rooms will be automatically assigned whenever the holder of the role changes
+
 ## Fixes
 - prevent hang when buildings in zones are destroyed in the case where the buildings were not added to the zone in the same order that they were created (uncommon)
 - `buildingplan`: improved performance in forts with large numbers of items
@@ -67,7 +83,7 @@ Template for new versions:
 - `strangemood`: manually-triggered Macabre moods will now correctly request up to 3 bones/remains for the primary component instead of only 1
 - `regrass`: no longer add all compatible grass types when using ``--force`` without ``--new``
 - `regrass`: ``--mud`` now converts muddy slade to grass, consistent with normal DF behavior
-- `gui/pathable`: fix hang when showing trade depot wagon access and a trade depot is submerged under water
+- `gui/pathable`: fix hang when showing trade depot wagon access and a trade depot is submerged under water or magma
 - `gui/pathable`: fix representation of wagon paths over stairs and through doors
 - DFHack state for a site is now properly saved when retiring a fort
 - `gui/teleport`: fix issue when teleporting units that are not prone, resulting in later issues with phantom "cannot build here: unit blocking tile" messages
@@ -81,6 +97,8 @@ Template for new versions:
 
 ## Documentation
 - add documentation for ``dfhack.items.findType(string)`` and ``dfhack.items.findSubtype(string)``
+- `modding-guide`: added examples for reading and writing various types of persistent storage
+- `modding-guide`: updated all code snippets for greater clarity
 
 ## API
 - ``Units``: new ``isWildlife`` and ``isAgitated`` property checks

docs/dev/Lua API.rst

@@ -2100,9 +2100,10 @@ Items module
   ``df.global.game.main_interface.trade.mer``), then the value is modified by civ
   properties and any trade agreements that might be in effect.
 
-* ``dfhack.items.createItem(unit, item_type, item_subtype, mat_type, mat_index, growth_print, no_floor)``
+* ``dfhack.items.createItem(unit, item_type, item_subtype, mat_type, mat_index, no_floor)``
 
-  Creates an item, similar to the `createitem` plugin.
+  Creates an item, similar to the `createitem` plugin. Returns a list of created
+  ``df.item`` objects.
 
 * ``dfhack.items.checkMandates(item)``