From 5566ea9429f75b54a8cffb9ebea7747ea651d52c Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Mon, 24 Jan 2022 20:13:18 -0500 Subject: Editing --- docs/help/beginexpression.html | 2 +- docs/help/catch.html | 4 ++-- docs/help/ceiling_maximum.html | 2 +- docs/help/choose.html | 2 +- docs/help/classify_indexof.html | 16 ++++++-------- docs/help/comment.html | 2 +- docs/help/conjugate_add.html | 1 + docs/help/constant.html | 4 ++-- docs/help/currentfunction.html | 2 +- docs/help/currentmodifier.html | 2 +- docs/help/define.html | 2 +- docs/help/deshape_reshape.html | 4 ++-- docs/help/each.html | 2 +- docs/help/enclose_lessthan.html | 2 +- docs/help/export.html | 4 ++-- docs/help/floor_minimum.html | 2 +- docs/help/fold.html | 2 +- docs/help/gradedown_binsdown.html | 2 +- docs/help/gradeup_binsup.html | 2 +- docs/help/index.html | 26 ++++++++++------------- docs/help/indices_replicate.html | 2 +- docs/help/infinity.html | 2 +- docs/help/insert.html | 4 ++-- docs/help/join_jointo.html | 2 +- docs/help/markfirst_memberof.html | 4 ++-- docs/help/negate_subtract.html | 2 +- docs/help/nullcharacter.html | 4 ++-- docs/help/occurrencecount_progressiveindexof.html | 4 ++-- docs/help/pi.html | 2 +- docs/help/range_windows.html | 6 +++--- docs/help/repeat.html | 4 ++-- docs/help/reverse_rotate.html | 4 ++-- docs/help/separator.html | 14 ++++++------ docs/help/separator1.html | 21 ------------------ docs/help/system.html | 2 +- docs/help/table.html | 2 +- help/README.md | 17 +++++++-------- help/beginexpression.md | 2 +- help/catch.md | 4 ++-- help/ceiling_maximum.md | 2 +- help/choose.md | 2 +- help/classify_indexof.md | 10 ++++----- help/comment.md | 2 +- help/conjugate_add.md | 2 ++ help/constant.md | 4 ++-- help/currentfunction.md | 2 +- help/currentmodifier.md | 3 +-- help/define.md | 2 +- help/deshape_reshape.md | 4 ++-- help/each.md | 2 +- help/enclose_lessthan.md | 2 +- help/export.md | 4 ++-- help/floor_minimum.md | 2 +- help/fold.md | 2 +- help/genhelp.bqn | 9 ++++---- help/gradedown_binsdown.md | 2 +- help/gradeup_binsup.md | 2 +- help/indices_replicate.md | 2 +- help/infinity.md | 2 +- help/insert.md | 4 ++-- help/join_jointo.md | 2 +- help/markfirst_memberof.md | 4 ++-- help/negate_subtract.md | 2 +- help/nullcharacter.md | 4 ++-- help/occurrencecount_progressiveindexof.md | 4 ++-- help/pi.md | 2 +- help/range_windows.md | 6 +++--- help/repeat.md | 4 ++-- help/reverse_rotate.md | 4 ++-- help/separator.md | 12 +++++------ help/separator1.md | 15 ------------- help/system.md | 2 +- help/table.md | 2 +- 73 files changed, 138 insertions(+), 178 deletions(-) delete mode 100644 docs/help/separator1.html delete mode 100644 help/separator1.md diff --git a/docs/help/beginexpression.html b/docs/help/beginexpression.html index c0373269..056524e5 100644 --- a/docs/help/beginexpression.html +++ b/docs/help/beginexpression.html @@ -7,7 +7,7 @@

