From fa3c016ad6e51d9bec120a770a7a7d6b2be75007 Mon Sep 17 00:00:00 2001 From: Bruce Hill Date: Sun, 21 Sep 2025 15:54:05 -0400 Subject: More deprecations of set docs stuff --- api/sets.md | 267 ------------------------------------- api/sets.yaml | 253 ----------------------------------- docs/sets.md | 78 ----------- man/man3/tomo-Set.add.3 | 34 ----- man/man3/tomo-Set.add_all.3 | 34 ----- man/man3/tomo-Set.clear.3 | 33 ----- man/man3/tomo-Set.has.3 | 35 ----- man/man3/tomo-Set.is_subset_of.3 | 36 ----- man/man3/tomo-Set.is_superset_of.3 | 36 ----- man/man3/tomo-Set.overlap.3 | 35 ----- man/man3/tomo-Set.remove.3 | 34 ----- man/man3/tomo-Set.remove_all.3 | 34 ----- man/man3/tomo-Set.with.3 | 35 ----- man/man3/tomo-Set.without.3 | 35 ----- man/man3/tomo-Table.xor.3 | 35 ----- 15 files changed, 1014 deletions(-) delete mode 100644 api/sets.md delete mode 100644 api/sets.yaml delete mode 100644 docs/sets.md delete mode 100644 man/man3/tomo-Set.add.3 delete mode 100644 man/man3/tomo-Set.add_all.3 delete mode 100644 man/man3/tomo-Set.clear.3 delete mode 100644 man/man3/tomo-Set.has.3 delete mode 100644 man/man3/tomo-Set.is_subset_of.3 delete mode 100644 man/man3/tomo-Set.is_superset_of.3 delete mode 100644 man/man3/tomo-Set.overlap.3 delete mode 100644 man/man3/tomo-Set.remove.3 delete mode 100644 man/man3/tomo-Set.remove_all.3 delete mode 100644 man/man3/tomo-Set.with.3 delete mode 100644 man/man3/tomo-Set.without.3 delete mode 100644 man/man3/tomo-Table.xor.3 diff --git a/api/sets.md b/api/sets.md deleted file mode 100644 index 8b07cf08..00000000 --- a/api/sets.md +++ /dev/null @@ -1,267 +0,0 @@ -% API - -# Builtins - -# Set -## Set.add - -```tomo -Set.add : func(set: |T|, item: T -> Void) -``` - -Adds an item to the set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The mutable reference to the set. | - -item | `T` | The item to add to the set. | - - -**Return:** Nothing. - - -**Example:** -```tomo ->> nums.add(42) - -``` -## Set.add_all - -```tomo -Set.add_all : func(set: @|T|, items: [T] -> Void) -``` - -Adds multiple items to the set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `@|T|` | The mutable reference to the set. | - -items | `[T]` | The list of items to add to the set. | - - -**Return:** Nothing. - - -**Example:** -```tomo ->> nums.add_all([1, 2, 3]) - -``` -## Set.clear - -```tomo -Set.clear : func(set: @|T| -> Void) -``` - -Removes all items from the set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `@|T|` | The mutable reference to the set. | - - -**Return:** Nothing. - - -**Example:** -```tomo ->> nums.clear() - -``` -## Set.has - -```tomo -Set.has : func(set: |T|, item: T -> Bool) -``` - -Checks if the set contains a specified item. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The set to check. | - -item | `T` | The item to check for presence. | - - -**Return:** `yes` if the item is present, `no` otherwise. - - -**Example:** -```tomo ->> |10, 20|.has(20) -= yes - -``` -## Set.is_subset_of - -```tomo -Set.is_subset_of : func(set: |T|, other: |T|, strict: Bool = no -> Bool) -``` - -Checks if the set is a subset of another set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The set to check. | - -other | `|T|` | The set to compare against. | - -strict | `Bool` | If `yes`, checks if the set is a strict subset (does not equal the other set). | `no` - -**Return:** `yes` if the set is a subset of the other set (strictly or not), `no` otherwise. - - -**Example:** -```tomo ->> |1, 2|.is_subset_of(|1, 2, 3|) -= yes - -``` -## Set.is_superset_of - -```tomo -Set.is_superset_of : func(set: |T|, other: |T|, strict: Bool = no -> Bool) -``` - -Checks if the set is a superset of another set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The set to check. | - -other | `|T|` | The set to compare against. | - -strict | `Bool` | If `yes`, checks if the set is a strict superset (does not equal the other set). | `no` - -**Return:** `yes` if the set is a superset of the other set (strictly or not), `no` otherwise. - - -**Example:** -```tomo ->> |1, 2, 3|.is_superset_of(|1, 2|) -= yes - -``` -## Set.overlap - -```tomo -Set.overlap : func(set: |T|, other: |T| -> |T|) -``` - -Creates a new set with items that are in both the original set and another set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The original set. | - -other | `|T|` | The set to intersect with. | - - -**Return:** A new set containing only items present in both sets. - - -**Example:** -```tomo ->> |1, 2|.overlap(|2, 3|) -= |2| - -``` -## Set.remove - -```tomo -Set.remove : func(set: @|T|, item: T -> Void) -``` - -Removes an item from the set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `@|T|` | The mutable reference to the set. | - -item | `T` | The item to remove from the set. | - - -**Return:** Nothing. - - -**Example:** -```tomo ->> nums.remove(42) - -``` -## Set.remove_all - -```tomo -Set.remove_all : func(set: @|T|, items: [T] -> Void) -``` - -Removes multiple items from the set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `@|T|` | The mutable reference to the set. | - -items | `[T]` | The list of items to remove from the set. | - - -**Return:** Nothing. - - -**Example:** -```tomo ->> nums.remove_all([1, 2, 3]) - -``` -## Set.with - -```tomo -Set.with : func(set: |T|, other: |T| -> |T|) -``` - -Creates a new set that is the union of the original set and another set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The original set. | - -other | `|T|` | The set to union with. | - - -**Return:** A new set containing all items from both sets. - - -**Example:** -```tomo ->> |1, 2|.with(|2, 3|) -= |1, 2, 3| - -``` -## Set.without - -```tomo -Set.without : func(set: |T|, other: |T| -> |T|) -``` - -Creates a new set with items from the original set but without items from another set. - -Argument | Type | Description | Default ----------|------|-------------|--------- -set | `|T|` | The original set. | - -other | `|T|` | The set of items to remove from the original set. | - - -**Return:** A new set containing items from the original set excluding those in the other set. - - -**Example:** -```tomo ->> |1, 2|.without(|2, 3|) -= |1| - -``` - -# Table -## Table.xor - -```tomo -Table.xor : func(a: |T|, b: |T| -> |T|) -``` - -Return set with the elements in one, but not both of the arguments. This is also known as the symmetric difference or disjunctive union. - -Argument | Type | Description | Default ----------|------|-------------|--------- -a | `|T|` | The first set. | - -b | `|T|` | The second set. | - - -**Return:** A set with the symmetric difference of the arguments. - - -**Example:** -```tomo ->> |1, 2, 3|.xor(|2, 3, 4|) -= |1, 4| - -``` diff --git a/api/sets.yaml b/api/sets.yaml deleted file mode 100644 index 7621db9d..00000000 --- a/api/sets.yaml +++ /dev/null @@ -1,253 +0,0 @@ -Set.add: - short: add item to a set - description: > - Adds an item to the set. - return: - type: 'Void' - description: > - Nothing. - args: - set: - type: '|T|' - description: > - The mutable reference to the set. - item: - type: 'T' - description: > - The item to add to the set. - example: | - >> nums.add(42) - -Set.add_all: - short: add items to a set - description: > - Adds multiple items to the set. - return: - type: 'Void' - description: > - Nothing. - args: - set: - type: '@|T|' - description: > - The mutable reference to the set. - items: - type: '[T]' - description: > - The list of items to add to the set. - example: | - >> nums.add_all([1, 2, 3]) - -Set.clear: - short: clear a set - description: > - Removes all items from the set. - return: - type: 'Void' - description: > - Nothing. - args: - set: - type: '@|T|' - description: > - The mutable reference to the set. - example: | - >> nums.clear() - -Set.has: - short: check if a set has an item - description: > - Checks if the set contains a specified item. - return: - type: 'Bool' - description: > - `yes` if the item is present, `no` otherwise. - args: - set: - type: '|T|' - description: > - The set to check. - item: - type: 'T' - description: > - The item to check for presence. - example: | - >> |10, 20|.has(20) - = yes - -Set.is_subset_of: - short: check if a set is a subset - description: > - Checks if the set is a subset of another set. - return: - type: 'Bool' - description: > - `yes` if the set is a subset of the other set (strictly or not), `no` otherwise. - args: - set: - type: '|T|' - description: > - The set to check. - other: - type: '|T|' - description: > - The set to compare against. - strict: - type: 'Bool' - default: 'no' - description: > - If `yes`, checks if the set is a strict subset (does not equal the other set). - example: | - >> |1, 2|.is_subset_of(|1, 2, 3|) - = yes - -Set.is_superset_of: - short: check if a set is a superset - description: > - Checks if the set is a superset of another set. - return: - type: 'Bool' - description: > - `yes` if the set is a superset of the other set (strictly or not), `no` otherwise. - args: - set: - type: '|T|' - description: > - The set to check. - other: - type: '|T|' - description: > - The set to compare against. - strict: - type: 'Bool' - default: 'no' - description: > - If `yes`, checks if the set is a strict superset (does not equal the other set). - example: | - >> |1, 2, 3|.is_superset_of(|1, 2|) - = yes - -Set.overlap: - short: set intersection - description: > - Creates a new set with items that are in both the original set and another set. - return: - type: '|T|' - description: > - A new set containing only items present in both sets. - args: - set: - type: '|T|' - description: > - The original set. - other: - type: '|T|' - description: > - The set to intersect with. - example: | - >> |1, 2|.overlap(|2, 3|) - = |2| - -Set.remove: - short: remove an item from a set - description: > - Removes an item from the set. - return: - type: 'Void' - description: > - Nothing. - args: - set: - type: '@|T|' - description: > - The mutable reference to the set. - item: - type: 'T' - description: > - The item to remove from the set. - example: | - >> nums.remove(42) - -Set.remove_all: - short: remove items from a set - description: > - Removes multiple items from the set. - return: - type: 'Void' - description: > - Nothing. - args: - set: - type: '@|T|' - description: > - The mutable reference to the set. - items: - type: '[T]' - description: > - The list of items to remove from the set. - example: | - >> nums.remove_all([1, 2, 3]) - -Set.with: - short: set union - description: > - Creates a new set that is the union of the original set and another set. - return: - type: '|T|' - description: > - A new set containing all items from both sets. - args: - set: - type: '|T|' - description: > - The original set. - other: - type: '|T|' - description: > - The set to union with. - example: | - >> |1, 2|.with(|2, 3|) - = |1, 2, 3| - -Set.without: - short: set difference - description: > - Creates a new set with items from the original set but without items from another set. - return: - type: '|T|' - description: > - A new set containing items from the original set excluding those in the other set. - args: - set: - type: '|T|' - description: > - The original set. - other: - type: '|T|' - description: > - The set of items to remove from the original set. - example: | - >> |1, 2|.without(|2, 3|) - = |1| - -Table.xor: - short: symmetric difference - description: > - Return set with the elements in one, but not both of the arguments. This is - also known as the symmetric difference or disjunctive union. - return: - type: '|T|' - description: > - A set with the symmetric difference of the arguments. - args: - a: - type: '|T|' - description: > - The first set. - b: - type: '|T|' - description: > - The second set. - example: | - >> |1, 2, 3|.xor(|2, 3, 4|) - = |1, 4| diff --git a/docs/sets.md b/docs/sets.md deleted file mode 100644 index c8d67fc4..00000000 --- a/docs/sets.md +++ /dev/null @@ -1,78 +0,0 @@ -# Sets - -Sets represent an unordered collection of unique elements. These are -implemented using hash tables. - -```tomo -a := |10, 20, 30| -b := |20, 30| ->> a.overlap(b) -= |20| -``` - -## Syntax - -Sets are written using `|...|` vertical pipes with comma-separated items: - -```tomo -nums := |10, 20, 30| -``` - -Empty sets must specify the set type explicitly: - -```tomo -empty : |Int| = || -``` - -For type annotations, a set that holds items with type `T` is written as `|T|`. - -### Comprehensions - -Similar to lists, sets can use comprehensions: - -```tomo -set := |10*i for i in 10| -set2 := |10*i for i in 10 if i mod 2 == 0| -set3 := |-10, 10*i for i in 10| -``` - -## Accessing Items - -Sets internally store their items in a list, which you can access with the -`.items` field. This is a constant-time operation that produces an immutable -view: - -```tomo -set := |10, 20, 30| ->> set.items -= [10, 20, 30] -``` - -## Length - -Set length can be accessed by the `.length` field: - -```tomo ->> |10, 20, 30|.length -= 3 -``` - -## Iteration - -You can iterate over the items in a table like this: - -```tomo -for item in set - ... - -for i, item in set - ... -``` - -Set iteration operates over the value of the set when the loop began, so -modifying the set during iteration is safe and will not result in the loop -iterating over any of the new values. - -# API - -[API documentation](../api/sets.md) diff --git a/man/man3/tomo-Set.add.3 b/man/man3/tomo-Set.add.3 deleted file mode 100644 index 2c123079..00000000 --- a/man/man3/tomo-Set.add.3 +++ /dev/null @@ -1,34 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.add 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.add \- add item to a set -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.add\ :\ func(set:\ |T|,\ item:\ T\ ->\ Void) -.fi -.SH DESCRIPTION -Adds an item to the set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The mutable reference to the set. - -item T The item to add to the set. - -.TE -.SH RETURN -Nothing. - -.SH EXAMPLES -.EX ->> nums.add(42) -.EE diff --git a/man/man3/tomo-Set.add_all.3 b/man/man3/tomo-Set.add_all.3 deleted file mode 100644 index c8496166..00000000 --- a/man/man3/tomo-Set.add_all.3 +++ /dev/null @@ -1,34 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.add_all 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.add_all \- add items to a set -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.add_all\ :\ func(set:\ @|T|,\ items:\ [T]\ ->\ Void) -.fi -.SH DESCRIPTION -Adds multiple items to the set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set @|T| The mutable reference to the set. - -items [T] The list of items to add to the set. - -.TE -.SH RETURN -Nothing. - -.SH EXAMPLES -.EX ->> nums.add_all([1, 2, 3]) -.EE diff --git a/man/man3/tomo-Set.clear.3 b/man/man3/tomo-Set.clear.3 deleted file mode 100644 index 514622de..00000000 --- a/man/man3/tomo-Set.clear.3 +++ /dev/null @@ -1,33 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.clear 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.clear \- clear a set -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.clear\ :\ func(set:\ @|T|\ ->\ Void) -.fi -.SH DESCRIPTION -Removes all items from the set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set @|T| The mutable reference to the set. - -.TE -.SH RETURN -Nothing. - -.SH EXAMPLES -.EX ->> nums.clear() -.EE diff --git a/man/man3/tomo-Set.has.3 b/man/man3/tomo-Set.has.3 deleted file mode 100644 index 02f8a7ae..00000000 --- a/man/man3/tomo-Set.has.3 +++ /dev/null @@ -1,35 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.has 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.has \- check if a set has an item -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.has\ :\ func(set:\ |T|,\ item:\ T\ ->\ Bool) -.fi -.SH DESCRIPTION -Checks if the set contains a specified item. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The set to check. - -item T The item to check for presence. - -.TE -.SH RETURN -`yes` if the item is present, `no` otherwise. - -.SH EXAMPLES -.EX ->> |10, 20|.has(20) -= yes -.EE diff --git a/man/man3/tomo-Set.is_subset_of.3 b/man/man3/tomo-Set.is_subset_of.3 deleted file mode 100644 index 378ef09c..00000000 --- a/man/man3/tomo-Set.is_subset_of.3 +++ /dev/null @@ -1,36 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.is_subset_of 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.is_subset_of \- check if a set is a subset -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.is_subset_of\ :\ func(set:\ |T|,\ other:\ |T|,\ strict:\ Bool\ =\ no\ ->\ Bool) -.fi -.SH DESCRIPTION -Checks if the set is a subset of another set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The set to check. - -other |T| The set to compare against. - -strict Bool If `yes`, checks if the set is a strict subset (does not equal the other set). no -.TE -.SH RETURN -`yes` if the set is a subset of the other set (strictly or not), `no` otherwise. - -.SH EXAMPLES -.EX ->> |1, 2|.is_subset_of(|1, 2, 3|) -= yes -.EE diff --git a/man/man3/tomo-Set.is_superset_of.3 b/man/man3/tomo-Set.is_superset_of.3 deleted file mode 100644 index 1afec7a6..00000000 --- a/man/man3/tomo-Set.is_superset_of.3 +++ /dev/null @@ -1,36 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.is_superset_of 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.is_superset_of \- check if a set is a superset -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.is_superset_of\ :\ func(set:\ |T|,\ other:\ |T|,\ strict:\ Bool\ =\ no\ ->\ Bool) -.fi -.SH DESCRIPTION -Checks if the set is a superset of another set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The set to check. - -other |T| The set to compare against. - -strict Bool If `yes`, checks if the set is a strict superset (does not equal the other set). no -.TE -.SH RETURN -`yes` if the set is a superset of the other set (strictly or not), `no` otherwise. - -.SH EXAMPLES -.EX ->> |1, 2, 3|.is_superset_of(|1, 2|) -= yes -.EE diff --git a/man/man3/tomo-Set.overlap.3 b/man/man3/tomo-Set.overlap.3 deleted file mode 100644 index 56c7e454..00000000 --- a/man/man3/tomo-Set.overlap.3 +++ /dev/null @@ -1,35 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.overlap 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.overlap \- set intersection -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.overlap\ :\ func(set:\ |T|,\ other:\ |T|\ ->\ |T|) -.fi -.SH DESCRIPTION -Creates a new set with items that are in both the original set and another set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The original set. - -other |T| The set to intersect with. - -.TE -.SH RETURN -A new set containing only items present in both sets. - -.SH EXAMPLES -.EX ->> |1, 2|.overlap(|2, 3|) -= |2| -.EE diff --git a/man/man3/tomo-Set.remove.3 b/man/man3/tomo-Set.remove.3 deleted file mode 100644 index d7459d21..00000000 --- a/man/man3/tomo-Set.remove.3 +++ /dev/null @@ -1,34 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.remove 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.remove \- remove an item from a set -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.remove\ :\ func(set:\ @|T|,\ item:\ T\ ->\ Void) -.fi -.SH DESCRIPTION -Removes an item from the set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set @|T| The mutable reference to the set. - -item T The item to remove from the set. - -.TE -.SH RETURN -Nothing. - -.SH EXAMPLES -.EX ->> nums.remove(42) -.EE diff --git a/man/man3/tomo-Set.remove_all.3 b/man/man3/tomo-Set.remove_all.3 deleted file mode 100644 index d1ac51cd..00000000 --- a/man/man3/tomo-Set.remove_all.3 +++ /dev/null @@ -1,34 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.remove_all 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.remove_all \- remove items from a set -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.remove_all\ :\ func(set:\ @|T|,\ items:\ [T]\ ->\ Void) -.fi -.SH DESCRIPTION -Removes multiple items from the set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set @|T| The mutable reference to the set. - -items [T] The list of items to remove from the set. - -.TE -.SH RETURN -Nothing. - -.SH EXAMPLES -.EX ->> nums.remove_all([1, 2, 3]) -.EE diff --git a/man/man3/tomo-Set.with.3 b/man/man3/tomo-Set.with.3 deleted file mode 100644 index 6c126c40..00000000 --- a/man/man3/tomo-Set.with.3 +++ /dev/null @@ -1,35 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.with 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.with \- set union -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.with\ :\ func(set:\ |T|,\ other:\ |T|\ ->\ |T|) -.fi -.SH DESCRIPTION -Creates a new set that is the union of the original set and another set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The original set. - -other |T| The set to union with. - -.TE -.SH RETURN -A new set containing all items from both sets. - -.SH EXAMPLES -.EX ->> |1, 2|.with(|2, 3|) -= |1, 2, 3| -.EE diff --git a/man/man3/tomo-Set.without.3 b/man/man3/tomo-Set.without.3 deleted file mode 100644 index e997b852..00000000 --- a/man/man3/tomo-Set.without.3 +++ /dev/null @@ -1,35 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Set.without 3 2025-04-30 "Tomo man-pages" -.SH NAME -Set.without \- set difference -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Set.without\ :\ func(set:\ |T|,\ other:\ |T|\ ->\ |T|) -.fi -.SH DESCRIPTION -Creates a new set with items from the original set but without items from another set. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -set |T| The original set. - -other |T| The set of items to remove from the original set. - -.TE -.SH RETURN -A new set containing items from the original set excluding those in the other set. - -.SH EXAMPLES -.EX ->> |1, 2|.without(|2, 3|) -= |1| -.EE diff --git a/man/man3/tomo-Table.xor.3 b/man/man3/tomo-Table.xor.3 deleted file mode 100644 index 8d3cb8f2..00000000 --- a/man/man3/tomo-Table.xor.3 +++ /dev/null @@ -1,35 +0,0 @@ -'\" t -.\" Copyright (c) 2025 Bruce Hill -.\" All rights reserved. -.\" -.TH Table.xor 3 2025-06-24 "Tomo man-pages" -.SH NAME -Table.xor \- symmetric difference -.SH LIBRARY -Tomo Standard Library -.SH SYNOPSIS -.nf -.BI Table.xor\ :\ func(a:\ |T|,\ b:\ |T|\ ->\ |T|) -.fi -.SH DESCRIPTION -Return set with the elements in one, but not both of the arguments. This is also known as the symmetric difference or disjunctive union. - - -.SH ARGUMENTS - -.TS -allbox; -lb lb lbx lb -l l l l. -Name Type Description Default -a |T| The first set. - -b |T| The second set. - -.TE -.SH RETURN -A set with the symmetric difference of the arguments. - -.SH EXAMPLES -.EX ->> |1, 2, 3|.xor(|2, 3, 4|) -= |1, 4| -.EE -- cgit v1.2.3