Clarify the documentation regarding the the positioning of WorldEdit primitives relat...

diff --git a/Chat Commands.md b/Chat Commands.md
index eee08eb25cb3164906e4f3dcb813aa93a2547207..9951ca3bcb46b02161aad40cccc79ff61466f8fa 100644 (file)
--- a/Chat Commands.md
+++ b/Chat Commands.md
@@ -75,7 +75,7 @@ Replace all nodes other than <search node> with <replace node> in the current Wo
 \r
 ### //hollowsphere <radius> <node>\r
 \r
-Add hollow sphere at WorldEdit position 1 with radius <radius>, composed of <node>.\r
+Add hollow sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>.\r
 \r
     //hollowsphere 5 Diamond Block\r
     //hollowsphere 12 glass\r
@@ -83,7 +83,7 @@ Add hollow sphere at WorldEdit position 1 with radius <radius>, composed of <nod
 \r
 ### //sphere <radius> <node>\r
 \r
-Add sphere at WorldEdit position 1 with radius <radius>, composed of <node>.\r
+Add sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>.\r
 \r
     //sphere 5 Diamond Block\r
     //sphere 12 glass\r
@@ -91,7 +91,7 @@ Add sphere at WorldEdit position 1 with radius <radius>, composed of <node>.
 \r
 ### //hollowdome <radius> <node>\r
 \r
-Add hollow dome at WorldEdit position 1 with radius <radius>, composed of <node>.\r
+Add hollow dome centered at WorldEdit position 1 with radius <radius>, composed of <node>.\r
 \r
     //hollowdome 5 Diamond Block\r
     //hollowdome 12 glass\r
@@ -99,7 +99,7 @@ Add hollow dome at WorldEdit position 1 with radius <radius>, composed of <node>
 \r
 ### //dome <radius> <node>\r
 \r
-Add dome at WorldEdit position 1 with radius <radius>, composed of <node>.\r
+Add dome centered at WorldEdit position 1 with radius <radius>, composed of <node>.\r
 \r
     //dome 5 Diamond Block\r
     //dome 12 glass\r
@@ -125,7 +125,7 @@ Add cylinder at WorldEdit position 1 along the x/y/z/? axis with length <length>
     \r
 ### //pyramid <height> <node>\r
 \r
-Add pyramid at WorldEdit position 1 with height <height>, composed of <node>.\r
+Add pyramid centered at WorldEdit position 1 with height <height>, composed of <node>.\r
 \r
     //pyramid 8 Diamond Block\r
     //pyramid 5 glass\r
@@ -133,7 +133,7 @@ Add pyramid at WorldEdit position 1 with height <height>, composed of <node>.
 \r
 ### //spiral <width> <height> <spacer> <node>\r
 \r
-Add spiral at WorldEdit position 1 with width <width>, height <height>, space between walls <spacer>, composed of <node>.\r
+Add spiral centered at WorldEdit position 1 with width <width>, height <height>, space between walls <spacer>, composed of <node>.\r
 \r
     //spiral 20 5 3 Diamond Block\r
     //spiral 5 2 1 glass\r

diff --git a/WorldEdit API.md b/WorldEdit API.md
index c994bf7bc965f6562998526b142d8b92a309640c..12320f6c7488df7db4d98ae3eed1880eeb0fc4cd 100644 (file)
--- a/WorldEdit API.md
+++ b/WorldEdit API.md
@@ -88,25 +88,25 @@ Contained in primitives.lua, this module allows the creation of several geometri
 \r
 ### count = worldedit.hollow_sphere(pos, radius, nodename)\r
 \r
-Adds a hollow sphere at `pos` with radius `radius`, composed of `nodename`.\r
+Adds a hollow sphere centered at `pos` with radius `radius`, composed of `nodename`.\r
 \r
 Returns the number of nodes added.\r
 \r
 ### count = worldedit.sphere(pos, radius, nodename)\r
 \r
-Adds a sphere at `pos` with radius `radius`, composed of `nodename`.\r
+Adds a sphere centered at `pos` with radius `radius`, composed of `nodename`.\r
 \r
 Returns the number of nodes added.\r
 \r
 ### count = worldedit.hollow_dome(pos, radius, nodename)\r
 \r
-Adds a hollow dome at `pos` with radius `radius`, composed of `nodename`.\r
+Adds a hollow dome centered at `pos` with radius `radius`, composed of `nodename`.\r
 \r
 Returns the number of nodes added.\r
 \r
 ### count = worldedit.dome(pos, radius, nodename)\r
 \r
-Adds a dome at `pos` with radius `radius`, composed of `nodename`.\r
+Adds a dome centered at `pos` with radius `radius`, composed of `nodename`.\r
 \r
 Returns the number of nodes added.\r
 \r
@@ -124,13 +124,13 @@ Returns the number of nodes added.
 \r
 ### count = worldedit.pyramid(pos, height, nodename)\r
 \r
-Adds a pyramid at `pos` with height `height`.\r
+Adds a pyramid centered at `pos` with height `height`.\r
 \r
 Returns the number of nodes added.\r
 \r
 ### count = worldedit.spiral(pos, width, height, spacer, nodename)\r
 \r
-Adds a spiral at `pos` with width `width`, height `height`, space between walls `spacer`, composed of `nodename`.\r
+Adds a spiral centered at `pos` with width `width`, height `height`, space between walls `spacer`, composed of `nodename`.\r
 \r
 Returns the number of nodes added.\r
 \r

diff --git a/worldedit/primitives.lua b/worldedit/primitives.lua
index d0c93a717cb20aa53656ca4d294e247838a01008..4513e8f0ec4dbdae4c279abf32b7ca32f8538941 100644 (file)
--- a/worldedit/primitives.lua
+++ b/worldedit/primitives.lua
@@ -1,6 +1,6 @@
 worldedit = worldedit or {}\r
 \r