Left Parenthesis (()

( ...: Begin Expression

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
 0
 
diff --git a/docs/help/catch.html b/docs/help/catch.html
index a5a546fd..2612567b 100644
--- a/docs/help/catch.html
+++ b/docs/help/catch.html
@@ -7,8 +7,8 @@
 

Circled Triangle Down (⎊)

π”½βŽŠπ”Ύ 𝕩, 𝕨 π”½βŽŠπ”Ύ 𝕩: Catch

Apply 𝔽 to the arguments.

-

If an error happens when 𝔽 is applied, cancel its execution, apply 𝔾 to the arguments and return the results.

-

Otherwise, return the results of 𝔽.

+

If an error happens when 𝔽 is applied, cancel its execution, apply 𝔾 to the arguments and return its result.

+

Otherwise, return the result of 𝔽.

↗️
       ∾⎊{"error occurred with argument: "βˆΎβ€’Fmt 𝕩} 1
 "error occurred with argument: 1"
 
diff --git a/docs/help/ceiling_maximum.html b/docs/help/ceiling_maximum.html
index 2cff2167..9b0ab05e 100644
--- a/docs/help/ceiling_maximum.html
+++ b/docs/help/ceiling_maximum.html
@@ -6,7 +6,7 @@
 
 

Left Ceiling (⌈)

⌈ 𝕩: Ceiling

-

Round 𝕩 up.

+

Round 𝕩 up to the nearest integer.

Pervasive.

↗️
      ⌈ 1.2β€ΏΟ€β€Ώ3β€Ώ7.89
 ⟨ 2 4 3 8 ⟩
diff --git a/docs/help/choose.html b/docs/help/choose.html
index 96304e0b..a337eebf 100644
--- a/docs/help/choose.html
+++ b/docs/help/choose.html
@@ -6,7 +6,7 @@
 
 

Circle with Lower Right Quadrant (β—Ά)

π”½β—Άπ•˜ 𝕩, 𝕨 π”½β—Άπ•˜ 𝕩: 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 (βŠ‘) a function from list π•˜. Apply the picked function to the arguments.

↗️
       F ← βŠ’β—Ά+β€Ώ-β€ΏΓ·β€ΏΓ—
 
        F 0
diff --git a/docs/help/classify_indexof.html b/docs/help/classify_indexof.html
index 143393be..43cc25fe 100644
--- a/docs/help/classify_indexof.html
+++ b/docs/help/classify_indexof.html
@@ -6,7 +6,7 @@
 
 

Square Original Of (⊐)

⊐ 𝕩: 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
 ⟨ 0 1 2 2 0 3 ⟩
 
@@ -16,15 +16,13 @@
 ⟨ 0 1 0 ⟩
 

𝕨 ⊐ 𝕩: Index 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 𝕨 (≠𝕨).

-↗️
       5β€Ώ6β€Ώ2β€Ώ2β€Ώ5β€Ώ1 ⊐ 5β€Ώ2β€Ώ1β€Ώ6
-⟨ 0 2 5 1 ⟩
+

First index of each major cell of 𝕩 in 𝕨. Rank of 𝕩 must be at least cell rank of 𝕨.

+

If a cell is not found in 𝕨, the length of 𝕨 (≠𝕨) is used for that position.

+↗️
       5β€Ώ6β€Ώ2β€Ώ2β€Ώ5β€Ώ1 ⊐ 5β€Ώ7β€Ώ1β€Ώ6
+⟨ 0 6 5 1 ⟩
 
        b ← 3β€Ώ3 β₯Š 0β€Ώ1β€Ώ2β€Ώ9β€Ώ0β€Ώ9β€Ώ0β€Ώ1β€Ώ2
 
-       b ⊐ ⟨9β€Ώ0β€Ώ9⟩
-β”ŒΒ·   
-Β· 3  
-    β”˜
+       b ⊐ ≍9β€Ώ0β€Ώ9
+⟨ 1 ⟩
 
diff --git a/docs/help/comment.html b/docs/help/comment.html index 725e4743..5f233682 100644 --- a/docs/help/comment.html +++ b/docs/help/comment.html @@ -6,7 +6,7 @@

Number Sign (#)

#: 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.

↗️
    1 + 2 # + 3 + 4
 3
diff --git a/docs/help/conjugate_add.html b/docs/help/conjugate_add.html
index c70fd1fb..90d6575d 100644
--- a/docs/help/conjugate_add.html
+++ b/docs/help/conjugate_add.html
@@ -6,6 +6,7 @@
 
 

Plus (+)

+ 𝕩: Conjugate

+

Complex conjugate of 𝕩. BQN doesn't support complex numbers yet, so it has no effect.

↗️
      + 1
 1
 
diff --git a/docs/help/constant.html b/docs/help/constant.html
index 7b0017f2..39d27160 100644
--- a/docs/help/constant.html
+++ b/docs/help/constant.html
@@ -7,9 +7,9 @@
 

Dot Above (Λ™)

𝔽˙ 𝕩, 𝕨 𝔽˙ 𝕩: Constant

Returns a function that will always return 𝕗.

-↗️
       "hello" (1 Λ™) 2
+↗️
       "hello" 1Λ™ 2
 1
 
-       "hello" ({𝕨+𝕩} Λ™) 2
+       "hello" {𝕨+𝕩}Λ™ 2
 (function block)
 
diff --git a/docs/help/currentfunction.html b/docs/help/currentfunction.html index 8aa11806..6da30ed7 100644 --- a/docs/help/currentfunction.html +++ b/docs/help/currentfunction.html @@ -6,7 +6,7 @@

Mathematical Double-struck S (π•Š)

π•Š: 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.

↗️
    F ← {π•Š 0: 1; 𝕩 Γ— π•Š 𝕩-1} # Factorial
     F 5
diff --git a/docs/help/currentmodifier.html b/docs/help/currentmodifier.html
index 1ee9782b..e0eaf69b 100644
--- a/docs/help/currentmodifier.html
+++ b/docs/help/currentmodifier.html
@@ -6,7 +6,7 @@
 
 

Mathematical Double-struck R (𝕣)

𝕣: 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
 (1-modifier block)
 
diff --git a/docs/help/define.html b/docs/help/define.html index 8e49ea1e..48b455e6 100644 --- a/docs/help/define.html +++ b/docs/help/define.html @@ -7,7 +7,7 @@

Leftwards Arrow (←)

n ← v: Define

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
 1
 
diff --git a/docs/help/deshape_reshape.html b/docs/help/deshape_reshape.html
index 7c6896b1..e4a4b266 100644
--- a/docs/help/deshape_reshape.html
+++ b/docs/help/deshape_reshape.html
@@ -6,7 +6,7 @@
 
 

Barb (β₯Š)

β₯Š 𝕩: 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
 ⟨ 1 ⟩
 
@@ -14,7 +14,7 @@
 ⟨ 1 2 3 4 ⟩
 

𝕨 β₯Š 𝕩: 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/docs/help/each.html b/docs/help/each.html index eb12ff29..847fb59e 100644 --- a/docs/help/each.html +++ b/docs/help/each.html @@ -6,7 +6,7 @@

    Diaresis (Β¨)

    𝔽¨ 𝕩, 𝕨 𝔽¨ 𝕩: 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/docs/help/enclose_lessthan.html b/docs/help/enclose_lessthan.html
    index 31329115..cd25e124 100644
    --- a/docs/help/enclose_lessthan.html
    +++ b/docs/help/enclose_lessthan.html
    @@ -6,7 +6,7 @@
     
     

    Lesser Than (<)

    < 𝕩: Enclose

    -

    Create a unit array containing 𝕩. ((≒𝕩) ≑ ⟨⟩)

    +

    Create a unit array containing 𝕩. ((β‰’<𝕩) ≑ ⟨⟩)

    ↗️
          <1
     β”ŒΒ·   
     Β· 1  
    diff --git a/docs/help/export.html b/docs/help/export.html
    index 5fbbef78..4b16243d 100644
    --- a/docs/help/export.html
    +++ b/docs/help/export.html
    @@ -6,7 +6,7 @@
     
     

    Leftward Double Arrow (⇐)

    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
     5
    @@ -14,7 +14,7 @@
     Error: No key found
     

    𝕨 ⇐: 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
     5
    diff --git a/docs/help/floor_minimum.html b/docs/help/floor_minimum.html
    index 92d6135e..80311137 100644
    --- a/docs/help/floor_minimum.html
    +++ b/docs/help/floor_minimum.html
    @@ -6,7 +6,7 @@
     
     

    Left Floor (⌊)

    ⌊ 𝕩: Floor

    -

    Round 𝕩 down.

    +

    Round 𝕩 down to the nearest integer.

    Pervasive.

    ↗️
          ⌊ 1.2β€ΏΟ€β€Ώ3β€Ώ7.89
     ⟨ 1 3 3 7 ⟩
    diff --git a/docs/help/fold.html b/docs/help/fold.html
    index 4737c9a8..e771ca60 100644
    --- a/docs/help/fold.html
    +++ b/docs/help/fold.html
    @@ -20,7 +20,7 @@
            1-2-3
     2
     
    -

    𝕨 𝔽´ 𝕩: Fold With initial

    +

    𝕨 𝔽´ 𝕩: Fold With Initial

    Monadic fold, but use 𝕨 as initial right argument.

    ↗️
           5 +Β΄ 1β€Ώ2β€Ώ3
     11
    diff --git a/docs/help/gradedown_binsdown.html b/docs/help/gradedown_binsdown.html
    index 2491ab57..24a10693 100644
    --- a/docs/help/gradedown_binsdown.html
    +++ b/docs/help/gradedown_binsdown.html
    @@ -16,7 +16,7 @@
     ⟨ 3 2 1 ⟩
     

    𝕨 ⍒ 𝕩: 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.

    Right Pervasive.

    ↗️
           7β€Ώ5β€Ώ4β€Ώ3 ⍒ 2
    diff --git a/docs/help/gradeup_binsup.html b/docs/help/gradeup_binsup.html
    index 580798e9..2f2668e7 100644
    --- a/docs/help/gradeup_binsup.html
    +++ b/docs/help/gradeup_binsup.html
    @@ -16,7 +16,7 @@
     ⟨ 1 2 3 ⟩
     

    𝕨 ⍋ 𝕩: 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.

    ↗️
           3β€Ώ4β€Ώ5β€Ώ7 ⍋ 2
     β”ŒΒ·   
    diff --git a/docs/help/index.html b/docs/help/index.html
    index a47d3eda..34424c90 100644
    --- a/docs/help/index.html
    +++ b/docs/help/index.html
    @@ -147,10 +147,6 @@
     Export Definition, Export names
     
     
    -.
    -Namespace Field
    -
    -
     ⊏
     First Cell, Select
     
    @@ -164,7 +160,7 @@
     
     
     Β΄
    -Fold, Fold With initial
    +Fold, Fold With Initial
     
     
     ⍒
    @@ -200,11 +196,11 @@
     
     
     ˝
    -Insert, Insert With initial
    +Insert, Insert With Initial
     
     
     ∾
    -Join, Join
    +Join, Join To
     
     
     𝕨
    @@ -220,7 +216,7 @@
     
     
     ∊
    -Unique Mask, Member Of
    +Mark Firsts, Member Of
     
     
     >
    @@ -235,6 +231,10 @@
     Modifier Left operand
     
     
    +.
    +Namespace Field
    +
    +
     -
     Negate, Subtract
     
    @@ -288,7 +288,7 @@
     
     
     ⌽
    -Reverse, Dyad
    +Reverse, Rotate
     
     
     𝕩
    @@ -303,11 +303,7 @@
     Self, Swap
     
     
    -,
    -Separator
    -
    -
    -β‹„
    +, or β‹„
     Separator
     
     
    @@ -356,7 +352,7 @@
     
     
     ⌜
    -Each
    +Table
     
     
     ⍉
    diff --git a/docs/help/indices_replicate.html b/docs/help/indices_replicate.html
    index 56590c4d..0f943ccf 100644
    --- a/docs/help/indices_replicate.html
    +++ b/docs/help/indices_replicate.html
    @@ -15,7 +15,7 @@
     

    𝕨 / 𝕩: Replicate

    Repeat each major cell in 𝕩 by the corresponding element in 𝕨.

    -

    Atomic 𝕨 applies to all elements.

    +

    Unit 𝕨 applies to all elements.

    ↗️
           3 / "copy"
     "cccooopppyyy"
     
    diff --git a/docs/help/infinity.html b/docs/help/infinity.html
    index 7aaa1bdd..8f6f1a6d 100644
    --- a/docs/help/infinity.html
    +++ b/docs/help/infinity.html
    @@ -6,7 +6,7 @@
     
     

    Infinity (∞)

    ∞: 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/docs/help/insert.html b/docs/help/insert.html
    index 1206deed..5a01cd21 100644
    --- a/docs/help/insert.html
    +++ b/docs/help/insert.html
    @@ -6,7 +6,7 @@
     
     

    Double Acute Accent (˝)

    𝔽˝ 𝕩: 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
     
            +˝ a
    @@ -15,7 +15,7 @@
            0β€Ώ1β€Ώ2 + 3β€Ώ4β€Ώ5 + 6β€Ώ7β€Ώ8
     ⟨ 9 12 15 ⟩
     
    -

    𝕨 𝔽˝ 𝕩: Insert With initial

    +

    𝕨 𝔽˝ 𝕩: Insert With Initial

    Monadic insert, but use 𝕨 as initial right argument.

    If

    ↗️
           b ← 3β€Ώ3 β₯Š ↕9
    diff --git a/docs/help/join_jointo.html b/docs/help/join_jointo.html
    index 46cd0df2..5e324aab 100644
    --- a/docs/help/join_jointo.html
    +++ b/docs/help/join_jointo.html
    @@ -21,7 +21,7 @@
       3 3 3 3 4 4 5 5 5 5 5  
                             β”˜
     
    -

    𝕨 ∾ 𝕩: Join

    +

    𝕨 ∾ 𝕩: Join To

    Join 𝕨 to 𝕩 along the first axis.

    ↗️
           "abcd" ∾ "EFG"
     "abcdEFG"
    diff --git a/docs/help/markfirst_memberof.html b/docs/help/markfirst_memberof.html
    index 10dfc4e7..e3e82512 100644
    --- a/docs/help/markfirst_memberof.html
    +++ b/docs/help/markfirst_memberof.html
    @@ -5,7 +5,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.

    ↗️
           ∊ 4β€Ώ5β€Ώ6β€Ώ6β€Ώ4β€Ώ7β€Ώ5
     ⟨ 1 1 1 0 0 1 0 ⟩
    @@ -16,7 +16,7 @@
     ⟨ 1 1 1 ⟩
     

    𝕨 ∊ 𝕩: Member Of

    -

    Is each element in 𝕨 a major cell of 𝕩?

    +

    Is each cell in 𝕨 a major cell of 𝕩?

    ↗️
           ⟨1⟩ ∊ ↕9
     ⟨ 1 ⟩
     
    diff --git a/docs/help/negate_subtract.html b/docs/help/negate_subtract.html
    index 91c689cf..cd2b52e4 100644
    --- a/docs/help/negate_subtract.html
    +++ b/docs/help/negate_subtract.html
    @@ -15,7 +15,7 @@
     1
     

    𝕨 - 𝕩: Subtract

    -

    Subtract 𝕩 from 𝕨. 𝕨 and 𝕩 can be characters or integers.

    +

    Subtract 𝕩 from 𝕨. 𝕨 and 𝕩 can be characters or numbers.

    Pervasive.

    ↗️
          1 - 2
     Β―1
    diff --git a/docs/help/nullcharacter.html b/docs/help/nullcharacter.html
    index 506cfcf6..753d2d3c 100644
    --- a/docs/help/nullcharacter.html
    +++ b/docs/help/nullcharacter.html
    @@ -6,8 +6,8 @@
     
     

    Commercial At (@)

    @: Null Character

    -

    Null character, codepoint 0 in ASCII. Has the status of any other character.

    -

    Can be added to any positive integer to get its character equivalent.

    +

    Null character, code point 0 in ASCII. A shortcut character literal.

    +

    Add to a code point number to get that character.

    ↗️
        @+50
     '2'
     
    diff --git a/docs/help/occurrencecount_progressiveindexof.html b/docs/help/occurrencecount_progressiveindexof.html
    index 8bace1ab..77b1a84a 100644
    --- a/docs/help/occurrencecount_progressiveindexof.html
    +++ b/docs/help/occurrencecount_progressiveindexof.html
    @@ -6,7 +6,7 @@
     
     

    Square Original Of or Equal To (βŠ’)

    βŠ’ 𝕩: 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
     ⟨ 0 0 0 0 1 1 2 1 1 2 0 ⟩
     
    @@ -17,7 +17,7 @@
                             β”˜
     

    𝕨 βŠ’ 𝕩: 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"
     ⟨ 0 1 2 3 3 ⟩
     
    diff --git a/docs/help/pi.html b/docs/help/pi.html
    index 1ed7b0b5..0dd7e8bd 100644
    --- a/docs/help/pi.html
    +++ b/docs/help/pi.html
    @@ -6,7 +6,7 @@
     
     

    Pi (Ο€)

    Ο€: Pi

    -

    Mathematical constant pi. Shares the same status as other numbers, can be negative (Β―Ο€).

    +

    The mathematical constant pi, a numeric literal. Can be negative (Β―Ο€).

    ↗️
        Ο€
     3.141592653589793
     
    diff --git a/docs/help/range_windows.html b/docs/help/range_windows.html
    index e480c331..830c0fe0 100644
    --- a/docs/help/range_windows.html
    +++ b/docs/help/range_windows.html
    @@ -6,8 +6,8 @@
     
     

    Up Down Arrow (↕)

    ↕ 𝕩: Range

    -

    Return all indices to index into an array of shape 𝕩, in the shape described by 𝕩.

    -

    When given a single number, range from 0 to 𝕩-1.

    +

    Return all indices that would index into an array of shape 𝕩.

    +

    When given a single number, range from 0 to 𝕩-1.

    ↗️
           ↕ 4
     ⟨ 0 1 2 3 ⟩
     
    @@ -20,7 +20,7 @@
                                               β”˜
     

    𝕨 ↕ 𝕩: Windows

    -

    Overlapping slices of 𝕩 which are of shape 𝕨.

    +

    Overlapping slices from 𝕩 of shape 𝕨.

    ↗️
           5 ↕ "abcdefg"
     β”Œβ”€       
     β•΅"abcde  
    diff --git a/docs/help/repeat.html b/docs/help/repeat.html
    index 67d8e002..edfe00b9 100644
    --- a/docs/help/repeat.html
    +++ b/docs/help/repeat.html
    @@ -6,8 +6,8 @@
     
     

    Circle Star (⍟)

    π”½βŸπ”Ύ 𝕩, 𝕨 π”½βŸπ”Ύ 𝕩: Repeat

    -

    Apply 𝔾 to 𝕨 and 𝕩 and apply 𝔽 to 𝕩 that may times. If 𝕨 is given, keep it as a constant left argument.

    -

    If 𝔾 returns an array, give π”½βŸπ•© for each element.

    +

    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 of its elements.

    ↗️
           1 +⍟⊒ 4
     8
     
    diff --git a/docs/help/reverse_rotate.html b/docs/help/reverse_rotate.html
    index e1885019..538005c9 100644
    --- a/docs/help/reverse_rotate.html
    +++ b/docs/help/reverse_rotate.html
    @@ -6,7 +6,7 @@
     
     

    Circle Stile (⌽)

    ⌽ 𝕩: Reverse

    -

    Reverse the first axis of 𝕩.

    +

    Reverse 𝕩 along the first axis.

    ↗️
           ⌽ 1β€Ώ2β€Ώ3
     ⟨ 3 2 1 ⟩
     
    @@ -19,7 +19,7 @@
       0 1 2  
             β”˜
     
    -

    𝕨 ⌽ 𝕩: Dyad

    +

    𝕨 ⌽ 𝕩: Rotate

    Move the first 𝕨 elements of 𝕩 to its end. Negative 𝕨 reverses the direction of rotation.

    ↗️
           2 ⌽ 1β€Ώ2β€Ώ3
     ⟨ 3 1 2 ⟩
    diff --git a/docs/help/separator.html b/docs/help/separator.html
    index fdd26920..94350f77 100644
    --- a/docs/help/separator.html
    +++ b/docs/help/separator.html
    @@ -1,19 +1,19 @@
     
       
       
    -  BQN: Diamond (β‹„)
    +  BQN: Comma (,) and Diamond (β‹„)
     
     
    -

    Diamond (β‹„)

    -

    β‹„: Separator

    -

    Separates statements in blocksβ‹„ programs and arrays.

    -↗️
        a ← 3 β‹„ ⊒ b ← 2
    +

    Comma (,) and Diamond (β‹„)

    +

    , or β‹„: Separator

    +

    Separates statements in blocks, programs, and arrays. Characters , and β‹„ are interchangeable with each other and with newline.

    +↗️
        a ← 3 , ⊒ b ← 2
     2
     
    -    1 β‹„ 2 β‹„ 3
    +    1 β‹„ 2 , 3
     3
     
    -    ⟨1 β‹„ 2 β‹„ 3⟩
    +    ⟨1 , 2 β‹„ 3⟩
     ⟨ 1 2 3 ⟩
     
         {1 β‹„ 2 β‹„ 3}
    diff --git a/docs/help/separator1.html b/docs/help/separator1.html
    deleted file mode 100644
    index 958d00a7..00000000
    --- a/docs/help/separator1.html
    +++ /dev/null
    @@ -1,21 +0,0 @@
    -
    -  
    -  
    -  BQN: Comma (,)
    -
    -
    -

    Comma (,)

    -

    ,: Separator

    -

    Separates statements in blocks, programs and arrays.

    -↗️
        a ← 3 , ⊒ b ← 2
    -2
    -
    -    1 , 2 , 3
    -3
    -
    -    ⟨1, 2, 3⟩
    -⟨ 1 2 3 ⟩
    -
    -    {1, 2, 3}
    -3
    -
    diff --git a/docs/help/system.html b/docs/help/system.html index 682c97a2..e3094079 100644 --- a/docs/help/system.html +++ b/docs/help/system.html @@ -6,5 +6,5 @@

    Bullet (β€’)

    β€’: 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/docs/help/table.html b/docs/help/table.html index 30e52d2a..2c405ade 100644 --- a/docs/help/table.html +++ b/docs/help/table.html @@ -5,7 +5,7 @@

    Top Left Corner (⌜)

    -

    𝕨 π”½βŒœ 𝕩: Each

    +

    𝕨 π”½βŒœ 𝕩: Table

    Apply 𝔽 between every possible pair of the elements of the arguments.

    ↗️
           1β€Ώ2β€Ώ3β€Ώ4 +⌜ 4β€Ώ5β€Ώ6β€Ώ7
     β”Œβ”€           
    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.
     
    -- 
    cgit v1.2.3