more doc type fixes.

db4
John Benediktsson 2014-05-24 17:16:26 -07:00
parent ddea3286d9
commit 02ac0662e7
19 changed files with 105 additions and 108 deletions

View File

@ -1,4 +1,4 @@
USING: help.markup help.syntax math kernel arrays ;
USING: arrays help.markup help.syntax kernel math ;
IN: 24-game
HELP: 24-game
@ -48,7 +48,7 @@ HELP: makes-24?
{ "b" integer }
{ "c" integer }
{ "d" integer }
{ "?" "a boolean" }
{ "?" boolean }
}
{ $description
"Tells if it is possible to win 24-game with these integers."

View File

@ -1,6 +1,6 @@
! Copyright (c) 2009 Samuel Tardieu.
! See See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax quotations sequences ;
USING: help.markup help.syntax kernel quotations sequences ;
IN: backtrack
HELP: fail
@ -32,7 +32,7 @@ HELP: if-amb
{ $values
{ "true" { $quotation ( -- ? ) } }
{ "false" quotation }
{ "?" "a boolean" }
{ "?" boolean }
}
{ $description "Execute the first quotation and returns " { $link t } " if it returns " { $link t } " itself. If it fails with " { $link fail } " or returns " { $link f } ", then the second quotation is executed and " { $link f } " is returned." } ;

View File

@ -1,11 +1,11 @@
! Copyright (C) 2010 Chris Double.
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax ;
USING: help.markup help.syntax kernel math sequences strings ;
IN: bitcoin.client
HELP: bitcoin-server
{ $values
{ "string" "a string" }
{ "string" string }
}
{ $description
"Returns the hostname of the json-rpc server for the bitcoin client. "
@ -16,7 +16,7 @@ HELP: bitcoin-server
HELP: bitcoin-port
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the port of the json-rpc server for the bitcoin client. "
@ -27,7 +27,7 @@ HELP: bitcoin-port
HELP: bitcoin-user
{ $values
{ "string" "a string" }
{ "string" string }
}
{ $description
"Returns the username required to authenticate with the json-rpc "
@ -38,7 +38,7 @@ HELP: bitcoin-user
HELP: bitcoin-password
{ $values
{ "string" "a string" }
{ "string" string }
}
{ $description
"Returns the password required to authenticate with the json-rpc "
@ -49,8 +49,8 @@ HELP: bitcoin-password
HELP: get-addresses-by-label
{ $values
{ "label" "a string" }
{ "seq" "a sequence" }
{ "label" string }
{ "seq" sequence }
}
{ $description
"Returns the list of addresses with the given label."
@ -58,7 +58,7 @@ HELP: get-addresses-by-label
HELP: get-balance
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the server's available balance."
@ -66,7 +66,7 @@ HELP: get-balance
HELP: get-block-count
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the number of blocks in the longest block chain."
@ -74,7 +74,7 @@ HELP: get-block-count
HELP: get-block-number
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the block number of the latest block in the longest block chain."
@ -82,7 +82,7 @@ HELP: get-block-number
HELP: get-connection-count
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the number of connections to other nodes."
@ -90,7 +90,7 @@ HELP: get-connection-count
HELP: get-difficulty
{ $values
{ "n" "a number" }
{ "n" number }
}
{ $description
"Returns the proof-of-work difficulty as a multiple of the minimum "
@ -99,7 +99,7 @@ HELP: get-difficulty
HELP: get-generate
{ $values
{ "?" "a boolean" }
{ "?" boolean }
}
{ $description
"Returns true if the server is trying to generate bitcoins, false "
@ -108,8 +108,8 @@ HELP: get-generate
HELP: set-generate
{ $values
{ "gen" "a boolean" }
{ "n" "a number" }
{ "gen" boolean }
{ "n" number }
}
{ $description
"If 'gen' is true, the server starts generating bitcoins. If 'gen' is "
@ -128,8 +128,8 @@ HELP: get-info
HELP: get-label
{ $values
{ "address" "a string" }
{ "label" "a string" }
{ "address" string }
{ "label" string }
}
{ $description
"Returns the label associated with the given address."
@ -137,8 +137,8 @@ HELP: get-label
HELP: set-label
{ $values
{ "address" "a string" }
{ "label" "a string" }
{ "address" string }
{ "label" string }
}
{ $description
"Sets the label associateed with the given address."
@ -146,7 +146,7 @@ HELP: set-label
HELP: remove-label
{ $values
{ "address" "a string" }
{ "address" string }
}
{ $description
"Removes the label associated with the given address."
@ -154,7 +154,7 @@ HELP: remove-label
HELP: get-new-address
{ $values
{ "address" "a string" }
{ "address" string }
}
{ $description
"Returns a new bitcoin address for receiving payments."
@ -162,8 +162,8 @@ HELP: get-new-address
HELP: get-new-labelled-address
{ $values
{ "label" "a string" }
{ "address" "a string" }
{ "label" string }
{ "address" string }
}
{ $description
"Returns a new bitcoin address for receiving payments. The given "
@ -172,8 +172,8 @@ HELP: get-new-labelled-address
HELP: get-received-by-address
{ $values
{ "address" "a string" }
{ "amount" "a number" }
{ "address" string }
{ "amount" number }
}
{ $description
"Returns the total amount received by the address in transactions "
@ -182,9 +182,9 @@ HELP: get-received-by-address
HELP: get-confirmed-received-by-address
{ $values
{ "address" "a string" }
{ "minconf" "a number" }
{ "amount" "a number" }
{ "address" string }
{ "minconf" number }
{ "amount" number }
}
{ $description
"Returns the total amount received by the address in transactions "
@ -193,8 +193,8 @@ HELP: get-confirmed-received-by-address
HELP: get-received-by-label
{ $values
{ "label" "a string" }
{ "amount" "a number" }
{ "label" string }
{ "amount" number }
}
{ $description
"Returns the total amount received by addresses with 'label' in transactions "
@ -203,9 +203,9 @@ HELP: get-received-by-label
HELP: get-confirmed-received-by-label
{ $values
{ "label" "a string" }
{ "minconf" "a number" }
{ "amount" "a number" }
{ "label" string }
{ "minconf" number }
{ "amount" number }
}
{ $description
"Returns the total amount received by the addresses with 'label' in transactions "
@ -214,9 +214,9 @@ HELP: get-confirmed-received-by-label
HELP: list-received-by-address
{ $values
{ "minconf" "a number" }
{ "include-empty" "a boolean" }
{ "seq" "a sequence" }
{ "minconf" number }
{ "include-empty" boolean }
{ "seq" sequence }
}
{ $description
"Return a sequence containing an assoc of data about the payments an "
@ -227,9 +227,9 @@ HELP: list-received-by-address
HELP: list-received-by-label
{ $values
{ "minconf" "a number" }
{ "include-empty" "a boolean" }
{ "seq" "a sequence" }
{ "minconf" number }
{ "include-empty" boolean }
{ "seq" sequence }
}
{ $description
"Return a sequence containing an assoc of data about the payments that "
@ -241,9 +241,9 @@ HELP: list-received-by-label
HELP: send-to-address
{ $values
{ "address" "a string" }
{ "amount" "a number" }
{ "?" "a boolean" }
{ "address" string }
{ "amount" number }
{ "?" boolean }
}
{ $description
"Sends 'amount' from the server's available balance to 'address'. "
@ -258,9 +258,9 @@ HELP: stop
HELP: list-transactions
{ $values
{ "count" "a number" }
{ "include-generated" "a boolean" }
{ "seq" "a sequence" }
{ "count" number }
{ "include-generated" boolean }
{ "seq" sequence }
}
{ $description
"Return's a sequence containing up to 'count' most recent transactions."

View File

@ -1,12 +1,13 @@
! Copyright (C) 2008 Doug Coleman.
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax io.streams.string strings ;
USING: help.markup help.syntax io.streams.string kernel
strings ;
IN: crypto.passwd-md5
HELP: authenticate-password
{ $values
{ "shadow" string } { "password" string }
{ "?" "a boolean" } }
{ "?" boolean } }
{ $description "Encodes the provided password and compares it to the encoded password entry from a shadowed password file." } ;
HELP: parse-shadow-password

View File

@ -1,9 +1,7 @@
! Copyright (C) 2010 Erik Charlebois
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.crossref help.stylesheet help.topics help.syntax
definitions io prettyprint summary arrays math sequences vocabs strings
see xml.data hashtables assocs game.models.obj.private game.models
game.models.util io.pathnames ;
USING: assocs game.models.obj.private help.markup help.syntax
io.pathnames kernel sequences strings ;
IN: game.models.obj
ABOUT: "game.models.obj"
@ -58,7 +56,7 @@ HELP: face>aos
{ $description "Convert a face line to a sequence of vertex attributes." } ;
HELP: push*
{ $values { "elt" "an object" } { "seq" sequence } }
{ $values { "elt" object } { "seq" sequence } }
{ $description "Push the value onto the sequence, keeping the sequence on the stack." } ;
HELP: push-current-model

View File

@ -3,7 +3,7 @@ USING: help.markup help.syntax sequences splitting strings ;
IN: grouping.extras
HELP: group-by
{ $values { "seq" "a sequence" } { "quot" { $quotation ( elt -- key ) } } { "groups" "a new assoc" } }
{ $values { "seq" sequence } { "quot" { $quotation ( elt -- key ) } } { "groups" "a new assoc" } }
{ $description "Groups the elements by the key received by applying quot to each element in the sequence." }
{ $examples
{ $example

View File

@ -1,4 +1,4 @@
USING: help.markup help.syntax kernel math ;
USING: help.markup help.syntax kernel math strings ;
IN: hashcash
ARTICLE: "hashcash" "Hashcash"
@ -31,7 +31,7 @@ $nl
{ mint mint* <hashcash> check-stamp salt } related-words
HELP: mint
{ $values { "resource" "a string" } { "stamp" "generated stamp" } }
{ $values { "resource" string } { "stamp" "generated stamp" } }
{ $description "This word generate a valid stamp with default parameters and the specified resource." } ;
HELP: mint*
@ -39,11 +39,11 @@ HELP: mint*
{ $description "As " { $snippet "mint" } " but it takes an hashcash tuple as a parameter." } ;
HELP: check-stamp
{ $values { "stamp" "a string" } { "?" boolean } }
{ $values { "stamp" string } { "?" boolean } }
{ $description "Check for stamp's validity. Only supports hashcash version 1." } ;
HELP: salt
{ $values { "length" integer } { "salted" "a string" } }
{ $values { "length" integer } { "salted" string } }
{ $description "It generates a random string of " { $snippet "length" } " characters." } ;
HELP: <hashcash>

View File

@ -65,7 +65,7 @@ HELP: capabilities
{ $description "Fetches the advertised extensions of the IMAP server." } ;
HELP: list-folders
{ $values { "directory" string } { "folders" "a sequence" } }
{ $values { "directory" string } { "folders" sequence } }
{ $description "Lists all folders in " { $snippet "directory" } ". Folders is a sequence of 3-tuples with the attributes, root and name of each folder matched." } ;
HELP: select-folder

View File

@ -1,6 +1,6 @@
USING: help.markup help.syntax ;
USING: help.markup help.syntax math ;
IN: math.algebra
HELP: chinese-remainder
{ $values { "aseq" "a sequence of integers" } { "nseq" "a sequence of positive integers" } { "x" "an integer" } }
{ $values { "aseq" "a sequence of integers" } { "nseq" "a sequence of positive integers" } { "x" integer } }
{ $description "If " { $snippet "nseq" } " integers are pairwise coprimes, " { $snippet "x" } " is the smallest positive integer congruent to each element in " { $snippet "aseq" } " modulo the corresponding element in " { $snippet "nseq" } "." } ;

View File

@ -116,7 +116,7 @@ HELP: n*V+V
{ $description "Calculate the vector sum " { $snippet "αx + y" } " and return a freshly-allocated vector with the same length as " { $snippet "x" } " and " { $snippet "y" } " containing the result. Corresponds to the xAXPY routines in BLAS." } ;
HELP: n*V
{ $values { "alpha" "a number" } { "x" blas-vector-base } { "alpha*x" blas-vector-base } }
{ $values { "alpha" number } { "x" blas-vector-base } { "alpha*x" blas-vector-base } }
{ $description "Calculate the scalar-vector product " { $snippet "αx" } " and return a freshly-allocated vector with the same length as " { $snippet "x" } " containing the result. Corresponds to the xSCAL routines in BLAS." } ;
HELP: V+

View File

@ -1,14 +1,14 @@
! Copyright (C) 2008 John Benediktsson, Doug Coleman.
! See http://factorcode.org/license.txt for BSD license
USING: help.markup help.syntax math ;
USING: help.markup help.syntax math sequences ;
IN: math.finance
HELP: sma
{ $values { "seq" "a sequence" } { "n" "number of periods" } { "newseq" "a sequence" } }
{ $values { "seq" sequence } { "n" "number of periods" } { "newseq" sequence } }
{ $description "Returns the Simple Moving Average with the specified periodicity." } ;
HELP: ema
{ $values { "seq" "a sequence" } { "n" "number of periods" } { "newseq" "a sequence" } }
{ $values { "seq" sequence } { "n" "number of periods" } { "newseq" sequence } }
{ $description
"Returns the Exponential Moving Average with the specified periodicity, calculated by:\n"
{ $list
@ -17,14 +17,14 @@ HELP: ema
} ;
HELP: macd
{ $values { "seq" "a sequence" } { "n1" "short number of periods" } { "n2" "long number of periods" } { "newseq" "a sequence" } }
{ $values { "seq" sequence } { "n1" "short number of periods" } { "n2" "long number of periods" } { "newseq" sequence } }
{ $description
"Returns the Moving Average Converge of the sequence, calculated by:\n"
{ $list "MACD[t] = EMA2[t] - EMA1[t]" }
} ;
HELP: momentum
{ $values { "seq" "a sequence" } { "n" "number of periods" } { "newseq" "a sequence" } }
{ $values { "seq" sequence } { "n" "number of periods" } { "newseq" sequence } }
{ $description
"Returns the Momentum of the sequence, calculated by:\n"
{ $list "MOM[t] = SEQ[t] - SEQ[t-n]" }

View File

@ -1,4 +1,4 @@
USING: help.markup help.syntax ;
USING: help.markup help.syntax math ;
IN: math.primes.lists
HELP: lprimes
@ -6,5 +6,5 @@ HELP: lprimes
{ $description "Return a sorted list containing all the prime numbers." } ;
HELP: lprimes-from
{ $values { "n" "an integer" } { "list" "a lazy list" } }
{ $values { "n" integer } { "list" "a lazy list" } }
{ $description "Return a sorted list containing all the prime numbers greater or equal to " { $snippet "n" } "." } ;

View File

@ -1,6 +1,6 @@
USING: help.markup help.syntax ;
USING: help.markup help.syntax math strings ;
IN: math.text.french
HELP: number>text
{ $values { "n" "an integer" } { "str" "a string" } }
{ $values { "n" integer } { "str" string } }
{ $description "Return the a string describing " { $snippet "n" } " in French. Numbers with absolute value equal to or greater than 10^12 will be returned using their numeric representation." } ;

View File

@ -1,6 +1,6 @@
USING: help.markup help.syntax ;
USING: help.markup help.syntax sequences ;
IN: math.text.utils
HELP: digit-groups
{ $values { "n" "a positive integer" } { "k" "a positive integer" } { "seq" "a sequence" } }
{ $values { "n" "a positive integer" } { "k" "a positive integer" } { "seq" sequence } }
{ $description "Decompose a number into groups of " { $snippet "k" } " digits and return them in a sequence starting with the least significant grouped digits first." } ;

View File

@ -1,6 +1,6 @@
! Copyright (C) 2010 Samuel Tardieu.
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax assocs ;
USING: assocs help.markup help.syntax math sequences ;
IN: path-finding
{ <astar> <bfs> <dijkstra> } related-words
@ -15,7 +15,7 @@ HELP: cost
{ "from" "a node" }
{ "to" "a node" }
{ "astar" "an instance of a subclassed " { $link astar } " tuple" }
{ "n" "a number" }
{ "n" number }
}
{ $description "Return the cost to go from " { $snippet "from" } " to " { $snippet "to" } ". "
{ $snippet "to" } " is necessarily a neighbour of " { $snippet "from" } "."
@ -26,7 +26,7 @@ HELP: heuristic
{ "from" "a node" }
{ "to" "a node" }
{ "astar" "an instance of a subclassed " { $link astar } " tuple" }
{ "n" "a number" }
{ "n" number }
}
{ $description "Return the estimated (undervalued) cost to go from " { $snippet "from" } " to " { $snippet "to" } ". "
{ $snippet "from" } " and " { $snippet "to" } " are not necessarily neighbours."
@ -92,7 +92,7 @@ HELP: find-path
HELP: considered
{ $values
{ "astar" astar }
{ "considered" "a sequence" }
{ "considered" sequence }
}
{ $description "When called after a call to " { $link find-path } ", return a list of nodes "
"which have been examined during the A* exploration."

View File

@ -1,14 +1,14 @@
! Copyright (C) 2007 Chris Double.
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax ;
USING: help.markup help.syntax strings ;
IN: peg.javascript
HELP: parse-javascript
{ $values
{ "string" "a string" }
{ "ast" "a JavaScript abstract syntax tree" }
{ $values
{ "string" string }
{ "ast" "a JavaScript abstract syntax tree" }
}
{ $description
{ $description
"Parse the input string using the JavaScript parser. Throws an error if "
"the string does not contain valid JavaScript. Returns the abstract syntax tree "
"if successful." } ;

View File

@ -1,6 +1,6 @@
! Copyright (C) 2009 Chris Double.
! See http://factorcode.org/license.txt for BSD license.
USING: help.markup help.syntax ;
USING: assocs help.markup help.syntax kernel strings ;
IN: s3
HELP: buckets
@ -16,7 +16,7 @@ HELP: buckets
HELP: create-bucket
{ $values
{ "bucket" "a string" }
{ "bucket" string }
}
{ $description
"Creates a bucket with the given name."
@ -28,7 +28,7 @@ HELP: create-bucket
HELP: delete-bucket
{ $values
{ "bucket" "a string" }
{ "bucket" string }
}
{ $description
"Deletes the bucket with the given name."
@ -40,7 +40,7 @@ HELP: delete-bucket
HELP: keys
{ $values
{ "bucket" "a string" }
{ "bucket" string }
{ "seq" "a sequence of " { $link key } " objects"}
}
{ $description
@ -53,10 +53,10 @@ HELP: keys
HELP: get-object
{ $values
{ "bucket" "a string" }
{ "key" "a string" }
{ "response" "The HTTP response object"}
{ "data" "The data returned from the http request"}
{ "bucket" string }
{ "key" string }
{ "response" "The HTTP response object"}
{ "data" "The data returned from the http request"}
}
{ $description
"Does an HTTP request to retrieve the object in the bucket with the given key."
@ -67,12 +67,12 @@ HELP: get-object
;
HELP: put-object
{ $values
{ "data" "an object" }
{ "mime-type" "a string" }
{ "bucket" "a string"}
{ "key" "a string"}
{ "headers" "an assoc"}
{ $values
{ "data" object }
{ "mime-type" string }
{ "bucket" string }
{ "key" string }
{ "headers" assoc }
}
{ $description
"Stores the object under the key in the given bucket. The object has "
@ -90,8 +90,8 @@ HELP: put-object
HELP: delete-object
{ $values
{ "bucket" "a string"}
{ "key" "a string"}
{ "bucket" string }
{ "key" string }
}
{ $description
"Deletes the object in the bucket with the given key."

View File

@ -1,11 +1,9 @@
USING: arrays help.markup help.syntax math
sequences.private vectors strings kernel math.order layouts
quotations generic.single ;
USING: help.markup help.syntax math sequences ;
IN: sequences.extras
HELP: subseq*
{ $values
{ "from" "an integer" } { "to" "an integer" } { "seq" "sequence" } { "subseq" "sequence" } }
{ "from" integer } { "to" integer } { "seq" sequence } { "subseq" sequence } }
{ $description "Outputs a new sequence using positions relative to one or both ends of the sequence. Positive values describes offsets relative to the start of the sequence, negative values relative to the end. Values of " { $link f } " for " { $snippet "from" } " indicate the beginning of the sequence, while an " { $link f } " for " { $snippet "to" } " indicates the end of the sequence." }
{ $notes "Both " { $snippet "from" } " and " { $snippet "to" } " can be safely set to values outside the length of the sequence. Also, " { $snippet "from" } " can safely reference a smaller or greater index position than " { $snippet "to" } "." }
{ $examples

View File

@ -2,15 +2,15 @@ USING: help.markup help.syntax sequences splitting strings ;
IN: splitting.extras
HELP: split*-when
{ $values { "seq" "a sequence" } { "quot" { $quotation ( ... elt -- ... ? ) } } { "pieces" "a new array" } }
{ $values { "seq" sequence } { "quot" { $quotation ( ... elt -- ... ? ) } } { "pieces" "a new array" } }
{ $description "A variant of " { $link split-when } " that includes the elements along which the sequence was split." }
{ $examples { $example "USING: ascii kernel prettyprint splitting.extras ;" "\"hello,world-how.are:you\" [ letter? not ] split*-when ." "{ \"hello\" \",\" \"world\" \"-\" \"how\" \".\" \"are\" \":\" \"you\" }" } } ;
HELP: split*
{ $values { "seq" "a sequence" } { "separators" "a sequence" } { "pieces" "a new array" } }
{ $values { "seq" sequence } { "separators" sequence } { "pieces" "a new array" } }
{ $description "A variant of " { $link split } " that includes the elements along which the sequence was split." }
{ $examples { $example "USING: prettyprint splitting.extras ;" "\"hello world-how are you?\" \" -\" split* ." "{ \"hello\" \" \" \"world\" \"-\" \"how\" \" \" \"are\" \" \" \"you?\" }" } } ;
HELP: split-find
{ $values { "seq" "a sequence" } { "quot" { $quotation ( seq -- i ) } } { "pieces" "a new array" } }
{ $values { "seq" sequence } { "quot" { $quotation ( seq -- i ) } } { "pieces" "a new array" } }
{ $description "Splits a sequence into slices using the provided quotation to find split points." } ;