• Top
  • Documentation
  • Books
  • Recursion-and-induction
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
    • Theories
    • Rule-classes
    • Proof-builder
      • Instructions
      • Proof-builder-commands
      • Proof-builder-commands-short-list
      • Dive-into-macros-table
      • Verify
      • Define-pc-macro
      • Macro-command
      • Define-pc-help
      • Toggle-pc-macro
      • Define-pc-meta
      • Retrieve
      • Unsave
      • Proof-checker
    • Hons-and-memoization
    • Events
    • History
    • Parallelism
    • Programming
    • Start-here
    • Real
    • Debugging
    • Miscellaneous
    • Output-controls
    • Macros
    • Interfacing-tools
  • Interfacing-tools
  • Hardware-verification
  • Software-verification
  • Testing-utilities
  • Math

• Proof-builder

Macro-command

Compound command for the interactive proof-builder

The interactive proof-builder supports the definition of compound commands, called ``macro commands'', which expand into zero or more other commands. Some of these are ``atomic'' macro commands; these are viewed as a single command step when completed successfully.

More documentation may be written on the interactive proof-builder. For now, we simply point out that there are lots of examples of the use of define-pc-macro and define-pc-atomic-macro in the ACL2 source file "proof-builder-b.lisp". The former is used to create macro commands, which can be submitted to the interactive loop (see verify) and will ``expand'' into zero or more commands. The latter is similar, except that the undoing mechanism (see ACL2-pc::undo) understands atomic macro commands to represent single interactive commands. Also see ACL2-pc::comm and see ACL2-pc::commands for a discussion of the display of interactive commands.

Also see toggle-pc-macro for how to change a macro command to an atomic macro command, and vice versa.