classes: update docs with $sequence.
parent
cb091281bb
commit
738113d524
|
@ -41,11 +41,11 @@ $nl
|
||||||
{ $subsections rank-class } ;
|
{ $subsections rank-class } ;
|
||||||
|
|
||||||
HELP: flatten-class
|
HELP: flatten-class
|
||||||
{ $values { "class" class } { "assoc" "an assoc whose keys are classes" } }
|
{ $values { "class" class } { "seq" { $sequence class } } }
|
||||||
{ $description "Outputs a set of builtin and tuple classes whose union is the smallest cover of " { $snippet "class" } "." } ;
|
{ $description "Outputs a set of builtin and tuple classes whose union is the smallest cover of " { $snippet "class" } "." } ;
|
||||||
|
|
||||||
HELP: class<=
|
HELP: class<=
|
||||||
{ $values { "first" "a class" } { "second" "a class" } { "?" boolean } }
|
{ $values { "first" class } { "second" class } { "?" boolean } }
|
||||||
{ $description "Tests if all instances of " { $snippet "class1" } " are also instances of " { $snippet "class2" } "." }
|
{ $description "Tests if all instances of " { $snippet "class1" } " are also instances of " { $snippet "class2" } "." }
|
||||||
{ $notes "Classes are partially ordered. This means that if " { $snippet "class1 <= class2" } " and " { $snippet "class2 <= class1" } ", then " { $snippet "class1 <= class2" } ". Also, if " { $snippet "class1 <= class2" } " and " { $snippet "class2 <= class3" } ", then " { $snippet "class1 <= class3" } "." } ;
|
{ $notes "Classes are partially ordered. This means that if " { $snippet "class1 <= class2" } " and " { $snippet "class2 <= class1" } ", then " { $snippet "class1 <= class2" } ". Also, if " { $snippet "class1 <= class2" } " and " { $snippet "class2 <= class3" } ", then " { $snippet "class1 <= class3" } "." } ;
|
||||||
|
|
||||||
|
@ -74,5 +74,5 @@ HELP: smallest-class
|
||||||
{ $description "Outputs a minimum class from the given sequence." } ;
|
{ $description "Outputs a minimum class from the given sequence." } ;
|
||||||
|
|
||||||
HELP: sort-classes
|
HELP: sort-classes
|
||||||
{ $values { "seq" "a sequence of class" } { "newseq" "a new sequence of classes" } }
|
{ $values { "seq" { $sequence class } } { "newseq" { $sequence class } } }
|
||||||
{ $description "Outputs a linear sort of a sequence of classes. Larger classes come before their subclasses." } ;
|
{ $description "Outputs a linear sort of a sequence of classes. Larger classes come before their subclasses." } ;
|
||||||
|
|
|
@ -87,7 +87,7 @@ HELP: class-usage
|
||||||
{ $description "Lists all classes that uses or depends on this class." } ;
|
{ $description "Lists all classes that uses or depends on this class." } ;
|
||||||
|
|
||||||
HELP: classes
|
HELP: classes
|
||||||
{ $values { "seq" "a sequence of class words" } }
|
{ $values { "seq" { $sequence class } } }
|
||||||
{ $description "Finds all class words in the dictionary." } ;
|
{ $description "Finds all class words in the dictionary." } ;
|
||||||
|
|
||||||
HELP: contained-classes
|
HELP: contained-classes
|
||||||
|
@ -166,12 +166,12 @@ HELP: class-participants
|
||||||
{ $description "If " { $snippet "class" } " is an intersection class, outputs a sequence of its participant classes, otherwise outputs " { $link f } "." } ;
|
{ $description "If " { $snippet "class" } " is an intersection class, outputs a sequence of its participant classes, otherwise outputs " { $link f } "." } ;
|
||||||
|
|
||||||
HELP: define-class
|
HELP: define-class
|
||||||
{ $values { "word" word } { "superclass" class } { "members" "a sequence of class words" } { "participants" "a sequence of class words" } { "metaclass" class } }
|
{ $values { "word" word } { "superclass" class } { "members" { $sequence class } } { "participants" { $sequence class } } { "metaclass" class } }
|
||||||
{ $description "Sets a property indicating this word is a class word, thus making it an instance of " { $link class } ", and registers it with " { $link update-map } "." }
|
{ $description "Sets a property indicating this word is a class word, thus making it an instance of " { $link class } ", and registers it with " { $link update-map } "." }
|
||||||
$low-level-note ;
|
$low-level-note ;
|
||||||
|
|
||||||
HELP: implementors
|
HELP: implementors
|
||||||
{ $values { "class/classes" "a class or a sequence of classes" } { "seq" "a sequence of generic words" } }
|
{ $values { "class/classes" { $or class { $sequence class } } } { "seq" "a sequence of generic words" } }
|
||||||
{ $description "Finds all generic words in the dictionary implementing methods for the given set of classes." } ;
|
{ $description "Finds all generic words in the dictionary implementing methods for the given set of classes." } ;
|
||||||
|
|
||||||
HELP: instance?
|
HELP: instance?
|
||||||
|
|
|
@ -19,7 +19,7 @@ ARTICLE: "intersections" "Intersection classes"
|
||||||
ABOUT: "intersections"
|
ABOUT: "intersections"
|
||||||
|
|
||||||
HELP: define-intersection-class
|
HELP: define-intersection-class
|
||||||
{ $values { "class" class } { "participants" "a sequence of classes" } }
|
{ $values { "class" class } { "participants" { $sequence class } } }
|
||||||
{ $description "Defines a intersection class with specified participants. This is the run time equivalent of " { $link POSTPONE: INTERSECTION: } "." }
|
{ $description "Defines a intersection class with specified participants. This is the run time equivalent of " { $link POSTPONE: INTERSECTION: } "." }
|
||||||
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
||||||
{ $side-effects "class" } ;
|
{ $side-effects "class" } ;
|
||||||
|
|
|
@ -373,7 +373,7 @@ HELP: define-tuple-predicate
|
||||||
$low-level-note ;
|
$low-level-note ;
|
||||||
|
|
||||||
HELP: redefine-tuple-class
|
HELP: redefine-tuple-class
|
||||||
{ $values { "class" class } { "superclass" class } { "slots" "a sequence of strings" } }
|
{ $values { "class" class } { "superclass" class } { "slots" { $sequence string } } }
|
||||||
{ $description "If the new slot layout differs from the existing one, updates all existing instances of this tuple class, and forgets any slot accessor words which are no longer needed."
|
{ $description "If the new slot layout differs from the existing one, updates all existing instances of this tuple class, and forgets any slot accessor words which are no longer needed."
|
||||||
$nl
|
$nl
|
||||||
"If the class is not a tuple class word, this word does nothing." }
|
"If the class is not a tuple class word, this word does nothing." }
|
||||||
|
@ -396,7 +396,7 @@ HELP: check-tuple
|
||||||
{ $error-description "Thrown if " { $link POSTPONE: C: } " is called with a word which does not name a tuple class." } ;
|
{ $error-description "Thrown if " { $link POSTPONE: C: } " is called with a word which does not name a tuple class." } ;
|
||||||
|
|
||||||
HELP: define-tuple-class
|
HELP: define-tuple-class
|
||||||
{ $values { "class" word } { "superclass" class } { "slots" "a sequence of strings" } }
|
{ $values { "class" word } { "superclass" class } { "slots" { $sequence string } } }
|
||||||
{ $description "Defines a tuple class inheriting from " { $snippet "superclass" } " with slots named by " { $snippet "slots" } ". This is the run time equivalent of " { $link POSTPONE: TUPLE: } "." }
|
{ $description "Defines a tuple class inheriting from " { $snippet "superclass" } " with slots named by " { $snippet "slots" } ". This is the run time equivalent of " { $link POSTPONE: TUPLE: } "." }
|
||||||
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
||||||
{ $side-effects "class" } ;
|
{ $side-effects "class" } ;
|
||||||
|
|
|
@ -21,12 +21,12 @@ ARTICLE: "unions" "Union classes"
|
||||||
ABOUT: "unions"
|
ABOUT: "unions"
|
||||||
|
|
||||||
HELP: (define-union-class)
|
HELP: (define-union-class)
|
||||||
{ $values { "class" class } { "members" "a sequence of classes" } }
|
{ $values { "class" class } { "members" { $sequence class } } }
|
||||||
{ $description "Defines a union class." }
|
{ $description "Defines a union class." }
|
||||||
{ $errors "Throws " { $link cannot-reference-self } " if the definition references itself." } ;
|
{ $errors "Throws " { $link cannot-reference-self } " if the definition references itself." } ;
|
||||||
|
|
||||||
HELP: define-union-class
|
HELP: define-union-class
|
||||||
{ $values { "class" class } { "members" "a sequence of classes" } }
|
{ $values { "class" class } { "members" { $sequence class } } }
|
||||||
{ $description "Defines a union class with specified members. This is the run time equivalent of " { $link POSTPONE: UNION: } "." }
|
{ $description "Defines a union class with specified members. This is the run time equivalent of " { $link POSTPONE: UNION: } "." }
|
||||||
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
{ $notes "This word must be called from inside " { $link with-compilation-unit } "." }
|
||||||
{ $side-effects "class"
|
{ $side-effects "class"
|
||||||
|
|
Loading…
Reference in New Issue