first some changes for help modpack

mesecons_blinkyplant/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_blinkyplant/init.lua

@@ -36,13 +36,24 @@ mesecon.register_node("mesecons_blinkyplant:blinky_plant", {
 },{
 	tiles = {"jeija_blinky_plant_off.png"},
 	groups = {dig_immediate=3},
-	mesecons = {receptor = { state = mesecon.state.off }}
+	mesecons = {receptor = { state = mesecon.state.off }},
+	-- doc support:
+	_doc_items_longdesc = "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.",
+	_doc_items_usagehelp = "Rightclick the blinky plants to en/disable it."
 },{
 	tiles = {"jeija_blinky_plant_on.png"},
 	groups = {dig_immediate=3, not_in_creative_inventory=1},
-	mesecons = {receptor = { state = mesecon.state.on }}
+	mesecons = {receptor = { state = mesecon.state.on }},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_blinkyplant:blinky_plant_off", "nodes", "mesecons_blinkyplant:blinky_plant_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_blinkyplant:blinky_plant_off 1",
 	recipe = {	{"","group:mesecon_conductor_craftable",""},

mesecons_button/depends.txt

@@ -1,2 +1,4 @@
 mesecons
 mesecons_receiver
+doc?
+doc_items?

mesecons_button/doc/button/description.html

@@ -1 +1 @@
-This receptor can be attached to walls. It turns on for 1 second if it's punched.
+This receptor can be attached to walls. It turns on for 1 second if it's rightclicked.

mesecons_button/init.lua

@@ -51,7 +51,9 @@ minetest.register_node("mesecons_button:button_off", {
 	mesecons = {receptor = {
 		state = mesecon.state.off,
 		rules = mesecon.rules.buttonlike_get
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "This receptor can be attached to walls. It turns on for 1 second if it's rightclicked."
 })
 
 minetest.register_node("mesecons_button:button_on", {
@@ -89,9 +91,16 @@ minetest.register_node("mesecons_button:button_on", {
 	mesecons = {receptor = {
 		state = mesecon.state.on,
 		rules = mesecon.rules.buttonlike_get
-	}}
+	}},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_button:button_off", "nodes", "mesecons_button:button_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_button:button_off 2",
 	recipe = {

mesecons_commandblock/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_commandblock/init.lua

@@ -189,7 +189,10 @@ minetest.register_node("mesecons_commandblock:commandblock_off", {
 	sounds = default.node_sound_stone_defaults(),
 	mesecons = {effector = {
 		action_on = commandblock_action_on
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "There is no crafting recipe as this should only be available for server admins."..
+		" Quite similar to the Minecraft counterpart. Executes server commands.",
 })
 
 minetest.register_node("mesecons_commandblock:commandblock_on", {
@@ -206,3 +209,8 @@ minetest.register_node("mesecons_commandblock:commandblock_on", {
 		action_off = commandblock_action_off
 	}}
 })
+
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_commandblock:commandblock_off", "nodes", "mesecons_commandblock:commandblock_on")
+end

mesecons_delayer/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_delayer/init.lua

@@ -59,6 +59,16 @@ boxes = {{ -6/16, -8/16, -6/16, 6/16, -7/16, 6/16 },		-- the main slab
 	 { -8/16, -8/16, -1/16, -6/16, -7/16, 1/16 },		-- the two wire stubs
 	 { 6/16, -8/16, -1/16, 8/16, -7/16, 1/16 }}
 
+-- doc support:
+local _doc_items_entry_create = true
+local _doc_items_longdesc = "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."
+if i ~= 1 then
+	_doc_items_entry_create = false
+	_doc_items_longdesc = nil
+end
+
 minetest.register_node("mesecons_delayer:delayer_off_"..tostring(i), {
 	description = "Delayer",
 	drawtype = "nodebox",
@@ -112,9 +122,13 @@ minetest.register_node("mesecons_delayer:delayer_off_"..tostring(i), {
 			rules = delayer_get_input_rules,
 			action_on = delayer_activate
 		}
-	}
+	},
+	-- doc support:
+	_doc_items_create_entry = _doc_items_entry_create,
+	_doc_items_longdesc = _doc_items_longdesc
 })
-
+_doc_items_entry_create = nil
+_doc_items_longdesc = nil
 
 minetest.register_node("mesecons_delayer:delayer_on_"..tostring(i), {
 	description = "You hacker you",
@@ -166,8 +180,19 @@ minetest.register_node("mesecons_delayer:delayer_on_"..tostring(i), {
 			rules = delayer_get_input_rules,
 			action_off = delayer_deactivate
 		}
-	}
+	},
+	-- doc support:
+	_doc_items_create_entry = false
 })
+
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	if i ~= 1 then
+		doc.add_entry_alias("nodes", "mesecons_delayer:delayer_off_1", "nodes", "mesecons_delayer:delayer_off_"..tostring(i))
+	end
+	doc.add_entry_alias("nodes", "mesecons_delayer:delayer_off_1", "nodes", "mesecons_delayer:delayer_on_"..tostring(i))
+end
+
 end
 
 minetest.register_craft({

mesecons_extrawires/corner.lua

@@ -70,9 +70,17 @@ minetest.register_node("mesecons_extrawires:corner_off", {
 		state = mesecon.state.off,
 		rules = corner_get_rules,
 		onstate = "mesecons_extrawires:corner_on"
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "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."
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_extrawires:corner_off", "nodes", "mesecons_extrawires:corner_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_extrawires:corner_off 3",
 	recipe = {

mesecons_extrawires/crossover.lua

@@ -39,6 +39,9 @@ minetest.register_node("mesecons_extrawires:crossover_off", {
 			rules = crossover_get_rules(),
 		}
 	},
+	-- doc support:
+	_doc_items_longdesc = "Insulated crossing are conductors that conduct two signals between the opposing sides,"..
+		" the signals are insulated to each other.",
 })
 
 minetest.register_node("mesecons_extrawires:crossover_01", {
@@ -63,6 +66,8 @@ minetest.register_node("mesecons_extrawires:crossover_01", {
 			rules = crossover_get_rules(),
 		}
 	},
+	-- doc support:
+	_doc_items_create_entry = false,
 })
 
 minetest.register_node("mesecons_extrawires:crossover_10", {
@@ -87,6 +92,8 @@ minetest.register_node("mesecons_extrawires:crossover_10", {
 			rules = crossover_get_rules(),
 		}
 	},
+	-- doc support:
+	_doc_items_create_entry = false,
 })
 
 minetest.register_node("mesecons_extrawires:crossover_on", {
@@ -111,8 +118,17 @@ minetest.register_node("mesecons_extrawires:crossover_on", {
 			rules = crossover_get_rules(),
 		}
 	},
+	-- doc support:
+	_doc_items_create_entry = false,
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_extrawires:crossover_off", "nodes", "mesecons_extrawires:crossover_01")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:crossover_off", "nodes", "mesecons_extrawires:crossover_10")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:crossover_off", "nodes", "mesecons_extrawires:crossover_on")
+end
+
 minetest.register_craft({
 	type = "shapeless",
 	output = "mesecons_extrawires:crossover_off",

mesecons_extrawires/depends.txt

@@ -1,2 +1,4 @@
 default
 mesecons
+doc?
+doc_items?

mesecons_extrawires/mesewire.lua

@@ -13,7 +13,11 @@ minetest.override_item("default:mese", {
 		state = mesecon.state.off,
 		onstate = "mesecons_extrawires:mese_powered",
 		rules = mesewire_rules
-	}}
+	}},
+	-- doc support:
+	_doc_items_usagehelp = "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"
 })
 
 -- Copy node definition of powered mese from normal mese
@@ -26,7 +30,9 @@ local powered_def = mesecon.mergetable(minetest.registered_nodes["default:mese"]
 		offstate = "default:mese",
 		rules = mesewire_rules
 	}},
-	groups = {cracky = 1, not_in_creative_inventory = 1}
+	groups = {cracky = 1, not_in_creative_inventory = 1},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
 for i, v in pairs(powered_def.tiles) do
@@ -34,3 +40,8 @@ for i, v in pairs(powered_def.tiles) do
 end
 
 minetest.register_node("mesecons_extrawires:mese_powered", powered_def)
+
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "default:mese", "nodes", "mesecons_extrawires:mese_powered")
+end

mesecons_extrawires/tjunction.lua

@@ -71,9 +71,16 @@ minetest.register_node("mesecons_extrawires:tjunction_off", {
 		state = mesecon.state.off,
 		rules = tjunction_get_rules,
 		onstate = "mesecons_extrawires:tjunction_on"
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "Insulated T-Junctions are conductors that only conduct between the inputs (also not up or down)."
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_extrawires:tjunction_off", "nodes", "mesecons_extrawires:tjunction_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_extrawires:tjunction_off 3",
 	recipe = {

mesecons_extrawires/vertical.lua

@@ -95,7 +95,10 @@ mesecon.register_node("mesecons_extrawires:vertical", {
 		state = mesecon.state.off,
 		onstate = "mesecons_extrawires:vertical_on",
 		rules = vertical_rules,
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "Vertical Mesecons only conduct up and down."..
+		" Plates appear at the ends, at that place they also conduct to the side."
 },{
 	tiles = {"mesecons_wire_on.png"},
 	groups = {dig_immediate=3, not_in_creative_inventory=1},
@@ -103,7 +106,9 @@ mesecon.register_node("mesecons_extrawires:vertical", {
 		state = mesecon.state.on,
 		offstate = "mesecons_extrawires:vertical_off",
 		rules = vertical_rules,
-	}}
+	}},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
 -- Vertical wire top
@@ -119,7 +124,9 @@ mesecon.register_node("mesecons_extrawires:vertical_top", {
 	is_vertical_conductor = true,
 	drop = "mesecons_extrawires:vertical_off",
 	after_place_node = vertical_update,
-	after_dig_node = vertical_update
+	after_dig_node = vertical_update,
+	-- doc support:
+	_doc_items_create_entry = false
 },{
 	tiles = {"mesecons_wire_off.png"},
 	mesecons = {conductor = {
@@ -149,7 +156,9 @@ mesecon.register_node("mesecons_extrawires:vertical_bottom", {
 	is_vertical_conductor = true,
 	drop = "mesecons_extrawires:vertical_off",
 	after_place_node = vertical_update,
-	after_dig_node = vertical_update
+	after_dig_node = vertical_update,
+	-- doc support:
+	_doc_items_create_entry = false
 },{
 	tiles = {"mesecons_wire_off.png"},
 	mesecons = {conductor = {
@@ -166,6 +175,15 @@ mesecon.register_node("mesecons_extrawires:vertical_bottom", {
 	}}
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_extrawires:vertical_off", "nodes", "mesecons_extrawires:vertical_on")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:vertical_off", "nodes", "mesecons_extrawires:vertical_bottom_off")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:vertical_off", "nodes", "mesecons_extrawires:vertical_bottom_on")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:vertical_off", "nodes", "mesecons_extrawires:vertical_top_off")
+	doc.add_entry_alias("nodes", "mesecons_extrawires:vertical_off", "nodes", "mesecons_extrawires:vertical_top_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_extrawires:vertical_off 3",
 	recipe = {

mesecons_hydroturbine/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_hydroturbine/init.lua

@@ -24,7 +24,9 @@ minetest.register_node("mesecons_hydroturbine:hydro_turbine_off", {
 	sounds = default.node_sound_stone_defaults(),
 	mesecons = {receptor = {
 		state = mesecon.state.off
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "Water turbines are receptors that turn on if flowing water is above them."
 })
 
 minetest.register_node("mesecons_hydroturbine:hydro_turbine_on", {
@@ -49,9 +51,16 @@ minetest.register_node("mesecons_hydroturbine:hydro_turbine_on", {
 	sounds = default.node_sound_stone_defaults(),
 	mesecons = {receptor = {
 		state = mesecon.state.on
-	}}
+	}},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_hydroturbine:hydro_turbine_off", "nodes", "mesecons_hydroturbine:hydro_turbine_on")
+end
+
 
 local function is_flowing_water(pos)
 	local name = minetest.get_node(pos).name

mesecons_insulated/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_insulated/init.lua

@@ -36,7 +36,9 @@ minetest.register_node("mesecons_insulated:insulated_on", {
 		state = mesecon.state.on,
 		offstate = "mesecons_insulated:insulated_off",
 		rules = insulated_wire_get_rules
-	}}
+	}},
+	-- doc support:
+	_doc_items_create_entry = false
 })
 
 minetest.register_node("mesecons_insulated:insulated_off", {
@@ -67,9 +69,16 @@ minetest.register_node("mesecons_insulated:insulated_off", {
 		state = mesecon.state.off,
 		onstate = "mesecons_insulated:insulated_on",
 		rules = insulated_wire_get_rules
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = " Insulated mesecons are conductors that only conduct in one direction (and also not up or down)."
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_insulated:insulated_off", "nodes", "mesecons_insulated:insulated_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_insulated:insulated_off 3",
 	recipe = {

mesecons_lamp/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_lamp/init.lua

@@ -48,9 +48,16 @@ minetest.register_node("mesecons_lamp:lamp_off", {
 		action_on = function (pos, node)
 			minetest.swap_node(pos, {name = "mesecons_lamp:lamp_on", param2 = node.param2})
 		end
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "Lamps are effectors that if powered emit light."
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_lamp:lamp_off", "nodes", "mesecons_lamp:lamp_on")
+end
+
 minetest.register_craft({
 	output = "mesecons_lamp:lamp_off 1",
 	recipe = {

mesecons_lightstone/depends.txt

@@ -1,2 +1,4 @@
 mesecons
 dye
+doc?
+doc_items?

mesecons_lightstone/init.lua

@@ -25,7 +25,9 @@ function mesecon.lightstone_add(name, base_item, texture_off, texture_on)
 			action_on = function (pos, node)
 				minetest.swap_node(pos, {name = "mesecons_lightstone:lightstone_" .. name .. "_on", param2 = node.param2})
 			end,
-		}}
+		}},
+		-- doc support:
+		_doc_items_longdesc = "Effector, glows " .. name .. " when powered."
 	})
 	minetest.register_node("mesecons_lightstone:lightstone_" .. name .. "_on", {
 	tiles = {texture_on},
@@ -41,6 +43,11 @@ function mesecon.lightstone_add(name, base_item, texture_off, texture_on)
 	}}
 	})
 
+	-- doc support:
+	if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+		doc.add_entry_alias("nodes", "mesecons_lightstone:lightstone_" .. name .. "_off", "nodes", "mesecons_lightstone:lightstone_" .. name .. "_on")
+	end
+
 	minetest.register_craft({
 		output = "mesecons_lightstone:lightstone_" .. name .. "_off",
 		recipe = {

mesecons_powerplant/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_powerplant/init.lua

@@ -18,7 +18,9 @@ minetest.register_node("mesecons_powerplant:power_plant", {
 	sounds = default.node_sound_leaves_defaults(),
 	mesecons = {receptor = {
 		state = mesecon.state.on
-	}}
+	}},
+	-- doc support:
+	_doc_items_longdesc = "A power plant is a receptor that is always turned on: It provides energy."
 })
 
 minetest.register_craft({

mesecons_receiver/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_receiver/init.lua

@@ -169,6 +169,16 @@ mesecon.register_node("mesecons_receiver:receiver_down", {
 	}}
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_down_on")
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_down_off")
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_up_on")
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_up_off")
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_on")
+	doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons_receiver:receiver_off")
+end
+
 function mesecon.receiver_get_pos_from_rcpt(pos, param2)
 	local rules = {{x = 2,  y = 0, z = 0}}
 	if param2 == nil then param2 = minetest.get_node(pos).param2 end

mesecons_torch/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_torch/init.lua

@@ -82,8 +82,16 @@ minetest.register_node("mesecons_torch:mesecon_torch_on", {
 		state = mesecon.state.on,
 		rules = torch_get_output_rules
 	}},
+	-- doc support:
+	_doc_items_longdesc = "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.",
 })
 
+-- doc support:
+if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+	doc.add_entry_alias("nodes", "mesecons_torch:mesecon_torch_on", "nodes", "mesecons_torch:mesecon_torch_off")
+end
+
 minetest.register_abm({
 	nodenames = {"mesecons_torch:mesecon_torch_off","mesecons_torch:mesecon_torch_on"},
 	interval = 1,

mesecons_wires/depends.txt

@@ -1 +1,3 @@
 mesecons
+doc?
+doc_items?

mesecons_wires/init.lua

@@ -217,6 +217,20 @@ register_wires = function()
 		}, {tiles = tiles_off, mesecons = meseconspec_off, groups = groups_off},
 		{tiles = tiles_on, mesecons = meseconspec_on, groups = groups_on})
 
+		-- doc support:
+		if minetest.get_modpath("doc") and minetest.get_modpath("doc_items") then
+			if nodeid ~= "00000000" then
+				minetest.override_item("mesecons:wire_"..nodeid.."_off", {_doc_items_create_entry = false})
+				doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons:wire_"..nodeid.."_off")
+			else
+				minetest.override_item("mesecons:wire_"..nodeid.."_off", {
+					_doc_items_longdesc = "Mesecons are the wires, use them to connect effectors with receptors."
+				})
+			end
+			minetest.override_item("mesecons:wire_"..nodeid.."_on", {_doc_items_create_entry = false})
+			doc.add_entry_alias("nodes", "mesecons:wire_00000000_off", "nodes", "mesecons:wire_"..nodeid.."_on")
+		end
+
 		if (nid_inc(nid) == false) then return end
 	end
 end