Document inactive block behaviour (#447)

37 files changed, 43 insertions, 9 deletions

diff --git a/mesecons_blinkyplant/doc/blinkyplant/description.html b/mesecons_blinkyplant/doc/blinkyplant/description.html
index 2a7db48..0d987a5 100644
--- a/mesecons_blinkyplant/doc/blinkyplant/description.html
+++ b/mesecons_blinkyplant/doc/blinkyplant/description.html
@@ -1 +1,2 @@
 The blinky plants toggles between on and off state every three seconds. Can be used to make clocks. Also works after having restarted the game.
+It stops blinking in an inactive block, then starts again when the block becomes active.
diff --git a/mesecons_commandblock/doc/commandblock/description.html b/mesecons_commandblock/doc/commandblock/description.html
index 405b7e5..9ba7ce5 100644
--- a/mesecons_commandblock/doc/commandblock/description.html
+++ b/mesecons_commandblock/doc/commandblock/description.html
@@ -1 +1,2 @@
 There is no crafting recipe as this should only be available for server admins. Quite similar to the Minecraft counterpart. Executes server commands.
+It works in inactive blocks.
diff --git a/mesecons_delayer/doc/delayer/description.html b/mesecons_delayer/doc/delayer/description.html
index f3a5280..966d729 100644
--- a/mesecons_delayer/doc/delayer/description.html
+++ b/mesecons_delayer/doc/delayer/description.html
@@ -1 +1 @@
-The delayer delays the signal from the input for a determined time. The time can be set by punching the delayer. Possible delays are: 0.1 seconds, 0.3 seconds, 0.5 seconds and 1 second. You may try to use it for creating songs with the noteblock.
+The delayer delays the signal from the input for a determined time. The time can be set by punching the delayer. Possible delays are: 0.1 seconds, 0.3 seconds, 0.5 seconds and 1 second. You may try to use it for creating songs with the noteblock. It works in unloaded blocks.
diff --git a/mesecons_detector/doc/nodedetector/description.html b/mesecons_detector/doc/nodedetector/description.html
index be1582e..ee8c09d 100644
--- a/mesecons_detector/doc/nodedetector/description.html
+++ b/mesecons_detector/doc/nodedetector/description.html
@@ -5,3 +5,4 @@ respond with the detected nodename or you can send any other string and it will
 set this string as the node to scan for.
 Nodenames must include the mod they reside in, so for instance default:dirt, not just dirt.
 The distance parameter specifies how many blocks are between the node detector and the node to detect.
+Automatic scanning with Mesecons output only works when the detector is in an active block, but Digilines queries always work.
diff --git a/mesecons_detector/doc/objectdetector/description.html b/mesecons_detector/doc/objectdetector/description.html
index bb88856..a928434 100644
--- a/mesecons_detector/doc/objectdetector/description.html
+++ b/mesecons_detector/doc/objectdetector/description.html
@@ -2,3 +2,4 @@ The object detector is a receptor. It changes its state when a player approaches
 Right-click it to set a name to scan for.
 You can also search for comma-separated lists of players where the detector gets activated if any of the names in the list are found.
 It can also receive digiline signals which are the name to scan for on the specified channel in the right-click menu.
+Automatic scanning with Mesecons output only works when the detector is in an active block, but Digilines queries always work.
diff --git a/mesecons_extrawires/doc/corner/description.html b/mesecons_extrawires/doc/corner/description.html
index 92de8b0..fc420d1 100644
--- a/mesecons_extrawires/doc/corner/description.html
+++ b/mesecons_extrawires/doc/corner/description.html
@@ -1 +1 @@
-Insulated corners are conductors that only conduct between the inputs (also not up or down). When placing they always point to the left in direction of your vision.
+Insulated corners are conductors that only conduct between the inputs (also not up or down). When placing they always point to the left in direction of your vision. Like uninsulated wires, they work through unloaded blocks.
diff --git a/mesecons_extrawires/doc/crossing/description.html b/mesecons_extrawires/doc/crossing/description.html
index aa4cf25..5f02382 100644
--- a/mesecons_extrawires/doc/crossing/description.html
+++ b/mesecons_extrawires/doc/crossing/description.html
@@ -1 +1 @@
-Insulated crossing are conductors that conduct two signals between the opposing sides, the signals are insulated to each other.
+Insulated crossing are conductors that conduct two signals between the opposing sides, the signals are insulated to each other. Like uninsulated wires, they work through unloaded blocks.
diff --git a/mesecons_extrawires/doc/mese/description.html b/mesecons_extrawires/doc/mese/description.html
index 1a14864..b29e92c 100644
--- a/mesecons_extrawires/doc/mese/description.html
+++ b/mesecons_extrawires/doc/mese/description.html
@@ -1 +1 @@
-The basic prerequesite for mesecons, can be crafted into wires and other stuff. Have a look at the <a href="http://wiki.minetest.net/Mese">Minetest Wiki</a> for more information. Mese is a conductor. It conducts in all six directions: Up/Down/Left/Right/Forward/Backward
+The basic prerequesite for mesecons, can be crafted into wires and other stuff. Have a look at the <a href="http://wiki.minetest.net/Mese">Minetest Wiki</a> for more information. Mese is a conductor. It conducts in all six directions: Up/Down/Left/Right/Forward/Backward. Like horizontal wires, Mese conduction works through unloaded blocks.
diff --git a/mesecons_extrawires/doc/tjunction/description.html b/mesecons_extrawires/doc/tjunction/description.html
index f655a5d..647bba6 100644
--- a/mesecons_extrawires/doc/tjunction/description.html
+++ b/mesecons_extrawires/doc/tjunction/description.html
@@ -1 +1 @@
-Insulated T-Junctions are conductors that only conduct between the inputs (also not up or down).
+Insulated T-Junctions are conductors that only conduct between the inputs (also not up or down). Like uninsulated wires, they work through unloaded blocks.
diff --git a/mesecons_extrawires/doc/vertical/description.html b/mesecons_extrawires/doc/vertical/description.html
index df09b94..8508542 100644
--- a/mesecons_extrawires/doc/vertical/description.html
+++ b/mesecons_extrawires/doc/vertical/description.html
@@ -1 +1 @@
-Vertical Mesecons only conduct up and down. Plates appear at the ends, at that place they also conduct to the side.
+Vertical Mesecons only conduct up and down. Plates appear at the ends, at that place they also conduct to the side. Like horizontal wires, they work through unloaded blocks.
diff --git a/mesecons_fpga/doc/fpga/description.html b/mesecons_fpga/doc/fpga/description.html
index 95177b2..a4cbeed 100644
--- a/mesecons_fpga/doc/fpga/description.html
+++ b/mesecons_fpga/doc/fpga/description.html
@@ -1,5 +1,6 @@
 FPGAs can be used to chain multiple logic gates together in a compact manner.
 They come with 4 I/O ports and 10 internal registers,
-which can then be connected with each other to form logic circuits.<br />
+which can then be connected with each other to form logic circuits.
+They work fine in unloaded blocks.<br />
 Supported gate types: <b>AND</b>, <b>OR</b>, <b>NOT</b>, <b>XOR</b>, <b>NAND</b>, <b>XNOR</b>, <b>Buffer</b> (=)<br />
 I/O ports: <b>A B C D</b>; Registers: numbered <b>0</b> to <b>9</b>
diff --git a/mesecons_gates/doc/and/description.html b/mesecons_gates/doc/and/description.html
index 528839c..e8aff91 100644
--- a/mesecons_gates/doc/and/description.html
+++ b/mesecons_gates/doc/and/description.html
@@ -1 +1,2 @@
 AND gates power their output if both inputs (from left and right) are powered.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/diode/description.html b/mesecons_gates/doc/diode/description.html
index 5f82706..b96aced 100644
--- a/mesecons_gates/doc/diode/description.html
+++ b/mesecons_gates/doc/diode/description.html
@@ -1 +1,2 @@
 Diodes conduct signals in one direction only.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/nand/description.html b/mesecons_gates/doc/nand/description.html
index 69c1d4f..c46a7e1 100644
--- a/mesecons_gates/doc/nand/description.html
+++ b/mesecons_gates/doc/nand/description.html
@@ -1 +1,2 @@
 NAND gates do not power their output if both inputs (from left and right) are powered, but power it in every other case.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/nor/description.html b/mesecons_gates/doc/nor/description.html
index 28d66a4..7d53953 100644
--- a/mesecons_gates/doc/nor/description.html
+++ b/mesecons_gates/doc/nor/description.html
@@ -1 +1,2 @@
 NOR gates only power their output if none of their two inputs is powered. They are basically OR gates with a NOT gate at their output.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/not/description.html b/mesecons_gates/doc/not/description.html
index 7538dc9..5a08423 100644
--- a/mesecons_gates/doc/not/description.html
+++ b/mesecons_gates/doc/not/description.html
@@ -1 +1,2 @@
 NOT gates invert signals, just like a mesecon torch does, but faster. The input is at the opposite side of the output.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/or/description.html b/mesecons_gates/doc/or/description.html
index f7f5539..15d598f 100644
--- a/mesecons_gates/doc/or/description.html
+++ b/mesecons_gates/doc/or/description.html
@@ -1 +1,2 @@
 OR gates power their output if either of their inputs (or both) are powered. You could basically get the same behaviour with two diodes, but OR gates save some space.
+They work in unloaded blocks.
diff --git a/mesecons_gates/doc/xor/description.html b/mesecons_gates/doc/xor/description.html
index f52f3fc..74f8b5f 100644
--- a/mesecons_gates/doc/xor/description.html
+++ b/mesecons_gates/doc/xor/description.html
@@ -1 +1,2 @@
 XOR gates power their output if only one input is powered, they're off if either both or none of the inputs is powered.
+They work in unloaded blocks.
diff --git a/mesecons_hydroturbine/doc/waterturbine/description.html b/mesecons_hydroturbine/doc/waterturbine/description.html
index 4b4e5a0..6153d51 100644
--- a/mesecons_hydroturbine/doc/waterturbine/description.html
+++ b/mesecons_hydroturbine/doc/waterturbine/description.html
@@ -1 +1,2 @@
 Water turbines are receptors that turn on if flowing water is above them.
+They only work in active blocks; in inactive blocks they keep their old state.
diff --git a/mesecons_insulated/doc/insulated/description.html b/mesecons_insulated/doc/insulated/description.html
index df2a6df..deb344d 100644
--- a/mesecons_insulated/doc/insulated/description.html
+++ b/mesecons_insulated/doc/insulated/description.html
@@ -1 +1 @@
- Insulated mesecons are conductors that only conduct in one direction (and also not up or down).
+ Insulated mesecons are conductors that only conduct in one direction (and also not up or down). Like uninsulated wires, they work through unloaded blocks.
diff --git a/mesecons_lightstone/doc/lightstone_blue/description.html b/mesecons_lightstone/doc/lightstone_blue/description.html
index 813e6ea..5397a96 100644
--- a/mesecons_lightstone/doc/lightstone_blue/description.html
+++ b/mesecons_lightstone/doc/lightstone_blue/description.html
@@ -1 +1,2 @@
 Effector, glows blue when powered.
+It works in an inactive block.
diff --git a/mesecons_lightstone/doc/lightstone_darkgrey/description.html b/mesecons_lightstone/doc/lightstone_darkgrey/description.html
index 826ca0f..aad59ea 100644
--- a/mesecons_lightstone/doc/lightstone_darkgrey/description.html
+++ b/mesecons_lightstone/doc/lightstone_darkgrey/description.html
@@ -1 +1,2 @@
 Effector, glows dark grey when powered.
+It works in an inactive block.
diff --git a/mesecons_lightstone/doc/lightstone_green/description.html b/mesecons_lightstone/doc/lightstone_green/description.html
index cb5b515..1191334 100644
--- a/mesecons_lightstone/doc/lightstone_green/description.html
+++ b/mesecons_lightstone/doc/lightstone_green/description.html
@@ -1 +1,2 @@
 Effector, glows green when powered.
+It works in an inactive block.
diff --git a/mesecons_lightstone/doc/lightstone_lightgrey/description.html b/mesecons_lightstone/doc/lightstone_lightgrey/description.html
index 990b501..b3003d2 100644
--- a/mesecons_lightstone/doc/lightstone_lightgrey/description.html
+++ b/mesecons_lightstone/doc/lightstone_lightgrey/description.html
@@ -1 +1,2 @@
 Effector, glows light grey when powered.
+It works in an inactive block.
diff --git a/mesecons_lightstone/doc/lightstone_red/description.html b/mesecons_lightstone/doc/lightstone_red/description.html
index 699b1ee..f49aeac 100644
--- a/mesecons_lightstone/doc/lightstone_red/description.html
+++ b/mesecons_lightstone/doc/lightstone_red/description.html
@@ -1 +1,2 @@
 Effector, glows red when powered.
+It works in an inactive block.
diff --git a/mesecons_lightstone/doc/lightstone_yellow/description.html b/mesecons_lightstone/doc/lightstone_yellow/description.html
index 2bed7f2..a97839b 100644
--- a/mesecons_lightstone/doc/lightstone_yellow/description.html
+++ b/mesecons_lightstone/doc/lightstone_yellow/description.html
@@ -1 +1,2 @@
 Effector, glows yellow when powered.
+It works in an inactive block.
diff --git a/mesecons_luacontroller/doc/luacontroller/description.html b/mesecons_luacontroller/doc/luacontroller/description.html
index e549ffe..8c5d023 100644
--- a/mesecons_luacontroller/doc/luacontroller/description.html
+++ b/mesecons_luacontroller/doc/luacontroller/description.html
@@ -1,5 +1,7 @@
 The Luacontroller is an advanced programmable component.
 You can simply code it in the language Mesecons uses itself: Lua!
 All the code runs in a sandbox, so it's completely safe (but I won't guarantee that for absolute certainty!).
