Add api documentation (#361)

you

2017-06-05 987cc5a6a425b1f9bcd9000608dc389a45c675a1

 technic/machines/HV/quarry.lua

@@ -1,17 +1,21 @@

local S = technic.getter

local tube_entry = "^pipeworks_tube_connection_metallic.png"
local cable_entry = "^technic_cable_connection_overlay.png"

minetest.register_craft({
   recipe = {
      {"technic:carbon_plate",       "pipeworks:filter",       "technic:composite_plate"},
      {"technic:motor",              "technic:machine_casing", "technic:diamond_drill_head"},
      {"technic:carbon_steel_block", "technic:hv_cable0",      "technic:carbon_steel_block"}},
      {"technic:carbon_steel_block", "technic:hv_cable",       "technic:carbon_steel_block"}},
   output = "technic:quarry",
})

local quarry_dig_above_nodes = 3 -- How far above the quarry we will dig nodes
local quarry_max_depth       = 100
local quarry_demand = 10000
local quarry_eject_dir = vector.new(0, 1, 0)

local function set_quarry_formspec(meta)
   local radius = meta:get_int("size")
@@ -83,7 +87,7 @@
      if stack then
         local item = stack:to_table()
         if item then
            technic.tube_inject_item(pos, pos, vector.new(0, 1, 0), item)
            technic.tube_inject_item(pos, pos, quarry_eject_dir, item)
            stack:clear()
            inv:set_stack("cache", i, stack)
            break
@@ -206,16 +210,29 @@

minetest.register_node("technic:quarry", {
   description = S("%s Quarry"):format("HV"),
   tiles = {"technic_carbon_steel_block.png", "technic_carbon_steel_block.png",
            "technic_carbon_steel_block.png", "technic_carbon_steel_block.png",
            "technic_carbon_steel_block.png^default_tool_mesepick.png", "technic_carbon_steel_block.png"},
   inventory_image = minetest.inventorycube("technic_carbon_steel_block.png",
            "technic_carbon_steel_block.png^default_tool_mesepick.png",
            "technic_carbon_steel_block.png"),
   tiles = {
      "technic_carbon_steel_block.png"..tube_entry,
      "technic_carbon_steel_block.png"..cable_entry,
      "technic_carbon_steel_block.png"..cable_entry,
      "technic_carbon_steel_block.png"..cable_entry,
      "technic_carbon_steel_block.png^default_tool_mesepick.png",
      "technic_carbon_steel_block.png"..cable_entry
   },
   paramtype2 = "facedir",
   groups = {cracky=2, tubedevice=1, technic_machine = 1},
   groups = {cracky=2, tubedevice=1, technic_machine=1, technic_hv=1},
   connect_sides = {"bottom", "front", "left", "right"},
   tube = {
      connect_sides = {top = 1},
      -- lower priority than other tubes, so that quarries will prefer any
      -- other tube to another quarry, which could lead to server freezes
      -- in certain quarry placements (2x2 for example would never eject)
      priority = 10,
      can_go = function(pos, node, velocity, stack)
         -- always eject the same, even if items came in another way
         -- this further mitigates loops and generally avoids random sideway movement
         -- that can be expected in certain quarry placements
         return { quarry_eject_dir }
      end
   },
   on_construct = function(pos)
      local meta = minetest.get_meta(pos)