From 3435766132d3d434622eecae5fb80f5db33bcab4 Mon Sep 17 00:00:00 2001 From: Eduardo Julian Date: Sun, 5 Sep 2021 03:05:26 -0400 Subject: Handled formatting issues in documentation. --- .../documentation/lux/control/concatenative.lux | 6 +-- .../documentation/lux/control/parser/json.lux | 6 +-- .../documentation/lux/control/parser/synthesis.lux | 3 +- .../documentation/lux/control/parser/text.lux | 21 +++------ .../documentation/lux/control/parser/type.lux | 6 +-- .../source/documentation/lux/control/remember.lux | 40 ++++++++++------- .../documentation/lux/data/collection/bits.lux | 36 +++------------- .../lux/data/collection/dictionary/ordered.lux | 3 +- .../documentation/lux/data/collection/list.lux | 47 ++++---------------- .../documentation/lux/data/collection/sequence.lux | 35 +++------------ .../lux/data/collection/set/multi.lux | 22 +++------- stdlib/source/documentation/lux/data/color.lux | 22 +++------- .../source/documentation/lux/data/format/json.lux | 3 +- stdlib/source/documentation/lux/ffi.jvm.lux | 4 +- stdlib/source/documentation/lux/ffi.old.lux | 5 +-- stdlib/source/documentation/lux/macro.lux | 50 ++++++++++++++++------ stdlib/source/documentation/lux/macro/template.lux | 24 ++++------- .../source/documentation/lux/math/number/frac.lux | 6 +-- .../source/documentation/lux/math/number/i64.lux | 26 +++-------- .../source/documentation/lux/math/number/int.lux | 6 +-- .../source/documentation/lux/math/number/nat.lux | 6 +-- .../source/documentation/lux/math/number/rev.lux | 19 ++++---- .../source/documentation/lux/meta/annotation.lux | 43 ++++++------------- stdlib/source/documentation/lux/static.lux | 12 +++--- stdlib/source/documentation/lux/test.lux | 24 ++++++----- stdlib/source/documentation/lux/type.lux | 12 ++---- stdlib/source/documentation/lux/type/abstract.lux | 8 +++- stdlib/source/documentation/lux/type/resource.lux | 3 +- stdlib/source/documentation/lux/type/unit.lux | 21 +++------ 29 files changed, 188 insertions(+), 331 deletions(-) (limited to 'stdlib/source/documentation') diff --git a/stdlib/source/documentation/lux/control/concatenative.lux b/stdlib/source/documentation/lux/control/concatenative.lux index b72716a3a..104f59381 100644 --- a/stdlib/source/documentation/lux/control/concatenative.lux +++ b/stdlib/source/documentation/lux/control/concatenative.lux @@ -56,11 +56,9 @@ (template [] [(with_expansions [ (template.identifier [/._] ["apply/" ]) (template.text ["Lift a function of arity " - " into a concatenative function of arity " "."]) - (template.identifier ["function_of_arity_" ])] + " into a concatenative function of arity " "."])] (documentation: - - [( )]))] + ))] [1] [2] [3] [4] [5] [6] [7] [8] diff --git a/stdlib/source/documentation/lux/control/parser/json.lux b/stdlib/source/documentation/lux/control/parser/json.lux index 9c30df716..e072529b0 100644 --- a/stdlib/source/documentation/lux/control/parser/json.lux +++ b/stdlib/source/documentation/lux/control/parser/json.lux @@ -33,11 +33,9 @@ (template [ ] [(`` (documentation: - (format "Asks whether a JSON value is a " (~~ (template.text [])) ".") - [( test)])) + (format "Asks whether a JSON value is a " (~~ (template.text [])) "."))) (`` (documentation: - (format "Ensures a JSON value is a " (~~ (template.text [])) ".") - [( test)]))] + (format "Ensures a JSON value is a " (~~ (template.text [])) ".")))] [/.boolean? /.boolean! ..boolean] [/.number? /.number! ..number] diff --git a/stdlib/source/documentation/lux/control/parser/synthesis.lux b/stdlib/source/documentation/lux/control/parser/synthesis.lux index a0c48b955..eebd25e91 100644 --- a/stdlib/source/documentation/lux/control/parser/synthesis.lux +++ b/stdlib/source/documentation/lux/control/parser/synthesis.lux @@ -31,8 +31,7 @@ [(`` (documentation: (format "Queries for a " (~~ (template.text [])) " synthesis node."))) (`` (documentation: - (format "Checks for a specific " (~~ (template.text [])) " synthesis node.") - [( expected)]))] + (format "Checks for a specific " (~~ (template.text [])) " synthesis node.")))] [/.bit /.bit!] [/.i64 /.i64!] diff --git a/stdlib/source/documentation/lux/control/parser/text.lux b/stdlib/source/documentation/lux/control/parser/text.lux index 44640e656..e3c3a96c6 100644 --- a/stdlib/source/documentation/lux/control/parser/text.lux +++ b/stdlib/source/documentation/lux/control/parser/text.lux @@ -35,8 +35,7 @@ (template [ ] [(`` (documentation: - (format "Produce a character" (~~ (template.text [])) " if the parser fails.") - [( parser)]))] + (format "Produce a character" (~~ (template.text [])) " if the parser fails.")))] [/.not ""] [/.not! " (as a slice)"] @@ -80,8 +79,7 @@ (template [ ] [(documentation: - (format "Yields characters that are" " part of a piece of text.") - [( options)])] + (format "Yields characters that are" " part of a piece of text."))] [/.one_of ""] [/.none_of " not"] @@ -89,8 +87,7 @@ (template [ ] [(documentation: - (format "Yields characters (as a slice) that are" " part of a piece of text.") - [( options)])] + (format "Yields characters (as a slice) that are" " part of a piece of text."))] [/.one_of! ""] [/.none_of! " not"] @@ -113,11 +110,9 @@ (template [ ] [(`` (documentation: - (format "Yields " (~~ (template.text [])) " characters as a single continuous text.") - [( parser)])) + (format "Yields " (~~ (template.text [])) " characters as a single continuous text."))) (`` (documentation: - (format "Yields " (~~ (template.text [])) " characters as a single continuous text (as a slice).") - [( parser)]))] + (format "Yields " (~~ (template.text [])) " characters as a single continuous text (as a slice).")))] [/.some /.some!] [/.many /.many!] @@ -125,11 +120,9 @@ (template [ ] [(`` (documentation: - (format "Yields " " N characters.") - [( amount parser)])) + (format "Yields " " N characters."))) (`` (documentation: - (format "Yields " " N characters (as a slice).") - [( amount parser)]))] + (format "Yields " " N characters (as a slice).")))] [/.exactly /.exactly! "exactly"] [/.at_most /.at_most! "at most"] diff --git a/stdlib/source/documentation/lux/control/parser/type.lux b/stdlib/source/documentation/lux/control/parser/type.lux index 5567ac18e..a755665c3 100644 --- a/stdlib/source/documentation/lux/control/parser/type.lux +++ b/stdlib/source/documentation/lux/control/parser/type.lux @@ -43,8 +43,7 @@ (template [] [(`` (documentation: - (format "Parses the contents of a " (~~ (template.text [])) " type.") - [( poly)]))] + (format "Parses the contents of a " (~~ (template.text [])) " type.")))] [/.variant] [/.tuple] @@ -64,8 +63,7 @@ (template [ ] [(documentation: - - [( expected)])] + )] [/.exactly "Parses a type exactly."] [/.sub "Parses a sub type."] diff --git a/stdlib/source/documentation/lux/control/remember.lux b/stdlib/source/documentation/lux/control/remember.lux index 955505c5c..5e42f67de 100644 --- a/stdlib/source/documentation/lux/control/remember.lux +++ b/stdlib/source/documentation/lux/control/remember.lux @@ -10,22 +10,32 @@ [\\library ["." /]]) -(template [ ] - [(`` (documentation: - (format "A" " message with an expiration date." - \n "Can have an optional piece of code to focus on.") - [((~~ (template.identifier [])) - "2022-04-01" - "Do this, that and the other.")] - [((~~ (template.identifier [])) - "2022-04-01" - "Improve the performace." - (some (complicated (computation 123))))]))] +(documentation: /.remember + (format "A message with an expiration date." + \n "Can have an optional piece of code to focus on.") + [(remember "2022-04-01" + "Do this, that and the other.")] + [(remember "2022-04-01" + "Improve the performace." + (some (complicated (computation 123))))]) - [/.remember ""] - [/.to_do " TODO"] - [/.fix_me " FIXME"] - ) +(documentation: /.to_do + (format "A TODO message with an expiration date." + \n "Can have an optional piece of code to focus on.") + [(to_do "2022-04-01" + "Do this, that and the other.")] + [(to_do "2022-04-01" + "Improve the performace." + (some (complicated (computation 123))))]) + +(documentation: /.fix_me + (format "A FIXME message with an expiration date." + \n "Can have an optional piece of code to focus on.") + [(fix_me "2022-04-01" + "Do this, that and the other.")] + [(fix_me "2022-04-01" + "Improve the performace." + (some (complicated (computation 123))))]) (.def: .public documentation (.List $.Module) diff --git a/stdlib/source/documentation/lux/data/collection/bits.lux b/stdlib/source/documentation/lux/data/collection/bits.lux index c58e7358a..79d85d7fe 100644 --- a/stdlib/source/documentation/lux/data/collection/bits.lux +++ b/stdlib/source/documentation/lux/data/collection/bits.lux @@ -30,16 +30,6 @@ "" [(bit index bits)]) -(template [] - [(documentation: - "" - [( index input)])] - - [/.one] - [/.zero] - [/.flipped] - ) - (documentation: /.intersects? "" [(intersects? reference sample)]) @@ -48,16 +38,6 @@ "" [(not input)]) -(template [] - [(documentation: - "" - [( param subject)])] - - [/.and] - [/.or] - [/.xor] - ) - (.def: .public documentation (.List $.Module) ($.module /._ @@ -66,21 +46,19 @@ ..size ..capacity ..bit - - ..one - ..zero - ..flipped ..intersects? ..not - - ..and - ..or - ..xor ($.default /.Chunk) ($.default /.chunk_size) ($.default /.empty) ($.default /.empty?) - ($.default /.equivalence)] + ($.default /.equivalence) + ($.default /.one) + ($.default /.zero) + ($.default /.flipped) + ($.default /.and) + ($.default /.or) + ($.default /.xor)] [])) diff --git a/stdlib/source/documentation/lux/data/collection/dictionary/ordered.lux b/stdlib/source/documentation/lux/data/collection/dictionary/ordered.lux index 072d14754..866e5a850 100644 --- a/stdlib/source/documentation/lux/data/collection/dictionary/ordered.lux +++ b/stdlib/source/documentation/lux/data/collection/dictionary/ordered.lux @@ -32,8 +32,7 @@ (template [] [(`` (documentation: - (format "Yields value under the " (~~ (template.text [])) "imum key.") - [( dict)]))] + (format "Yields value under the " (~~ (template.text [])) "imum key.")))] [/.min] [/.max] diff --git a/stdlib/source/documentation/lux/data/collection/list.lux b/stdlib/source/documentation/lux/data/collection/list.lux index 6f60d5085..fe7d11246 100644 --- a/stdlib/source/documentation/lux/data/collection/list.lux +++ b/stdlib/source/documentation/lux/data/collection/list.lux @@ -36,24 +36,6 @@ \n "Caveat emptor: If the list has an un-even number of elements, the last one will be skipped.") [(pairs xs)]) -(template [] - [(documentation: - "" - [( n xs)])] - - [/.first] - [/.after] - ) - -(template [] - [(documentation: - "" - [( predicate xs)])] - - [/.while] - [/.until] - ) - (documentation: /.split_at "" [(split_at n xs)]) @@ -94,15 +76,6 @@ "" [(size list)]) -(template [] - [(documentation: - "" - [( predicate items)])] - - [/.every?] - [/.any?] - ) - (documentation: /.item "Fetches the element at the specified index." [(item i xs)]) @@ -121,8 +94,7 @@ (template [ ] [(documentation: - - [( xs)])] + )] [/.head "Yields the first element of a list."] [/.tail "For a list of size N, yields the N-1 elements after the first one."] @@ -187,12 +159,6 @@ ..partition ..pairs - ..first - ..after - - ..while - ..until - ..split_at ..split_when ..sub @@ -203,9 +169,6 @@ ..example ..interposed ..size - - ..every? - ..any? ..item ..sorted @@ -235,5 +198,11 @@ ($.default /.zipped/2) ($.default /.zipped/3) ($.default /.zipped_with/2) - ($.default /.zipped_with/3)] + ($.default /.zipped_with/3) + ($.default /.first) + ($.default /.after) + ($.default /.while) + ($.default /.until) + ($.default /.every?) + ($.default /.any?)] [])) diff --git a/stdlib/source/documentation/lux/data/collection/sequence.lux b/stdlib/source/documentation/lux/data/collection/sequence.lux index 44b589ad7..fb97896d9 100644 --- a/stdlib/source/documentation/lux/data/collection/sequence.lux +++ b/stdlib/source/documentation/lux/data/collection/sequence.lux @@ -35,27 +35,6 @@ "" [(item idx sequence)]) -(template [ ] - [(documentation: - "" - [( pred xs)]) - (documentation: - "" - [( pred xs)])] - - [/.while /.until] - [/.first /.after] - ) - -(template [] - [(documentation: - "" - [( pred xs)])] - - [/.split_when] - [/.split_at] - ) - (documentation: /.only "A new sequence only with items that satisfy the predicate." [(only predicate sequence)]) @@ -81,12 +60,6 @@ ..repeated ..cycle ..item - - ..while ..until - ..first ..after - - ..split_when - ..split_at ..only ..partition @@ -94,5 +67,11 @@ ($.default /.head) ($.default /.tail) ($.default /.functor) - ($.default /.comonad)] + ($.default /.comonad) + ($.default /.while) + ($.default /.until) + ($.default /.first) + ($.default /.after) + ($.default /.split_when) + ($.default /.split_at)] [])) diff --git a/stdlib/source/documentation/lux/data/collection/set/multi.lux b/stdlib/source/documentation/lux/data/collection/set/multi.lux index fa1ee3d23..ea0a017ae 100644 --- a/stdlib/source/documentation/lux/data/collection/set/multi.lux +++ b/stdlib/source/documentation/lux/data/collection/set/multi.lux @@ -28,17 +28,6 @@ "" [(multiplicity set elem)]) -(template [] - [(documentation: - "" - [( parameter subject)])] - - [/.union] - [/.sum] - [/.intersection] - [/.difference] - ) - (documentation: /.sub? "Is 'subject' a sub-set of 'reference'?" [(sub? reference subject)]) @@ -62,10 +51,7 @@ ..has ..lacks ..multiplicity - ..union - ..sum - ..intersection - ..difference + ..sub? ..support ..member? @@ -77,5 +63,9 @@ ($.default /.hash) ($.default /.empty?) ($.default /.of_list) - ($.default /.of_set)] + ($.default /.of_set) + ($.default /.union) + ($.default /.sum) + ($.default /.intersection) + ($.default /.difference)] [])) diff --git a/stdlib/source/documentation/lux/data/color.lux b/stdlib/source/documentation/lux/data/color.lux index 7ad4ed77a..73c383ff1 100644 --- a/stdlib/source/documentation/lux/data/color.lux +++ b/stdlib/source/documentation/lux/data/color.lux @@ -40,17 +40,6 @@ "" [(interpolated ratio end start)]) -(template [] - [(documentation: - "" - [( ratio color)])] - - [/.darker] - [/.brighter] - [/.saturated] - [/.un_saturated] - ) - (syntax: (palette_documentation [[_ name] .identifier]) (in (list (code.text (format "A " (text.replaced "_" "-" name) " palette."))))) @@ -101,11 +90,6 @@ ..Color ..complement ..interpolated - - ..darker - ..brighter - ..saturated - ..un_saturated ..analogous ..monochromatic @@ -137,5 +121,9 @@ ($.default /.of_cmyk) ($.default /.gray_scale) ($.default /.Spread) - ($.default /.Palette)] + ($.default /.Palette) + ($.default /.darker) + ($.default /.brighter) + ($.default /.saturated) + ($.default /.un_saturated)] [/named.documentation])) diff --git a/stdlib/source/documentation/lux/data/format/json.lux b/stdlib/source/documentation/lux/data/format/json.lux index ae21ac641..cf3182daa 100644 --- a/stdlib/source/documentation/lux/data/format/json.lux +++ b/stdlib/source/documentation/lux/data/format/json.lux @@ -34,8 +34,7 @@ (template [ ] [(documentation: - (format "A JSON object field getter for " ".") - [( key json)])] + (format "A JSON object field getter for " "."))] [/.boolean_field "booleans"] [/.number_field "numbers"] diff --git a/stdlib/source/documentation/lux/ffi.jvm.lux b/stdlib/source/documentation/lux/ffi.jvm.lux index b9f05398e..b5b8cb245 100644 --- a/stdlib/source/documentation/lux/ffi.jvm.lux +++ b/stdlib/source/documentation/lux/ffi.jvm.lux @@ -40,9 +40,7 @@ (template [ ] [(`` (documentation: - "Type converter." - [(: - ( (: foo)))]))] + "Type converter."))] [/.byte_to_long Byte Long] diff --git a/stdlib/source/documentation/lux/ffi.old.lux b/stdlib/source/documentation/lux/ffi.old.lux index 34bafe786..308c13a4a 100644 --- a/stdlib/source/documentation/lux/ffi.old.lux +++ b/stdlib/source/documentation/lux/ffi.old.lux @@ -12,10 +12,7 @@ (template [ ] [(documentation: - "Type converter." - [(: (primitive ) - ( (: (primitive ) - it)))])] + "Type converter.")] [/.byte_to_long "java.lang.Byte" "java.lang.Long"] diff --git a/stdlib/source/documentation/lux/macro.lux b/stdlib/source/documentation/lux/macro.lux index f82563c8a..d3ee4bbba 100644 --- a/stdlib/source/documentation/lux/macro.lux +++ b/stdlib/source/documentation/lux/macro.lux @@ -52,20 +52,44 @@ "Works just like expand, except that it ensures that the output is a single Code token." [(one_expansion token)]) -(template [] - [(documentation: - (format "Performs a macro-expansion and logs the resulting code." - \n "You can either use the resulting code, or omit them." - \n "By omitting them, this macro produces nothing (just like the lux.comment macro).") - [( "omit" - (def: (foo bar baz) - (-> Int Int Int) - (int.+ bar baz)))])] +(documentation: /.log_single_expansion! + (format "Performs a macro-expansion and logs the resulting code." + \n "You can either use the resulting code, or omit them." + \n "By omitting them, this macro produces nothing (just like the lux.comment macro).") + [(log_single_expansion! + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz))) + (log_single_expansion! "omit" + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz)))]) - [/.log_single_expansion!] - [/.log_expansion!] - [/.log_full_expansion!] - ) +(documentation: /.log_expansion! + (format "Performs a macro-expansion and logs the resulting code." + \n "You can either use the resulting code, or omit them." + \n "By omitting them, this macro produces nothing (just like the lux.comment macro).") + [(log_expansion! + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz))) + (log_expansion! "omit" + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz)))]) + +(documentation: /.log_full_expansion! + (format "Performs a macro-expansion and logs the resulting code." + \n "You can either use the resulting code, or omit them." + \n "By omitting them, this macro produces nothing (just like the lux.comment macro).") + [(log_full_expansion! + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz))) + (log_full_expansion! "omit" + (def: (foo bar baz) + (-> Int Int Int) + (int.+ bar baz)))]) (.def: .public documentation (.List $.Module) diff --git a/stdlib/source/documentation/lux/macro/template.lux b/stdlib/source/documentation/lux/macro/template.lux index 869c15518..00be1845a 100644 --- a/stdlib/source/documentation/lux/macro/template.lux +++ b/stdlib/source/documentation/lux/macro/template.lux @@ -39,20 +39,15 @@ "=>" "#0123+456+789.0abcdefghi"]) -(template [ ] - [(documentation: - (format " " (/.text []) " made by concatenating pieces of code." - \n "The (optional) module part and the short part are specified independently.") - [( ["abc" .def ..ghi]) - "=>" - ] - [( [.def] ["abc" .def ..ghi]) - "=>" - ])] - - ["An" /.identifier abcdefghi .abcdefghi] - ["A" /.tag #abcdefghi #.abcdefghi] - ) +(documentation: /.identifier + (format "An identifier made by concatenating pieces of code." + \n "The (optional) module part and the short part are specified independently.") + [(identifier ["abc" .def ..ghi]) + "=>" + abcdefghi] + [(identifier [.def] ["abc" .def ..ghi]) + "=>" + .abcdefghi]) (documentation: /.let "Lexically-bound templates." @@ -71,7 +66,6 @@ ..with_locals ..text ..identifier - ..tag ..let ($.default /.irregular_arguments)] [])) diff --git a/stdlib/source/documentation/lux/math/number/frac.lux b/stdlib/source/documentation/lux/math/number/frac.lux index d14b0e3b5..1d4a2f45e 100644 --- a/stdlib/source/documentation/lux/math/number/frac.lux +++ b/stdlib/source/documentation/lux/math/number/frac.lux @@ -32,8 +32,7 @@ (template [ ] [(documentation: - - [( param subject)])] + )] [/.+ "Frac(tion) addition."] [/.- "Frac(tion) substraction."] @@ -48,8 +47,7 @@ (template [ ] [(documentation: - - [( left right)])] + )] [/.min "Frac(tion) minimum."] [/.max "Frac(tion) minimum."] diff --git a/stdlib/source/documentation/lux/math/number/i64.lux b/stdlib/source/documentation/lux/math/number/i64.lux index 18365fe3a..49e371342 100644 --- a/stdlib/source/documentation/lux/math/number/i64.lux +++ b/stdlib/source/documentation/lux/math/number/i64.lux @@ -12,8 +12,7 @@ (template [ ] [(documentation: - - [( parameter subject)])] + )] [/.or "Bitwise or."] [/.xor "Bitwise xor."] @@ -44,15 +43,11 @@ "Count the number of 1s in a bit-map." [(ones it)]) -(documentation: /.zero - "Clear bit at the given index." - [(zero index input)]) - (template [ ] [(documentation: - - [( index input)])] + )] + [/.zero "Clear bit at the given index."] [/.one "Set bit at given index."] [/.flipped "Flip bit at given index."] ) @@ -65,15 +60,6 @@ "" [(zero? index input)]) -(template [] - [(documentation: - "" - [( distance input)])] - - [/.left_rotated] - [/.right_rotated] - ) - (documentation: /.region "A mask for a block of bits of the given size, starting at the given offset." [(region offset size)]) @@ -105,8 +91,6 @@ ..flipped ..one? ..zero? - ..left_rotated - ..right_rotated ..region ..Sub ..sub @@ -119,5 +103,7 @@ ($.default /.hash) ($.default /.disjunction) ($.default /.conjunction) - ($.default /.reversed)] + ($.default /.reversed) + ($.default /.left_rotated) + ($.default /.right_rotated)] [])) diff --git a/stdlib/source/documentation/lux/math/number/int.lux b/stdlib/source/documentation/lux/math/number/int.lux index fc8b72cfd..60659050c 100644 --- a/stdlib/source/documentation/lux/math/number/int.lux +++ b/stdlib/source/documentation/lux/math/number/int.lux @@ -32,8 +32,7 @@ (template [ ] [(documentation: - - [( left right)])] + )] [/.min "Int(eger) minimum."] [/.max "Int(eger) maximum."] @@ -41,8 +40,7 @@ (template [ ] [(documentation: - - [( param subject)])] + )] [/.+ "Int(eger) addition."] [/.- "Int(eger) substraction."] diff --git a/stdlib/source/documentation/lux/math/number/nat.lux b/stdlib/source/documentation/lux/math/number/nat.lux index 957da93b0..dbae19c36 100644 --- a/stdlib/source/documentation/lux/math/number/nat.lux +++ b/stdlib/source/documentation/lux/math/number/nat.lux @@ -12,8 +12,7 @@ (template [ ] [(documentation: - - [( parameter subject)])] + )] [/.= "Nat(ural) equivalence."] [/.+ "Nat(ural) addition."] @@ -30,8 +29,7 @@ (template [ ] [(documentation: - - [( left right)])] + )] [/.min "Nat(ural) minimum."] [/.max "Nat(ural) maximum."] diff --git a/stdlib/source/documentation/lux/math/number/rev.lux b/stdlib/source/documentation/lux/math/number/rev.lux index bd5c28ab1..2a2053128 100644 --- a/stdlib/source/documentation/lux/math/number/rev.lux +++ b/stdlib/source/documentation/lux/math/number/rev.lux @@ -32,8 +32,7 @@ (template [ ] [(documentation: - - [( left right)])] + )] [/.min "Rev(olution) minimum."] [/.max "Rev(olution) maximum."] @@ -41,8 +40,7 @@ (template [ ] [(documentation: - - [( param subject)])] + )] [/.+ "Rev(olution) addition."] [/.- "Rev(olution) substraction."] @@ -52,14 +50,13 @@ [/.ratio "Ratio between two rev(olution)s."] ) -(template [] - [(documentation: - "" - [( scale subject)])] +(documentation: /.up + "" + [(up scale subject)]) - [/.up] - [/.down] - ) +(documentation: /.down + "" + [(down scale subject)]) (documentation: /.reciprocal "Rev(olution) reciprocal of a Nat(ural)." diff --git a/stdlib/source/documentation/lux/meta/annotation.lux b/stdlib/source/documentation/lux/meta/annotation.lux index 310072c36..10f4d0aad 100644 --- a/stdlib/source/documentation/lux/meta/annotation.lux +++ b/stdlib/source/documentation/lux/meta/annotation.lux @@ -10,41 +10,22 @@ [\\library ["." /]]) -(template [] - [(documentation: - "" - [( tag ann)])] - - [/.value] - [/.bit] - [/.nat] - [/.int] - [/.rev] - [/.frac] - [/.text] - [/.identifier] - [/.tag] - [/.form] - [/.tuple] - [/.record] - ) - (.def: .public documentation (.List $.Module) ($.module /._ "Machinary for querying annotations on modules and definitions." - [..value - ..bit - ..nat - ..int - ..rev - ..frac - ..text - ..identifier - ..tag - ..form - ..tuple - ..record + [($.default /.value) + ($.default /.bit) + ($.default /.nat) + ($.default /.int) + ($.default /.rev) + ($.default /.frac) + ($.default /.text) + ($.default /.identifier) + ($.default /.tag) + ($.default /.form) + ($.default /.tuple) + ($.default /.record) ($.default /.Annotation) ($.default /.flagged?) ($.default /.implementation?)] diff --git a/stdlib/source/documentation/lux/static.lux b/stdlib/source/documentation/lux/static.lux index 64eb9c9b5..8f7789b25 100644 --- a/stdlib/source/documentation/lux/static.lux +++ b/stdlib/source/documentation/lux/static.lux @@ -12,10 +12,9 @@ (template [ ] [(documentation: - "" - [( - (: - (value generating expression)))])] + (%.code (' ( + (: + (value generating expression))))))] [/.nat .Nat] [/.int .Int] @@ -34,9 +33,8 @@ (template [ ] [(documentation: - "" - [(: - ())])] + (%.code (' (: + ()))))] [/.random_nat .Nat] [/.random_int .Int] diff --git a/stdlib/source/documentation/lux/test.lux b/stdlib/source/documentation/lux/test.lux index 66a17fcf7..f63a8885d 100644 --- a/stdlib/source/documentation/lux/test.lux +++ b/stdlib/source/documentation/lux/test.lux @@ -68,17 +68,19 @@ \n "WARNING: This procedure is only meant to be used in (program: ...) forms.") [(run! test)]) -(template [] - [(documentation: - (format "Specifies a test as covering one or more definitions." - \n "Adds to the test tally information to track which definitions have been tested.") - [( [definition/0 definition/1 ,,, definition/N] - (: Bit - (some "computation")))])] - - [/.cover'] - [/.cover] - ) +(documentation: /.cover' + (format "Specifies a test as covering one or more definitions." + \n "Adds to the test tally information to track which definitions have been tested.") + [(cover' [definition/0 definition/1 ,,, definition/N] + (: Bit + (some "computation")))]) + +(documentation: /.cover + (format "Specifies a test as covering one or more definitions." + \n "Adds to the test tally information to track which definitions have been tested.") + [(cover [definition/0 definition/1 ,,, definition/N] + (: Bit + (some "computation")))]) (documentation: /.for (format "Specifies a context for tests as covering one or more definitions." diff --git a/stdlib/source/documentation/lux/type.lux b/stdlib/source/documentation/lux/type.lux index b14ddc183..57d8f9497 100644 --- a/stdlib/source/documentation/lux/type.lux +++ b/stdlib/source/documentation/lux/type.lux @@ -26,8 +26,7 @@ (template [] [(documentation: - "The number of parameters, and the body, of a quantified type." - [( type)])] + "The number of parameters, and the body, of a quantified type.")] [/.flat_univ_q] [/.flat_ex_q] @@ -43,8 +42,7 @@ (template [] [(documentation: - "The members of a composite type." - [( type)])] + "The members of a composite type.")] [/.flat_variant] [/.flat_tuple] @@ -73,8 +71,7 @@ (template [] [(documentation: - "A composite type, constituted by the given member types." - [( types)])] + "A composite type, constituted by the given member types.")] [/.variant] [/.tuple] @@ -90,8 +87,7 @@ (template [] [(documentation: - "A quantified type, with the given number of parameters, and body." - [( size body)])] + "A quantified type, with the given number of parameters, and body.")] [/.univ_q] [/.ex_q] diff --git a/stdlib/source/documentation/lux/type/abstract.lux b/stdlib/source/documentation/lux/type/abstract.lux index 3db8dc7be..41c91897f 100644 --- a/stdlib/source/documentation/lux/type/abstract.lux +++ b/stdlib/source/documentation/lux/type/abstract.lux @@ -26,8 +26,12 @@ (template [ ] [(documentation: "Type-casting macro for abstract/nominal types." - [(: - ( (: value)))])] + [(|> value + (: Representation) + :abstraction + (: Abstraction) + :representation + (: Representation))])] [/.:abstraction representation abstraction] [/.:representation abstraction representation] diff --git a/stdlib/source/documentation/lux/type/resource.lux b/stdlib/source/documentation/lux/type/resource.lux index b9fd2ae39..335cef3b0 100644 --- a/stdlib/source/documentation/lux/type/resource.lux +++ b/stdlib/source/documentation/lux/type/resource.lux @@ -53,8 +53,7 @@ (template [] [(documentation: - "Makes a value into a resource and adds the key/access-right to it to the ambient keyring for future use." - [( monad value)])] + "Makes a value into a resource and adds the key/access-right to it to the ambient keyring for future use.")] [/.ordered] [/.commutative] diff --git a/stdlib/source/documentation/lux/type/unit.lux b/stdlib/source/documentation/lux/type/unit.lux index 98e13bcb3..14e7a8ce0 100644 --- a/stdlib/source/documentation/lux/type/unit.lux +++ b/stdlib/source/documentation/lux/type/unit.lux @@ -19,17 +19,6 @@ (documentation: (/.Qty unit) "A quantity with an associated unit of measurement.") -(template [] - [(documentation: - "" - [( param subject)])] - - [/.+] - [/.-] - [/.*] - [/./] - ) - (documentation: (/.Unit unit) "A unit of measurement, to qualify numbers with.") @@ -83,10 +72,6 @@ ($.module /._ "" [..Qty - ..+ - ..- - ..* - ../ ..Unit ..Scale ..Pure @@ -117,5 +102,9 @@ ($.default /.Giga) ($.default /.Milli) ($.default /.Micro) - ($.default /.Nano)] + ($.default /.Nano) + ($.default /.+) + ($.default /.-) + ($.default /.*) + ($.default /./)] [])) -- cgit v1.2.3