+It works fine in an unloaded block, loading the block when the program needs to run.
+Events are properly delivered after a server restart.
 
 <a href="http://mesecons.net/luacontroller/">Documentation is available here!</a>
diff --git a/mesecons_movestones/doc/movestone/description.html b/mesecons_movestones/doc/movestone/description.html
index 8555a9e..b7138a0 100644
--- a/mesecons_movestones/doc/movestone/description.html
+++ b/mesecons_movestones/doc/movestone/description.html
@@ -1 +1,2 @@
 Movestones are effectors that push the blocks in front of them. They move along on the right side of a mesecon wire track.
+A movestone trying to move into, or push other nodes into, an unloaded block doesn't move.
diff --git a/mesecons_movestones/doc/movestone_sticky/description.html b/mesecons_movestones/doc/movestone_sticky/description.html
index 460c277..f19d6a5 100644
--- a/mesecons_movestones/doc/movestone_sticky/description.html
+++ b/mesecons_movestones/doc/movestone_sticky/description.html
@@ -1 +1,3 @@
 Movestones are effectors that push the blocks in front of them. They move along on the right side of a mesecon wire track. Sticky ones also pull blocks.
+A sticky movestone trying to move into, or push other nodes into, an unloaded block doesn't move.
+A sticky movestone trying to pull nodes from an unloaded block moves but leaves them behind.
diff --git a/mesecons_pistons/doc/piston/description.html b/mesecons_pistons/doc/piston/description.html
index d95dfb9..b9dffaa 100644
--- a/mesecons_pistons/doc/piston/description.html
+++ b/mesecons_pistons/doc/piston/description.html
@@ -1 +1,3 @@
 Pistons are effectors, they push up to 20 blocks in front of them. The push direction can be set by placing them from different angles.
