USING: help parser prettyprint ;

ARTICLE: "handbook" "Factor documentation"
"Welcome to Factor! Factor documentation is takes the form of an outline, with cross-referencing hyperlinks between topics. You can click the triangle next to a topic heading to expand the topic."
$terpri
"There is some introductory material you will find useful when starting out:"
{ $subsection "presentation-intro" }
{ $subsection "tutorial" }
{ $subsection "quickref" }
"Detailed reference documentation:"
{ $subsection "syntax" }
{ $subsection "dataflow" }
{ $subsection "words" }
{ $subsection "objects" }
{ $subsection "math" }
{ $subsection "collections" }
{ $subsection "streams" }
{ $subsection "parser" }
{ $subsection "prettyprint" }
;

ARTICLE: "presentation-intro" "The presentation-based UI"
"Factor provides a " { $emphasis "presentation-based" } " user interface. A " { $emphasis "presentation" } " is a graphical representation of a live object. You can see presentations everywhere; help links, words, and code examples are all presentations."
$terpri
"When you place the mouse over a presentation, it is highlighted with a surrounding border."
$terpri
"Clicking a presentation with the left mouse button invokes a default command. Clicking the right mouse button displays a menu of applicable commands." ;

ARTICLE: "quickref" "Quick reference"
"Some words for performing common operations at the listener:"
{ $list
    {
        "You can read the documentation for a word with " { $link help } ":"
        { $code "\\ reverse help" }
    }
    { "You can print the top of the stack with " { $link . } }
    {
        "Source files are loaded with " { $link run-file } ":"
        { $code "\"tetris.factor\" run-file" }
    }
}
"If you enter an invalid word name, you will get a \"not a number\" error:"
{ $example
    "fdafasfa"
    "An unhandled error was caught:\n\nParsing <interactive>:1\nfdafasfa\n        ^\n\"Not a number\"\n\n:s :r show stacks at time of error.\n:get ( var -- value ) inspects the error namestack."
}
"Sometimes, the word " { $emphasis "does" } " exist, but you might need to " { $link POSTPONE: USE: } " its vocabulary first. The " { $link apropos } " word can help locate the correct vocabulary:"
{ $example "\"<label>\" apropos" "IN: gadgets-labels : <label>\nIN: compiler-backend : <label>" } ;