basis/help/topics/topics-docs.factor

   1 USING: help.markup help.syntax help.crossref help io io.styles
   2 hashtables strings ;
   3 IN: help.topics
   4
   5 HELP: articles
   6 { $var-description "Hashtable mapping article names to " { $link article } " instances." } ;
   7
   8 HELP: no-article
   9 { $values { "name" "an article name" } }
  10 { $description "Throws a " { $link no-article } " error." }
  11 { $error-description "Thrown by " { $link help } " if the given help topic does not exist, or if the help topic being dispayed links to a help topic which does not exist." } ;
  12
  13 HELP: article
  14 { $values { "name" "an article name" } { "article" "an " { $link article } " object" } }
  15 { $description "Outputs a named " { $link article } " object." } ;
  16
  17 HELP: article-title
  18 { $values { "topic" "an article name or a word" } { "string" string } }
  19 { $description "Outputs the title of a specific help article." } ;
  20
  21 HELP: article-content
  22 { $values { "topic" "an article name or a word" } { "content" "a markup element" } }
  23 { $description "Outputs the content of a specific help article." } ;
  24
  25 HELP: all-articles
  26 { $values { "seq" "a sequence" } }
  27 { $description "Outputs a sequence of all help article names, and all words with documentation." } ;
  28
  29 HELP: elements
  30 { $values { "elt-type" "a word" } { "element" "a markup element" } { "seq" "a new sequence" } }
  31 { $description "Outputs a sequence of all elements of type " { $snippet "elt-type" } " found by traversing " { $snippet "element" } "." } ;
  32
  33 HELP: collect-elements
  34 { $values { "element" "a markup element" } { "seq" "a sequence of words" } { "elements" "a new sequence" } }
  35 { $description "Collects the arguments of all sub-elements of " { $snippet "element" } " whose markup element type occurs in " { $snippet "seq" } "." }
  36 { $notes "Used to implement " { $link article-children } "." } ;
  37
  38 HELP: link
  39 { $class-description "Class of help article presentations. Instances can be passed to " { $link write-object } " to output a clickable hyperlink. Also, instances of this class are valid definition specifiers; see " { $link "definitions" } "." } ;
  40
  41 HELP: related-words
  42 { $values { "seq" "a sequence of words" } }
  43 { $description "Defines a set of related words. Each word's documentation will contain links to all other words in the set." } ;