GITBOOK-34: No subject

Author: ThePython10110

commands/README.md

@@ -6,7 +6,7 @@ description: Gets and sets player privileges.
 
 ## Syntax
 
-`ability <player> [ability] [value]`
+`ability <player> [<privilege>] [<value>]`
 
 ## Arguments
 
@@ -16,19 +16,19 @@ Specifies the player for which to grant/revoke/query the privilege.
 
 Must be a player name or target selector.
 
-`[ability]` [String](../data-types.md#string)
+`<ability>` [String](../data-types.md#string)
 
 Specifies the player privilege (such as `fly` or `server`).
 
-`[value]` [Boolean](../data-types.md#boolean)
+`<value>` [Boolean](../data-types.md#boolean)
 
 Specifies the value to set the ability to, must be either `true` or `false`. If not specified, returns the current privilege's value.
 
 ## Result
 
 Fails if the arguments are not specified correctly.
 
-On success, sets the player privilege into the specified privilege. If `[value]` isn't specified, returns whether the player has the specified privilege. If `<ability>` isn't specified, returns what privileges the player has.
+On success, sets the player privilege into the specified privilege. If `<value>` isn't specified, returns whether the player has the specified privilege. If `<ability>` isn't specified, returns what privileges the player has.
 
 ## History
 

commands/ability.md

@@ -12,23 +12,23 @@ Can remove items in the inventory lists specified by the "Clear Lists" setting.
 
 ## Syntax
 
-`clear [targets] [item] [maxCount]`
+`clear [<targets>] [<item>] [<maxCount>]`
 
 ## Arguments
 
-`[targets]` Selector
+`<targets>` Selector
 
 Specifies the player(s) whose items are cleared. If not specified, defaults to the player who executes the command.
 
-`[item]` Item
+`<item>` Item
 
 Specifies the item to be cleared. If not specified, or if `*`, all items are cleared.
 
 If any metadata is included (including just `[]`, the item must match exactly; otherwise, only the names must match.
 
 Supports `group:groupname` syntax (but ignores metadata when using it).
 
-`[maxCount]` Number
+`<maxCount>` Number
 
 Specifies the maximum number of items to be cleared. If not specified, or if `-1`, all items that match `[item]` are cleared. If `0`, instead of clearing items, detects and queries the amount of specified items.
 

commands/clear.md

@@ -6,11 +6,11 @@ description: Clears respawn points set with /spawnpoint
 
 ## Syntax
 
-`/clearspawnpoint [targets]`
+`/clearspawnpoint [<targets>]`
 
 ## Arguments
 
-`[targets]` [Selector](../data-types.md#selector)
+`<targets>` [Selector](../data-types.md#selector)
 
 The player(s) to clear the spawnpoint for. If omitted, defaults to the executor.
 

commands/clearspawnpoint.md

@@ -8,7 +8,7 @@ description: >-
 
 ## Syntax
 
-`enchant <targets> <enchantment> [level]`
+`enchant <targets> <enchantment> [<level>]`
 
 ## Arguments
 
@@ -20,7 +20,7 @@ Specifies the target(s).
 
 Specifies the enchantment to be added to the item held in the target's main hand.
 
-`[level]` Number
+`<level>` Number
 
 Specifies the enchantment level. Should not be greater than the maximum level for the specified enchantment. If not specified, defaults to 1.
 

commands/enchant.md

@@ -48,7 +48,7 @@ There are currently eight subcommands (eventually, there will be 12-13) for the
 * `... align <axes> -> execute`
 * `... as <targets> -> execute`
 * `... at <targets> -> execute`
-* `... facing (<pos>|entity <targets> [anchor]) -> execute`
+* `... facing (<pos>|entity <targets>) -> execute`
 * `... positioned (<pos>|as <targets>) -> execute`
 * `... rotated (<rot>|as <targets>) -> execute`
 * `... run <command>`
@@ -295,11 +295,13 @@ _**Syntax**_
 
 _**Arguments**_
 
-`<command>` [Long string](../data-types.md#long-string) Can be any [Better Command](./)
+`<command>` [Long string](../data-types.md#long-string)
+
+Can be any [Better Command](./)
 
 _**Result**_
 
-Execute this command. Fails if fails.
+Execute the specified command. Fails if the command fails.
 
 ## Examples
 

commands/execute.md

@@ -8,7 +8,7 @@ description: >-
 
 ## Syntax
 
-`forceenchant <targets> <enchantment> [level]`
+`forceenchant <targets> <enchantment> [<level>]`
 
 ## Arguments
 
@@ -20,7 +20,7 @@ Specifies the target(s).
 
 Specifies the enchantment to be added to the item held in the target's main hand.
 
-`[level]` Number
+`<level>` Number
 
 Specifies the enchantment level. If not specified, defaults to 1.
 

commands/forceenchant.md

@@ -6,7 +6,7 @@ description: Sets a player's game mode.
 
 ## Syntax
 
-`gamemode <gamemode> [target]`
+`gamemode <gamemode> [<target>]`
 
 ## Arguments
 
@@ -19,7 +19,7 @@ Must be one of the following:
 * `survival` (can be abbreviated as `s` or `0`)
 * `creative` (can be abbreviated as `c` or `1`)
 
-`[target]` [Selector](../target-selectors.md)
+`<target>` [Selector](../target-selectors.md)
 
 Specifies the target(s). If not specified, defaults to the player who executes the command.
 

commands/gamemode.md

@@ -6,15 +6,15 @@ description: 'Sets or queries a setting (aliases: /changesetting)'
 
 ## Syntax
 
-`gamerule <setting> [value]`
+`gamerule <setting> [<value>]`
 
 ## Arguments
 
 `<setting>` String
 
 Specifies the setting to set or query.
 
-`[value]`
+`<value>`
 
 Specifies the value to set the setting to. If not specified, queries the value of the setting instead of setting it.
 

commands/gamerule.md

@@ -10,13 +10,13 @@ Kills entities. If, for some reason, entities do not die when attempting to kill
 
 ## Syntax
 
-`kill [targets]`
+`kill [<targets>]`
 
 `killme` (equivalent to `kill @s`)
 
 ## Arguments
 
-`[targets]` [Selector](../target-selectors.md)
+`<targets>` [Selector](../target-selectors.md)
 
 Specifies the target(s) to kill. If not specified, defaults to the player who executed the command.
 

commands/kill.md

@@ -10,11 +10,11 @@ Removes entities (like [`/kill`](kill.md), but doesn't call death callbacks). If
 
 ## Syntax
 
-`remove [targets]`
+`remove [<targets>]`
 
 ## Arguments
 
-`[targets]` [Selector](../target-selectors.md)
+`<targets>` [Selector](../target-selectors.md)
 
 Specifies the target(s) to remove. If not specified, defaults to the player who executed the command.
 

commands/remove.md

@@ -12,15 +12,15 @@ description: Manages and displays scores for various scoreboard objectives.
 
 Lists all existing objectives with their display names and criteria
 
-`scoreboard objectives add <objective> <criterion> [displayName]`
+`scoreboard objectives add <objective> <criterion> [<displayName>]`
 
-Creates a new objective with the givven internal objective name, specified criterion, and the optional display name.
+Creates a new objective with the given internal objective name, specified criterion, and the optional display name (display name defaults to internal name if unspecified).
 
 `scoreboard objectives remove <objective>`
 
 Deletes the named objective from the scoreboard system. Data is deleted from the objectives list, and if it was on a display list it is no longer displayed.
 
-`scoreboard objectives setdisplay <slot> [objective] [ascending|descending]`
+`scoreboard objectives setdisplay <slot> [<objective>] [ascending|descending]`
 
 Displays score info for the objective in the given slot. Note that the objective parameter is optional; if no objective is provided, this display slot is cleared (returned to its default state). If slot is `sidebar`, there is an additional optional argument `ascending|descending` to specify the sort order (added in v2.0).
 
@@ -80,9 +80,9 @@ Any valid [Minetest colorstring](https://api.minetest.net/colors) or team color.
 
 ### Syntax
 
-`scoreboard players list [targets]`
+`scoreboard players list [<targets>]`
 
-Lists all score holders that are tracked in some way by the scoreboard system. The optional `[targets]` parameter is used to list the scores of particular score holders.
+Lists all score holders that are tracked in some way by the scoreboard system. The optional `[<targets>]` parameter is used to list the scores of particular score holders.
 
 `scoreboard players get <target> <objective>`
 
@@ -100,17 +100,17 @@ Increments the targets' scores in that objective by the given amount. A negative
 
 Decrements the targets' scores in that objective by the given amount. A negative number adds to the score.
 
-`scoreboard players reset <targets> [objective]`
+`scoreboard players reset <targets> [<objective>]`
 
 Deletes score or all scores for the targets. If `[objective]` is specified, then only that objective is cleared. Otherwise, this applies to all objectives.
 
 Note that this does not merely set the scores to 0: it removes the targets from the scoreboard system (or for the given objective) altogether.
 
 This also disables the target players' ability to use `/trigger` command (on the given objective if specified).
 
-`scoreboard players test <player> <objective> [min] [max]`
+`scoreboard players test <player> <objective> [<min>] [<max>]`
 
-Test if scores are between min and max (`[min]` and `[max]` default to -99,999,999,999,999 and 100,000,000,000,000 if not specified or `*`).
+Test if scores are between min and max (`[<min>]` and `[<max>]` default to -99,999,999,999,999 and 100,000,000,000,000 if not specified or `*`).
 
 `scoreboard players enable <targets> <objective>`
 
@@ -124,9 +124,9 @@ Note that if any of the targets did not previously have a score for that scorebo
 
 Applies an arithmetic operation altering the targets' scores in the target objective, using sources' scores in the source objective as input.
 
-`scoreboard players display name <targets> <objective> [displayName]`
+`scoreboard players display name <targets> <objective> [<displayName>]`
 
-Changes the display name of the targets' scores (if `[displayName]` is not specified, display name is reset).
+Changes the display name of the targets' scores (if `<displayName>` is not specified, display name is reset).
 
 `scoreboard players display numberformat <targets> <objective> blank`
 
@@ -164,7 +164,7 @@ Must be a single word containing only alphanumeric characters and underscores.
 
 Specifies the new score, or an amount to add/subtract from the score. Must be a number from -99,999,999,999,999 to 100,000,000,000,000.
 
-`[min]`/`[max]` [Number](../data-types.md#number) or `*`
+`<min>`/`<max>` [Number](../data-types.md#number) or `*`
 
 Specifies the minimum and maximum value.
 
@@ -178,7 +178,7 @@ Specifies the objective for targets.
 
 Must be a single word containing only alphanumeric characters and underscores.
 
-`<source>` [Selector](../target-selectors.md) or (../data-types.md#string)
+`<source>` [Selector](../target-selectors.md) or \[String]\(../data-types.md#string)
 
 Specifies the source score holders whose scores are used as source inputs.
 
@@ -202,7 +202,7 @@ Valid values:
 
 In all cases except `><`, source's score remains unchanged when performing the operation on a target. If target or source isn't tracked by the specified objective, it is set to 0. If more than one score holder is specified as sources, performs the operation once with each source's score. If more than one target score holder is specified, performs the operation for each target one by one.
 
-`[displayName]` [Long string](../data-types.md#long-string)
+`<displayName>` [Long string](../data-types.md#long-string)
 
 Specifies the display name.
 

commands/scoreboard.md

@@ -6,11 +6,11 @@ description: Sets players' respawn points
 
 ## Syntax
 
-`/spawnpoint [targets]`
+`/spawnpoint [<targets>]`
 
 ## Arguments
 
-`[targets]` [Selector](../data-types.md#selector)
+`<targets>` [Selector](../data-types.md#selector)
 
 The player(s) to set the spawnpoint for. If omitted, defaults to the executor.
 

commands/spawnpoint.md

@@ -6,21 +6,21 @@ description: Summons an entity.
 
 ## Syntax
 
-`summon <entity> [pos] [rot]`
+`summon <entity> [<pos>] [<rot>]`
 
-`summon <entity> [pos] [facing <target>]`
+`summon <entity> [<pos>] [facing <target>]`
 
 ## Arguments
 
 `<entity>` [String](../data-types.md#string) (entity ID or alias)
 
 Specifies the entity to be summoned. You can include the entity's staticdata in \[square brackets]. If an entity alias is used, and the alias matches multiple different entities, chooses a random one.
 
-`[pos]` [Position](../data-types.md#position)
+`<pos>` [Position](../data-types.md#position)
 
 Specifies the position to summon the entity. If not specified, defaults to the position of the command's execution.
 
-`[rot]` [Rotation](../data-types.md#rotation)
+`<rot>` [Rotation](../data-types.md#rotation)
 
 Specifies the rotation (yaw and optionally pitch) of the summoned entity. If not specified, defaults to the rotation of the command's executor.
 

commands/summon.md

@@ -6,11 +6,11 @@ description: Controls teams.
 
 ## Syntax
 
-`team list [team]`
+`team list [<team>]`
 
 Lists all teams, with their display names and the amount of entities in them. The optional `[team]` can be used to specify a particular team.
 
-`team add <team> [displayName]`
+`team add <team> [<displayName>]`
 
 Creates a team with the given name and optional display name. `[displayName]` defaults to `<team>` when unspecified.
 
@@ -22,11 +22,11 @@ Deletes the specified team.
 
 Removes all members from the named team.
 
-`team join <team> [members]`
+`team join <team> [<members>]`
 
 Assigns the specified entities to the specified team. If no entities are specified, makes the executor join the team.
 
-`team leave [members]`
+`team leave [<members>]`
 
 Makes the specified entities leave their teams. If no entities are specified, makes the executor leave their team.
 
@@ -42,11 +42,11 @@ Specifies the name of a team.
 
 Must be a single word containing only alphanumeric characters and underscores.
 
-`[displayName]` [Long string](../data-types.md#long-string)
+`<displayName>` [Long string](../data-types.md#long-string)
 
 Specifies the team name to be displayed.
 
-`[members]` [Selector](../target-selectors.md) or (../data-types.md#string)
+`<members>` [Selector](../target-selectors.md) or (../data-types.md#string)
 
 Specifies the entities to join or leave the team.