aboutsummaryrefslogtreecommitdiff
path: root/help
diff options
context:
space:
mode:
Diffstat (limited to 'help')
-rw-r--r--help/README.md17
-rw-r--r--help/beginexpression.md2
-rw-r--r--help/catch.md4
-rw-r--r--help/ceiling_maximum.md2
-rw-r--r--help/choose.md2
-rw-r--r--help/classify_indexof.md10
-rw-r--r--help/comment.md2
-rw-r--r--help/conjugate_add.md2
-rw-r--r--help/constant.md4
-rw-r--r--help/currentfunction.md2
-rw-r--r--help/currentmodifier.md3
-rw-r--r--help/define.md2
-rw-r--r--help/deshape_reshape.md4
-rw-r--r--help/each.md2
-rw-r--r--help/enclose_lessthan.md2
-rw-r--r--help/export.md4
-rw-r--r--help/floor_minimum.md2
-rw-r--r--help/fold.md2
-rwxr-xr-xhelp/genhelp.bqn9
-rw-r--r--help/gradedown_binsdown.md2
-rw-r--r--help/gradeup_binsup.md2
-rw-r--r--help/indices_replicate.md2
-rw-r--r--help/infinity.md2
-rw-r--r--help/insert.md4
-rw-r--r--help/join_jointo.md2
-rw-r--r--help/markfirst_memberof.md4
-rw-r--r--help/negate_subtract.md2
-rw-r--r--help/nullcharacter.md4
-rw-r--r--help/occurrencecount_progressiveindexof.md4
-rw-r--r--help/pi.md2
-rw-r--r--help/range_windows.md6
-rw-r--r--help/repeat.md4
-rw-r--r--help/reverse_rotate.md4
-rw-r--r--help/separator.md12
-rw-r--r--help/separator1.md15
-rw-r--r--help/system.md2
-rw-r--r--help/table.md2
37 files changed, 69 insertions, 83 deletions
diff --git a/help/README.md b/help/README.md
index d7c505d2..cfb5f57f 100644
--- a/help/README.md
+++ b/help/README.md
@@ -39,11 +39,10 @@ Symbols are listed in alphabetical order of page name, ignoring syntactical role
| `⋈` | [Enlist, Pair](enlist_pair.md) |
| `⋆` | [Exponential, Power](exponential_power.md) |
| `⇐` | [Export Definition, Export names](export.md) |
-| `.` | [Namespace Field](field.md) |
| `⊏` | [First Cell, Select](firstcell_select.md) |
| `⊑` | [First, Pick](first_pick.md) |
| `⌊` | [Floor, Minimum](floor_minimum.md) |
-| `´` | [Fold, Fold With initial](fold.md) |
+| `´` | [Fold, Fold With Initial](fold.md) |
| `⍒` | [Grade Down, Bins Down](gradedown_binsdown.md) |
| `⍋` | [Grade Up, Bins Up](gradeup_binsup.md) |
| `≥` | [Greater Than or Equal To](greaterthanorequalto.md) |
@@ -52,15 +51,16 @@ Symbols are listed in alphabetical order of page name, ignoring syntactical role
| `⊢` | [Identity, Right](identity_right.md) |
| `/` | [Indices, Replicate](indices_replicate.md) |
| `∞` | [Infinity](infinity.md) |
-| `˝` | [Insert, Insert With initial](insert.md) |
-| `∾` | [Join, Join](join_jointo.md) |
+| `˝` | [Insert, Insert With Initial](insert.md) |
+| `∾` | [Join, Join To](join_jointo.md) |
| `𝕨` | [Left Argument](leftargument.md) |
| `≠` | [Length, Not Equal To](length_notequals.md) |
| `≤` | [Lesser Than or Equal To](lessthanorequalto.md) |
-| `∊` | [Unique Mask, Member Of](markfirst_memberof.md) |
+| `∊` | [Mark Firsts, Member Of](markfirst_memberof.md) |
| `>` | [Merge, Greater Than](merge_greaterthan.md) |
| `¯` | [Minus](minus.md) |
| `𝔽` | [Modifier Left operand](modifierleftoperand.md) |
+| `.` | [Namespace Field](namespacefield.md) |
| `-` | [Negate, Subtract](negate_subtract.md) |
| `·` | [Nothing](nothing.md) |
| `¬` | [Logical Not, Span](not_span.md) |
@@ -74,12 +74,11 @@ Symbols are listed in alphabetical order of page name, ignoring syntactical role
| `⎉` | [Rank](rank.md) |
| `÷` | [Reciprocal, Divide](reciprocal_divide.md) |
| `⍟` | [Repeat](repeat.md) |
-| `⌽` | [Reverse, Dyad](reverse_rotate.md) |
+| `⌽` | [Reverse, Rotate](reverse_rotate.md) |
| `𝕩` | [Right Argument](rightargument.md) |
| `` ` `` | [Scan, Scan With initial](scan.md) |
| `˜` | [Self, Swap](self_swap.md) |
-| `,` | [Separator](separator1.md) |
-| `⋄` | [Separator](separator.md) |
+| `,` or `⋄` | [Separator](separator.md) |
| `≢` | [Shape, Not Match](shape_notmatch.md) |
| `»` | [Shift After, Shift After](shiftafter.md) |
| `«` | [Shift Before, Shift Before](shiftbefore.md) |
@@ -91,7 +90,7 @@ Symbols are listed in alphabetical order of page name, ignoring syntactical role
| `‿` | [Strand](strand.md) |
| `↓` | [Suffixes, Drop](suffixes_drop.md) |
| `•` | [System](system.md) |
-| `⌜` | [Each](table.md) |
+| `⌜` | [Table](table.md) |
| `⍉` | [Transpose, Reorder Axes](transpose_reorderaxes.md) |
| `⌾` | [Under](under.md) |
| `⁼` | [Undo](undo.md) |
diff --git a/help/beginexpression.md b/help/beginexpression.md
index 231fa81c..1ac50082 100644
--- a/help/beginexpression.md
+++ b/help/beginexpression.md
@@ -6,7 +6,7 @@
Starts an expression, and only one expression. Must end with a corresponding `)`.
-`(` gives higher precedence to the expression in it, and BQN will evaluate expressions in `()` first.
+`(` supercedes any precedence order, so that an expression in `()` is evaluated fully before it can be used in the outer context.
1 + 2 - 3
diff --git a/help/catch.md b/help/catch.md
index a14cb6d1..b3ce426f 100644
--- a/help/catch.md
+++ b/help/catch.md
@@ -6,9 +6,9 @@
Apply `𝔽` to the arguments.
-If an error happens when `𝔽` is applied, cancel its execution, apply `𝔾` to the arguments and return the results.
+If an error happens when `𝔽` is applied, cancel its execution, apply `𝔾` to the arguments and return its result.
-Otherwise, return the results of `𝔽`.
+Otherwise, return the result of `𝔽`.
∾⎊{"error occurred with argument: "∾•Fmt 𝕩} 1
diff --git a/help/ceiling_maximum.md b/help/ceiling_maximum.md
index 63bf007e..de123a23 100644
--- a/help/ceiling_maximum.md
+++ b/help/ceiling_maximum.md
@@ -4,7 +4,7 @@
## `⌈ 𝕩`: Ceiling
-Round `𝕩` up.
+Round `𝕩` up to the nearest integer.
[Pervasive.](../doc/arithmetic.md#pervasion)
diff --git a/help/choose.md b/help/choose.md
index 0fa6fcb5..3c03c1ec 100644
--- a/help/choose.md
+++ b/help/choose.md
@@ -4,7 +4,7 @@
## `𝔽◶𝕘 𝕩`, `𝕨 𝔽◶𝕘 𝕩`: Choose
-Apply `𝔽` to the arguments and pick a function from list `𝕘`. Apply the picked function to the arguments.
+Apply `𝔽` to the arguments and use the result to [pick](first_pick.md#𝕨--𝕩-pick) (`⊑`) a function from list `𝕘`. Apply the picked function to the arguments.
F ← ⊢◶+‿-‿÷‿×
diff --git a/help/classify_indexof.md b/help/classify_indexof.md
index a9f4f4e8..32d926f1 100644
--- a/help/classify_indexof.md
+++ b/help/classify_indexof.md
@@ -4,7 +4,7 @@
## `⊐ 𝕩`: Classify
-First index of each major cell of `𝕩` in `𝕩`.
+Translate major cells of `𝕩` to unique ID numbers based on first occurrence.
⊐ 5‿6‿2‿2‿5‿1
@@ -16,12 +16,12 @@ First index of each major cell of `𝕩` in `𝕩`.
## `𝕨 ⊐ 𝕩`: Index Of
-First index of each major cell of `𝕩` in `𝕨`. Rank of `𝕩` must be at least cell rank of 𝕨`.
+First index of each major cell of `𝕩` in `𝕨`. Rank of `𝕩` must be at least cell rank of `𝕨`.
-If a cell is not found in `𝕨`, that position will contain the length of `𝕨` (`≠𝕨`).
+If a cell is not found in `𝕨`, the length of `𝕨` (`≠𝕨`) is used for that position.
- 5‿6‿2‿2‿5‿1 ⊐ 5‿2‿1‿6
+ 5‿6‿2‿2‿5‿1 ⊐ 5‿7‿1‿6
b ← 3‿3 ⥊ 0‿1‿2‿9‿0‿9‿0‿1‿2
- b ⊐ ⟨9‿0‿9⟩
+ b ⊐ ≍9‿0‿9
diff --git a/help/comment.md b/help/comment.md
index 79e9c081..e4002008 100644
--- a/help/comment.md
+++ b/help/comment.md
@@ -4,7 +4,7 @@
## `#`: Comment
-Create a comment that extends till the end of a line.
+Create a comment that extends to the end of the line.
Anything written in comments is ignored.
diff --git a/help/conjugate_add.md b/help/conjugate_add.md
index 199e6cb3..9def6172 100644
--- a/help/conjugate_add.md
+++ b/help/conjugate_add.md
@@ -4,6 +4,8 @@
## `+ 𝕩`: Conjugate
+Complex conjugate of `𝕩`. BQN doesn't support complex numbers yet, so it has no effect.
+
+ 1
+ ¯1
diff --git a/help/constant.md b/help/constant.md
index d964ff3e..32899093 100644
--- a/help/constant.md
+++ b/help/constant.md
@@ -6,6 +6,6 @@
Returns a function that will always return `𝕗`.
- "hello" (1 ˙) 2
+ "hello" 1˙ 2
- "hello" ({𝕨+𝕩} ˙) 2
+ "hello" {𝕨+𝕩}˙ 2
diff --git a/help/currentfunction.md b/help/currentfunction.md
index 34ceb1a7..a47150d7 100644
--- a/help/currentfunction.md
+++ b/help/currentfunction.md
@@ -4,7 +4,7 @@
## `𝕊`: Current Function
-A variable assigned to the current function block. `𝕤` can be used to access the current function block as a subject.
+A variable assigned to the current function block. `𝕤` accesses the same value but has a subject role.
`𝕊` can be used for recursion.
diff --git a/help/currentmodifier.md b/help/currentmodifier.md
index 590ec680..50d2f12d 100644
--- a/help/currentmodifier.md
+++ b/help/currentmodifier.md
@@ -4,7 +4,6 @@
## `𝕣`: Current Modifier
-A variable assigned to the current modifier block. Underscores must be added to the beginning and/or end (`_𝕣`, `_𝕣_`) to use the modifier with the correct role.
-
+A variable assigned to the current modifier block. Add underscores to the beginning and/or end (`_𝕣`, `_𝕣_`) to use it in a modifier role.
+{𝕣⊣𝕩} 4
diff --git a/help/define.md b/help/define.md
index 9947af70..eb9af748 100644
--- a/help/define.md
+++ b/help/define.md
@@ -6,7 +6,7 @@
Defines a new variable with name `n` and value `v`.
-Variable `n` must not already exist.
+Variable `n` must not already exist in the scope.
⊢ a ← 1
diff --git a/help/deshape_reshape.md b/help/deshape_reshape.md
index 8402682e..16e4bffb 100644
--- a/help/deshape_reshape.md
+++ b/help/deshape_reshape.md
@@ -4,7 +4,7 @@
## `⥊ 𝕩`: Deshape
-Put all elements of `𝕩` in a rank 1 array, converting to array if necessary.
+Put all elements of `𝕩` in a rank 1 array, promoting to an array if necessary.
⥊ 1
@@ -14,7 +14,7 @@ Put all elements of `𝕩` in a rank 1 array, converting to array if necessary.
## `𝕨 ⥊ 𝕩`: Reshape
-Put all elements of `𝕩` in an array of shape `𝕨`, adding or removing elements if necessary.
+Put all elements of `𝕩` in an array of shape `𝕨`, removing elements or repeating them cyclically if necessary.
A single element in `𝕩` can be a function, which will be replaced with an appropriate length:
- `∘` Exact fit
diff --git a/help/each.md b/help/each.md
index 287587bc..4b2f3cc6 100644
--- a/help/each.md
+++ b/help/each.md
@@ -4,7 +4,7 @@
## `𝔽¨ 𝕩`, `𝕨 𝔽¨ 𝕩`: Each
-Apply `𝔽` to/between the major elements of the arguments. (`𝔽⚇¯1`)
+Apply `𝔽` to/between the elements of the arguments. (`𝔽⚇¯1`)
<¨ 1‿2‿3
diff --git a/help/enclose_lessthan.md b/help/enclose_lessthan.md
index 9089248a..d0d4404f 100644
--- a/help/enclose_lessthan.md
+++ b/help/enclose_lessthan.md
@@ -4,7 +4,7 @@
## `< 𝕩`: Enclose
-Create a unit array containing `𝕩`. (`(≢𝕩) ≡ ⟨⟩`)
+Create a unit array containing `𝕩`. (`(≢<𝕩) ≡ ⟨⟩`)
<1
diff --git a/help/export.md b/help/export.md
index c19e7f83..3ae604be 100644
--- a/help/export.md
+++ b/help/export.md
@@ -4,7 +4,7 @@
## `n ⇐ v`: Export Definition
-Define a variable with name `n` and export it from the current namespace or program's scope.
+Define a variable with name `n` and export it from the current namespace.
ns ← { exported ⇐ 5, unexported ← 0}
ns.exported
@@ -12,7 +12,7 @@ Define a variable with name `n` and export it from the current namespace or prog
## `𝕨 ⇐`: Export names
-Export the names given in `𝕩` from the current namespace or program's scope. Names must be defined.
+Export the names given in `𝕩` from the current namespace. Names must be defined somewhere in the scope.
ns1 ← { ⟨alsoexported⟩⇐, exported ⇐ 5, alsoexported ← 0}
ns1.exported
diff --git a/help/floor_minimum.md b/help/floor_minimum.md
index 997c64ef..e243d4f5 100644
--- a/help/floor_minimum.md
+++ b/help/floor_minimum.md
@@ -4,7 +4,7 @@
## `⌊ 𝕩`: Floor
-Round `𝕩` down.
+Round `𝕩` down to the nearest integer.
[Pervasive.](../doc/arithmetic.md#pervasion)
diff --git a/help/fold.md b/help/fold.md
index 24c79f30..bfe19f21 100644
--- a/help/fold.md
+++ b/help/fold.md
@@ -17,7 +17,7 @@ Fold over `𝕩` with `𝔽` from right to left i.e. Insert `𝔽` between the e
1-2-3
-## `𝕨 𝔽´ 𝕩`: Fold With initial
+## `𝕨 𝔽´ 𝕩`: Fold With Initial
Monadic fold, but use `𝕨` as initial right argument.
diff --git a/help/genhelp.bqn b/help/genhelp.bqn
index b4a5b8c9..2cdfe2b6 100755
--- a/help/genhelp.bqn
+++ b/help/genhelp.bqn
@@ -1,11 +1,12 @@
-#!/usr/bin/env cbqn
+#!/usr/bin/env bqn
thing ← {
data ← •FLines 𝕩
names ← (⊣∾", "∾⊢)´{(¬·∧`' '⊸=)⊸/⌾⌽(2+⊑/':'=𝕩)↓𝕩}¨("## "≡3⊸↑)¨⊸/data
t‿d ← ∾/¨(⊏data)=¨"()"
- sym ← "`"∾˜"`"∾{'`':"` ` `"; '|':"\"∾𝕩 ; 𝕩}¯3⊑2⊑data
- •Show "| " ∾ sym ∾ " | [" ∾ names ∾ "]("∾𝕩∾ ") |"
+ sym ← (+`·»⊸-˝(¬»∧«)∘=⟜'`'∧⎉1"()"=⌜⊢)⊸/ 2⊑data
+ sym (1+'|'⊸=)⊸(/+(-´"\|")×{«⊒/𝕨})↩
+ "| " ∾ sym ∾ " | [" ∾ names ∾ "]("∾𝕩∾ ") |"
}¨•args(¬∘∊/⊣)⟨"README.md"⟩
head ← ⟨
@@ -18,4 +19,4 @@ head ← ⟨
"| Symbol | Link |"
"|--------|------|"
-"README.md" •FLines head ∾ thing #rename once you have a proper file. \ No newline at end of file
+"README.md" •FLines head ∾ thing #rename once you have a proper file.
diff --git a/help/gradedown_binsdown.md b/help/gradedown_binsdown.md
index 6aced8a8..605fd97c 100644
--- a/help/gradedown_binsdown.md
+++ b/help/gradedown_binsdown.md
@@ -16,7 +16,7 @@ Indices of `𝕩` that would sort its major cells in descending order.
## `𝕨 ⍒ 𝕩`: Bins Down
-Binary search for each element of `𝕩` in `𝕨`, and return the index found, if any.
+Binary search for each cell of `𝕩` in `𝕨`, returning the number of major cells in `𝕨` greater than or equal to that cell.
`𝕨` must be sorted in descending order.
diff --git a/help/gradeup_binsup.md b/help/gradeup_binsup.md
index e1a9ac2c..a43b76bc 100644
--- a/help/gradeup_binsup.md
+++ b/help/gradeup_binsup.md
@@ -17,7 +17,7 @@ Indices of `𝕩` that would sort its major cells in ascending order.
## `𝕨 ⍋ 𝕩`: Bins Up
-Binary search for each element of `𝕩` in `𝕨`, and return the index found, if any.
+Binary search for each cell of `𝕩` in `𝕨`, returning the number of major cells in `𝕨` less than or equal to that cell.
`𝕨` must be sorted in ascending order.
diff --git a/help/indices_replicate.md b/help/indices_replicate.md
index 4d4d5515..2e6b25f6 100644
--- a/help/indices_replicate.md
+++ b/help/indices_replicate.md
@@ -16,7 +16,7 @@ Repeat the index of each element in `𝕩` by the element's value. `𝕩` must b
Repeat each major cell in `𝕩` by the corresponding element in `𝕨`.
-Atomic `𝕨` applies to all elements.
+Unit `𝕨` applies to all elements.
3 / "copy"
diff --git a/help/infinity.md b/help/infinity.md
index e607d3f6..a3787d24 100644
--- a/help/infinity.md
+++ b/help/infinity.md
@@ -4,7 +4,7 @@
## `∞`: Infinity
-Mathematical constant Infinity. Shares the same status as other numbers, can be negative (`¯∞`).
+Mathematical constant Infinity, a numeric literal. Can be negative (`¯∞`).
diff --git a/help/insert.md b/help/insert.md
index 22e6814b..08c4cbf6 100644
--- a/help/insert.md
+++ b/help/insert.md
@@ -4,7 +4,7 @@
## `𝔽˝ 𝕩`: Insert
-Fold over `𝕩` with `𝔽` from right to left i.e. Insert `𝔽` between the major cells of `𝕩`.
+Fold over cells of `𝕩` with `𝔽` from end to start, that is, insert `𝔽` between the major cells of `𝕩`.
a ← 3‿3 ⥊ ↕9
@@ -13,7 +13,7 @@ Fold over `𝕩` with `𝔽` from right to left i.e. Insert `𝔽` between the m
0‿1‿2 + 3‿4‿5 + 6‿7‿8
-## `𝕨 𝔽˝ 𝕩`: Insert With initial
+## `𝕨 𝔽˝ 𝕩`: Insert With Initial
Monadic insert, but use `𝕨` as initial right argument.
diff --git a/help/join_jointo.md b/help/join_jointo.md
index fa70f1a3..8bae37e0 100644
--- a/help/join_jointo.md
+++ b/help/join_jointo.md
@@ -16,7 +16,7 @@ Element ranks must be compatible.
-## `𝕨 ∾ 𝕩`: Join
+## `𝕨 ∾ 𝕩`: Join To
Join `𝕨` to `𝕩` along the first axis.
diff --git a/help/markfirst_memberof.md b/help/markfirst_memberof.md
index e57552dc..cfe41c16 100644
--- a/help/markfirst_memberof.md
+++ b/help/markfirst_memberof.md
@@ -2,7 +2,7 @@
# Element Of (`∊`)
-## `∊ 𝕩`: Unique Mask
+## `∊ 𝕩`: Mark Firsts
Mark the first occurrence of each major cell in `𝕩` with a 1, and all other occurrences with a 0.
@@ -16,7 +16,7 @@ Mark the first occurrence of each major cell in `𝕩` with a 1, and all other o
## `𝕨 ∊ 𝕩`: Member Of
-Is each element in `𝕨` a major cell of `𝕩`?
+Is each cell in `𝕨` a major cell of `𝕩`?
⟨1⟩ ∊ ↕9
diff --git a/help/negate_subtract.md b/help/negate_subtract.md
index ddde712f..399c2833 100644
--- a/help/negate_subtract.md
+++ b/help/negate_subtract.md
@@ -15,7 +15,7 @@ Additive Inverse of `𝕩`.
## `𝕨 - 𝕩`: Subtract
-Subtract `𝕩` from `𝕨`. `𝕨` and `𝕩` can be characters or integers.
+Subtract `𝕩` from `𝕨`. `𝕨` and `𝕩` can be characters or numbers.
[Pervasive.](../doc/arithmetic.md#pervasion)
diff --git a/help/nullcharacter.md b/help/nullcharacter.md
index be64b878..a8469d7d 100644
--- a/help/nullcharacter.md
+++ b/help/nullcharacter.md
@@ -4,9 +4,9 @@
## `@`: Null Character
-Null character, codepoint 0 in ASCII. Has the status of any other character.
+Null character, code point 0 in ASCII. A shortcut character literal.
-Can be added to any positive integer to get its character equivalent.
+Add to a code point number to get that character.
@+50
diff --git a/help/occurrencecount_progressiveindexof.md b/help/occurrencecount_progressiveindexof.md
index 3b0fe118..e5e44179 100644
--- a/help/occurrencecount_progressiveindexof.md
+++ b/help/occurrencecount_progressiveindexof.md
@@ -4,7 +4,7 @@
## `⊒ 𝕩`: Occurrence Count
-Number of times each major cell of `𝕩` appears before itself.
+Number of times each major cell of `𝕩` has occurred before the current position.
⊒ 2‿7‿1‿8‿1‿7‿1‿8‿2‿8‿4
@@ -14,7 +14,7 @@ Number of times each major cell of `𝕩` appears before itself.
## `𝕨 ⊒ 𝕩`: Progressive Index Of
-Index of the first unused match of each major cell of `𝕩` in `𝕨`. If there are no more matches left, length of `𝕨` is placed in that position.
+Index of the first unused match of each major cell of `𝕩` in `𝕨`. If there are no more matches left, the length of `𝕨` is placed in that position.
"aaa" ⊒ "aaaaa"
diff --git a/help/pi.md b/help/pi.md
index f023cebb..c979ec38 100644
--- a/help/pi.md
+++ b/help/pi.md
@@ -4,7 +4,7 @@
## `π`: Pi
-Mathematical constant pi. Shares the same status as other numbers, can be negative (`¯π`).
+The mathematical constant pi, a numeric literal. Can be negative (`¯π`).
π
diff --git a/help/range_windows.md b/help/range_windows.md
index ce697464..73b7a398 100644
--- a/help/range_windows.md
+++ b/help/range_windows.md
@@ -4,9 +4,9 @@
## `↕ 𝕩`: Range
-Return all indices to index into an array of shape `𝕩`, in the shape described by `𝕩`.
+Return all indices that would index into an array of shape `𝕩`.
-When given a single number, range from 0 to `𝕩-1`.
+When given a single number, range from `0` to `𝕩-1`.
↕ 4
@@ -16,7 +16,7 @@ When given a single number, range from 0 to `𝕩-1`.
## `𝕨 ↕ 𝕩`: Windows
-Overlapping slices of `𝕩` which are of shape `𝕨`.
+Overlapping slices from `𝕩` of shape `𝕨`.
5 ↕ "abcdefg"
diff --git a/help/repeat.md b/help/repeat.md
index e394a593..20edf156 100644
--- a/help/repeat.md
+++ b/help/repeat.md
@@ -4,9 +4,9 @@
## `𝔽⍟𝔾 𝕩`, `𝕨 𝔽⍟𝔾 𝕩`: Repeat
-Apply `𝔾` to `𝕨` and `𝕩` and apply `𝔽` to `𝕩` that may times. If `𝕨` is given, keep it as a constant left argument.
+Apply `𝔾` to `𝕨` and `𝕩`, then apply `𝔽` to `𝕩` that may times. If `𝕨` is given, use it each time as a constant left argument.
-If `𝔾` returns an array, give `𝔽⍟𝕩` for each element.
+If `𝔾` returns an array, give `𝔽⍟𝕩` for each of its elements.
1 +⍟⊢ 4
diff --git a/help/reverse_rotate.md b/help/reverse_rotate.md
index 859fbd18..9d38940c 100644
--- a/help/reverse_rotate.md
+++ b/help/reverse_rotate.md
@@ -4,7 +4,7 @@
## `⌽ 𝕩`: Reverse
-Reverse the first axis of `𝕩`.
+Reverse `𝕩` along the first axis.
⌽ 1‿2‿3
@@ -14,7 +14,7 @@ Reverse the first axis of `𝕩`.
-## `𝕨 ⌽ 𝕩`: Dyad
+## `𝕨 ⌽ 𝕩`: Rotate
Move the first `𝕨` elements of `𝕩` to its end. Negative `𝕨` reverses the direction of rotation.
diff --git a/help/separator.md b/help/separator.md
index cb353d1f..0806317c 100644
--- a/help/separator.md
+++ b/help/separator.md
@@ -1,15 +1,15 @@
*View this file with results and syntax highlighting [here](https://mlochbaum.github.io/BQN/help/separator.html).*
-# Diamond (`⋄`)
+# Comma (`,`) and Diamond (`⋄`)
-## `⋄`: Separator
+## `,` or `⋄`: Separator
-Separates statements in blocks⋄ programs and arrays.
+Separates statements in blocks, programs, and arrays. Characters `,` and `⋄` are interchangeable with each other and with newline.
- a ← 3 ⋄ ⊢ b ← 2
+ a ← 3 , ⊢ b ← 2
- 1 ⋄ 2 ⋄ 3
+ 1 ⋄ 2 , 3
- ⟨1 ⋄ 2 ⋄ 3⟩
+ ⟨1 , 2 ⋄ 3⟩
{1 ⋄ 2 ⋄ 3}
diff --git a/help/separator1.md b/help/separator1.md
deleted file mode 100644
index 54dcb216..00000000
--- a/help/separator1.md
+++ /dev/null
@@ -1,15 +0,0 @@
-*View this file with results and syntax highlighting [here](https://mlochbaum.github.io/BQN/help/separator1.html).*
-
-# Comma (`,`)
-
-## `,`: Separator
-
-Separates statements in blocks, programs and arrays.
-
- a ← 3 , ⊢ b ← 2
-
- 1 , 2 , 3
-
- ⟨1, 2, 3⟩
-
- {1, 2, 3}
diff --git a/help/system.md b/help/system.md
index 79b1d745..532e3972 100644
--- a/help/system.md
+++ b/help/system.md
@@ -4,6 +4,6 @@
## `•`: System
-A prefix for system functions. `•listSys` gives a list of system values added in any BQN implementation.
+A prefix for system functions. `•listSys` gives a list of defined system value names.
`•` is ignored when determining the role of the system value.
diff --git a/help/table.md b/help/table.md
index 09ce05e7..49fe12b6 100644
--- a/help/table.md
+++ b/help/table.md
@@ -2,7 +2,7 @@
# Top Left Corner (`⌜`)
-## `𝕨 𝔽⌜ 𝕩`: Each
+## `𝕨 𝔽⌜ 𝕩`: Table
Apply `𝔽` between every possible pair of the elements of the arguments.