From 093a4823bb8908b06cafb4ce976aeb0eba37b254 Mon Sep 17 00:00:00 2001 From: Starbeamrainbowlabs Date: Mon, 1 Mar 2021 22:34:06 +0000 Subject: [PATCH] Update docs for //sstack, //spush, and //spop --- Chat-Command-Reference.md | 24 ++++++++++++++++++++++++ README.md | 7 ++++++- 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/Chat-Command-Reference.md b/Chat-Command-Reference.md index 14623c6..28d765e 100644 --- a/Chat-Command-Reference.md +++ b/Chat-Command-Reference.md @@ -491,6 +491,30 @@ Short for _select rectangle_. Sets the pos2 at a set distance along 2 axes from //srect -z y 25 ``` +## `//sstack` +Displays the contents of your per-user selection stack. This stack can be pushed to and popped from rather like a stack of plates. See also `//spush` (for pushing to the selection stack) and `//spop` (for popping from the selection stack). + +``` +//sstack +``` + +## `//spush` +Pushes the currently defined region onto your per-user selection stack. Does not otherwise alter the defined region. + +If the stack is full (currently the limit is set to 100 regions in the stack), then it will complain at you but otherwise will have no effect. + +Note that pos2 does _not_ need to be defined in order to use this. if it isn't defined, then a pos2 of `nil` will be pushed onto the stack instead. + +``` +//spush +``` + +## `//spop` +Pops a selection off your per-user selection stack and applies it to the currently defined region. If pos2 from the item popped from the stack is nil, then pos2 is explicitly unset. If the stack is empty, this has no effect. + +``` +//spop +``` ## `//y` Confirms the execution of a command if it could potentially affect a large number of nodes and take a while. This is a regular WorldEdit command. diff --git a/README.md b/README.md index 105dcb7..b3de001 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,6 @@ The detailed explanations have moved! Check them out [here](https://github.com/s - [`//replacemix [] [] [ []] [ []] ....`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#replacemix-target_node-chance-replace_node_a-chance_a-replace_node_b-chance_b-replace_node_n-chance_n-) - [`//floodfill [ []]`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#floodfill-replace_node-radius-floodfill) - [`//scale | [ [ ]]`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#scale-axis-scale_factor--factor_x-factor_y-factor_z-anchor_x-anchor_y-anchor_z) **experimental** - - [`//srect [ []] `](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#srect-axis1-axis2-length) ### Terrain - [`//overlay [] [] [ []] ...`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#overlay-node_name_a-chance_a-node_name_b-chance_b-node_name_n-chance_n-) @@ -57,6 +56,12 @@ The detailed explanations have moved! Check them out [here](https://github.com/s ### Statistics - [`//count`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#count) +### Selection +- [`//srect [ []] `](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#srect-axis1-axis2-length) +- [`//sstack`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#sstack) +- [`//spush`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#spush) +- [`//spop`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#spop) + ### Meta - [`//multi ....`](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#multi-command_a-command_b-command_c-) - [`//many `](https://github.com/sbrl/Minetest-WorldEditAdditions/blob/master/Chat-Command-Reference.md#many-times-command) _(new in v1.9)_