diff --git a/docs/plugins/3dveins.rst b/docs/plugins/3dveins.rst index f71a14343..96fbcf836 100644 --- a/docs/plugins/3dveins.rst +++ b/docs/plugins/3dveins.rst @@ -25,10 +25,10 @@ Example 3dveins -New veins are generated using 3D Perlin noise in order to produce a layout that -flows smoothly between z-levels. The vein distribution is based on the world -seed, so running the command for the second time should produce no change. It is -best to run it just once immediately after embark. +New veins are generated using natural-looking 3D Perlin noise in order to +produce a layout that flows smoothly between z-levels. The vein distribution is +based on the world seed, so running the command for the second time should +produce no change. It is best to run it just once immediately after embark. This command is intended as only a cosmetic change, so it takes care to exactly preserve the mineral counts reported by ``prospect all``. The amounts of layer diff --git a/docs/plugins/add-spatter.rst b/docs/plugins/add-spatter.rst index 873bd761f..1ce32fcbe 100644 --- a/docs/plugins/add-spatter.rst +++ b/docs/plugins/add-spatter.rst @@ -12,3 +12,6 @@ names starting with ``SPATTER_ADD_``, so there are no commands to run to use it. These reactions will then produce contaminants on items instead of improvements. The contaminants are immune to being washed away by water or destroyed by `clean`. + +You must have a mod installed that adds the appropriate tokens in order for this +plugin to do anything. diff --git a/docs/plugins/autohauler.rst b/docs/plugins/autohauler.rst index a71d3ed02..08c84327a 100644 --- a/docs/plugins/autohauler.rst +++ b/docs/plugins/autohauler.rst @@ -5,7 +5,7 @@ autohauler :summary: Automatically manage hauling labors. :tags: fort auto labors -Similar to `autolabor`, but instead of managing all labors, ``autohauler`` only +Similar to `autolabor`, but instead of managing all labors, autohauler only addresses hauling labors, leaving the assignment of skilled labors entirely up to you. You can use the in-game `manipulator` UI or an external tool like Dwarf Therapist to do so. @@ -19,7 +19,7 @@ assignment, with most skilled labors only being assigned to just a few dwarves and almost every non-military dwarf having at least one skilled labor assigned. Autohauler allows a skill to be used as a flag to exempt a dwarf from -``autohauler``'s effects. By default, this is the unused ALCHEMIST labor, but it +autohauler's effects. By default, this is the unused ALCHEMIST labor, but it can be changed by the user. Usage diff --git a/docs/plugins/autolabor.rst b/docs/plugins/autolabor.rst index ed39c2666..861655ab4 100644 --- a/docs/plugins/autolabor.rst +++ b/docs/plugins/autolabor.rst @@ -45,10 +45,11 @@ and manager. Hunting is never assigned without a butchery, and fishing is never assigned without a fishery. -For each labor, a preference order is calculated based on skill, biased against -masters of other trades and excluding those who can't do the job. The labor is -then added to the best dwarves for that labor, then to additional -dwarfs that meet any of these conditions: +For each labor, a preference order is calculated based on skill, excluding those +who can't do the job. Dwarves who are masters of particular skills are +deprioritized in the preference list for other skills. The labor is then added +to the best dwarves for that labor, then to additional dwarfs that +meet any of these conditions: * The dwarf is idle and there are no idle dwarves assigned to this labor * The dwarf has non-zero skill associated with the labor diff --git a/docs/plugins/autonestbox.rst b/docs/plugins/autonestbox.rst index 9d5683f2b..27074fe1c 100644 --- a/docs/plugins/autonestbox.rst +++ b/docs/plugins/autonestbox.rst @@ -5,13 +5,13 @@ autonestbox :summary: Auto-assign egg-laying female pets to nestbox zones. :tags: fort auto animals -To use this feature, you must create pen/pasture zones above nestboxes. If the -pen is bigger than 1x1, the nestbox must be in the top left corner. Only 1 unit -will be assigned per pen, regardless of the size. Egg layers who are also -grazers will be ignored, since confining them to a 1x1 pasture is not a good -idea. Only tame and domesticated own units are processed since pasturing -half-trained wild egg layers could destroy your neat nestbox zones when they -revert to wild. +To use this feature, you must create pen/pasture zones on the same tiles as +built nestboxes. If the pen is bigger than 1x1, the nestbox must be in the top +left corner. Only 1 unit will be assigned per pen, regardless of the size. Egg +layers who are also grazers will be ignored, since confining them to a 1x1 +pasture is not a good idea. Only tame and domesticated own units are processed +since pasturing half-trained wild egg layers could destroy your neat nestbox +zones when they revert to wild. Note that the age of the units is not checked, so you might get some egg-laying kids assigned to the nestbox zones. Most birds grow up quite fast, though, so