---adds a hollow sphere at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
+--adds a hollow sphere centered at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
 worldedit.hollow_sphere = function(pos, radius, nodename, env)\r
        local node = {name=nodename}\r
        local pos1 = {x=0, y=0, z=0}\r
@@ -24,7 +24,7 @@ worldedit.hollow_sphere = function(pos, radius, nodename, env)
        return count\r
 end\r
 \r
---adds a sphere at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
+--adds a sphere centered at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
 worldedit.sphere = function(pos, radius, nodename, env)\r
        local node = {name=nodename}\r
        local pos1 = {x=0, y=0, z=0}\r
@@ -47,7 +47,7 @@ worldedit.sphere = function(pos, radius, nodename, env)
        return count\r
 end\r
 \r
---adds a hollow dome at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
+--adds a hollow dome centered at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
 worldedit.hollow_dome = function(pos, radius, nodename, env) --wip: use bresenham sphere for maximum speed\r
        local node = {name=nodename}\r
        local pos1 = {x=0, y=0, z=0}\r
@@ -71,7 +71,7 @@ worldedit.hollow_dome = function(pos, radius, nodename, env) --wip: use bresenha
        return count\r
 end\r
 \r
---adds a dome at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
+--adds a dome centered at `pos` with radius `radius`, composed of `nodename`, returning the number of nodes added\r
 worldedit.dome = function(pos, radius, nodename, env) --wip: use bresenham sphere for maximum speed\r
        local node = {name=nodename}\r
        local pos1 = {x=0, y=0, z=0}\r
@@ -214,7 +214,7 @@ worldedit.cylinder = function(pos, axis, length, radius, nodename, env)
        return count\r
 end\r
 \r
---adds a pyramid at `pos` with height `height`, composed of `nodename`, returning the number of nodes added\r
+--adds a pyramid centered at `pos` with height `height`, composed of `nodename`, returning the number of nodes added\r
 worldedit.pyramid = function(pos, height, nodename, env)\r
        local pos1x, pos1y, pos1z = pos.x - height, pos.y, pos.z - height\r
        local pos2x, pos2y, pos2z = pos.x + height, pos.y + height, pos.z + height\r
@@ -243,7 +243,7 @@ worldedit.pyramid = function(pos, height, nodename, env)
        return count\r
 end\r
 \r
---adds a spiral at `pos` with width `width`, height `height`, space between walls `spacer`, composed of `nodename`, returning the number of nodes added\r
+--adds a spiral centered at `pos` with width `width`, height `height`, space between walls `spacer`, composed of `nodename`, returning the number of nodes added\r
 worldedit.spiral = function(pos, width, height, spacer, nodename, env) --wip: clean this up\r
        -- spiral matrix - http://rosettacode.org/wiki/Spiral_matrix#Lua\r
        av, sn = math.abs, function(s) return s~=0 and s/av(s) or 0 end\r

diff --git a/worldedit_commands/init.lua b/worldedit_commands/init.lua
index b50198ef692f7a68cdc020d40d0c61091b25a308..d98dc9d27dc1d6b1ebfaadb5a3d2364dd246eb69 100644 (file)
--- a/worldedit_commands/init.lua
+++ b/worldedit_commands/init.lua
@@ -289,7 +289,7 @@ minetest.register_chatcommand("/replaceinverse", {
 \r
 minetest.register_chatcommand("/hollowsphere", {\r
        params = "<radius> <node>",\r
-       description = "Add hollow sphere at WorldEdit position 1 with radius <radius>, composed of <node>",\r
+       description = "Add hollow sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r
@@ -320,7 +320,7 @@ minetest.register_chatcommand("/hollowsphere", {
 \r
 minetest.register_chatcommand("/sphere", {\r
        params = "<radius> <node>",\r
-       description = "Add sphere at WorldEdit position 1 with radius <radius>, composed of <node>",\r
+       description = "Add sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r
@@ -351,7 +351,7 @@ minetest.register_chatcommand("/sphere", {
 \r
 minetest.register_chatcommand("/hollowdome", {\r
        params = "<radius> <node>",\r
-       description = "Add hollow dome at WorldEdit position 1 with radius <radius>, composed of <node>",\r
+       description = "Add hollow dome centered at WorldEdit position 1 with radius <radius>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r
@@ -382,7 +382,7 @@ minetest.register_chatcommand("/hollowdome", {
 \r
 minetest.register_chatcommand("/dome", {\r
        params = "<radius> <node>",\r
-       description = "Add dome at WorldEdit position 1 with radius <radius>, composed of <node>",\r
+       description = "Add dome centered at WorldEdit position 1 with radius <radius>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r
@@ -483,7 +483,7 @@ minetest.register_chatcommand("/cylinder", {
 \r
 minetest.register_chatcommand("/pyramid", {\r
        params = "<height> <node>",\r
-       description = "Add pyramid at WorldEdit position 1 with height <height>, composed of <node>",\r
+       description = "Add pyramid centered at WorldEdit position 1 with height <height>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r
@@ -514,7 +514,7 @@ minetest.register_chatcommand("/pyramid", {
 \r
 minetest.register_chatcommand("/spiral", {\r
        params = "<width> <height> <space> <node>",\r
-       description = "Add spiral at WorldEdit position 1 with width <width>, height <height>, space between walls <space>, composed of <node>",\r
+       description = "Add spiral centered at WorldEdit position 1 with width <width>, height <height>, space between walls <space>, composed of <node>",\r
        privs = {worldedit=true},\r
        func = function(name, param)\r
                local pos = worldedit.pos1[name]\r