+A piston pointing into an unloaded block won't extend.
+A piston retracting from an unloaded block works, but gravity-sensitive nodes above the empty space may not fall.
diff --git a/mesecons_pistons/doc/piston_sticky/description.html b/mesecons_pistons/doc/piston_sticky/description.html
index 3974097..580b76f 100644
--- a/mesecons_pistons/doc/piston_sticky/description.html
+++ b/mesecons_pistons/doc/piston_sticky/description.html
@@ -1 +1,4 @@
 Sticky pistons are effectors, they push up to 20 blocks in front of them. The push direction can be set by placing them from different angles. Sticky ones also pull 1 block.
+A sticky piston pointing into an unloaded block won't extend.
+A sticky piston retracting from within an unloaded block works and pulls a node, but if it doesn't pull anything, then gravity-sensitive nodes above the empty space may not fall.
+An extended sticky piston that touches the surface of an unloaded block and loses signal retracts but doesn't pull anything.
diff --git a/mesecons_powerplant/doc/powerplant/description.html b/mesecons_powerplant/doc/powerplant/description.html
index 4ed8f33..22be496 100644
--- a/mesecons_powerplant/doc/powerplant/description.html
+++ b/mesecons_powerplant/doc/powerplant/description.html
@@ -1 +1,2 @@
 A power plant is a receptor that is always turned on: it provides energy.
