 IN: parser
 
 ARTICLE: "reading-ahead" "Reading ahead"
-"Parsing words can consume input:"
+"Parsing words can consume input from the input stream. Words come in two flavors: words that throw upon finding end of file, and words that return " { $link f } "upon the same." $nl
+"Parsing words that throw on end of file:"
 { $subsections
     scan-token
     scan-word-name

{ $values { "string" string } { "word/number" "a word or number" } }
{ $description "If " { $snippet "string" } " is a valid number literal, it is converted to a number, otherwise the current vocabulary search path is searched for a word named by the string." }
{ $errors "Throws an error if the token does not name a word, and does not parse as a number." }
{ $notes "This word is used to implement " { $link (scan-datum) } "." } ;

HELP: scan-word
{ $values { "word" "a word" } }

    scan-number
    scan-object
}
"Parsing words that return " { $link f } " on end of file:"
{ $subsections
    (scan-token)
    (scan-datum)
