basis/tools/walker/walker-docs.factor

   1 IN: tools.walker
   2 USING: help.syntax help.markup tools.continuations sequences math words ;
   3
   4 HELP: breakpoint
   5 { $values { "word" word } }
   6 { $description "Annotates a word definition to enter the single stepper when executed." } ;
   7
   8 HELP: breakpoint-if
   9 { $values { "quot" { $quotation "( -- ? )" } } { "word" word } }
  10 { $description "Annotates a word definition to enter the single stepper if the quotation yields true." } ;
  11
  12 HELP: B
  13 { $description "An alias for " { $link break } ", defined in the " { $vocab-link "syntax" } " vocabulary so that it is always available." } ;
  14
  15 ARTICLE: "breakpoints" "Setting breakpoints"
  16 "In addition to invoking the walker explicitly through the UI, it is possible to set breakpoints on words using words in the " { $vocab-link "tools.walker" } " vocabulary."
  17 $nl
  18 "Annotating a word with a breakpoint (see " { $link "tools.annotations" } "):"
  19 { $subsection breakpoint }
  20 { $subsection breakpoint-if }
  21 "Breakpoints can be inserted directly into code:"
  22 { $subsection break }
  23 { $subsection POSTPONE: B }
  24 "Note that because the walker calls various core library and UI words while rendering its own user interface, setting a breakpoint on a word such as " { $link append } " or " { $link + } " will hang the UI." ;
  25
  26 ABOUT: "breakpoints"