+It continues to work in an unloaded block.
diff --git a/mesecons_random/doc/ghoststone/description.html b/mesecons_random/doc/ghoststone/description.html
index 395430e..d54ef63 100644
--- a/mesecons_random/doc/ghoststone/description.html
+++ b/mesecons_random/doc/ghoststone/description.html
@@ -1 +1,2 @@
 Ghoststones disappear when powered, just like Removestones. But in contrast to Removestones, they reappear again when not powered anymore and they are also conductive.
+They work in inactive blocks.
diff --git a/mesecons_random/doc/removestone/description.html b/mesecons_random/doc/removestone/description.html
index 6947441..ccd3c14 100644
--- a/mesecons_random/doc/removestone/description.html
+++ b/mesecons_random/doc/removestone/description.html
@@ -1 +1,2 @@
 Removestones are probably the simplest effectors possible. They simply disappear when powered.
+They work in inactive blocks.
diff --git a/mesecons_solarpanel/doc/solarpanel/description.html b/mesecons_solarpanel/doc/solarpanel/description.html
index add6213..53570ca 100644
--- a/mesecons_solarpanel/doc/solarpanel/description.html
+++ b/mesecons_solarpanel/doc/solarpanel/description.html
@@ -1 +1,2 @@
 Solar panels are light receptors: they turn on if there is enough light.
+They only work in active blocks; in inactive blocks they keep their old state.
diff --git a/mesecons_torch/doc/torch/description.html b/mesecons_torch/doc/torch/description.html
index da7f19c..60a6713 100644
--- a/mesecons_torch/doc/torch/description.html
+++ b/mesecons_torch/doc/torch/description.html
@@ -1 +1,2 @@
 The torch is an inverter, it may take up to 1 second until the signal has passed through. The input is 2 blocks away in the direction of the stick, outputs are around the mesecon glow.
+It doesn't work in an inactive block; it just retains its state until the block becomes active.
diff --git a/mesecons_wires/doc/mesecon/description.html b/mesecons_wires/doc/mesecon/description.html
index f217be9..b20606b 100644
--- a/mesecons_wires/doc/mesecon/description.html
+++ b/mesecons_wires/doc/mesecon/description.html
@@ -1 +1 @@
-Mesecons are the wires, use them to connect effectors with receptors.
+Mesecons are the wires, use them to connect effectors with receptors. Wiring works through unloaded blocks; they’re loaded when the signal level changes.