Skip to content

Common Workflows

Step-by-step guides for typical development tasks.

Note: The Tk UI has most features described below implemented (Smart Insert, Variables Window, Execution Stack, Renumber). The Settings dialog for configuring these features is planned but not yet implemented - see Settings for details.

1. Write New Program

  1. Press {{kbd:file_new:tk}} (New)
  2. Type: 10 PRINT "START"
  3. Press Enter
  4. Type: 20 END
  5. Press {{kbd:run_program:tk}} (Run)
  6. Check output
  7. Press {{kbd:file_save:tk}} (Save)

2. Expand Existing Program

You have working code and need to add more:

  1. Find where to insert new code
  2. Press {{kbd:smart_insert:tk}} (Smart Insert) to insert blank line
  3. Type your new code
  4. Press {{kbd:run_program:tk}} (Run) to test
  5. Press {{kbd:file_save:tk}} (Save)

3. Debug with Breakpoints

  1. Click line number gutter to set breakpoint (● appears)
  2. Press {{kbd:toggle_variables:tk}} to open Variables window
  3. Press {{kbd:run_program:tk}} (Run)
  4. Program stops at breakpoint
  5. Check variable values
  6. Use Step Statement (Run menu) to step through code
  7. Variables update in real-time
  8. Use Continue (Run menu) to continue

4. Fix Syntax Errors

  1. Look for red ? in line number gutter
  2. Read error in output pane
  3. Fix the syntax
  4. ? disappears automatically (100ms delay)
  5. Press {{kbd:run_program:tk}} (Run) to test

5. Renumber Before Sharing

Your development version has messy line numbers. Make it clean:

  1. Press {{kbd:renumber:tk}} (Renumber)
  2. Set Start=10, Increment=10
  3. Click "Renumber"
  4. All GOTO/GOSUB references automatically updated!

← Back to Tk GUI Help