• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
      • Theories
      • Rule-classes
      • Proof-builder
      • Recursion-and-induction
      • Hons-and-memoization
      • Events
      • Parallelism
      • History
      • Programming
        • Defun
        • Declare
        • System-utilities
        • Stobj
        • State
        • Mutual-recursion
        • Memoize
        • Mbe
        • Io
        • Defpkg
        • Apply$
        • Loop$
        • Programming-with-state
        • Arrays
        • Characters
        • Time$
        • Defmacro
        • Loop$-primer
        • Fast-alists
        • Defconst
        • Evaluation
        • Guard
        • Equality-variants
        • Compilation
        • Hons
        • ACL2-built-ins
        • Developers-guide
        • System-attachments
        • Advanced-features
        • Set-check-invariant-risk
        • Numbers
        • Efficiency
        • Irrelevant-formals
        • Introduction-to-programming-in-ACL2-for-those-who-know-lisp
        • Redefining-programs
        • Lists
        • Invariant-risk
        • Errors
        • Defabbrev
        • Conses
        • Alists
        • Set-register-invariant-risk
        • Strings
          • Std/strings
            • Pretty-printing
              • Pretty-printing-implementation
                • Missing-functionality
                • Printconfig
                • Cons-ppr1
                • Print-escaped-charlist
                • Atom-size
                • Print-escaped-str
                • Obj-size
                • Maybe-merge-flat
                • Ppr
                • Printer-instructions
                  • Pinst
                  • Pflat
                  • Pinstlist
                • Keyword-param-valuep
                • Print-flat-objs
                • Radix-print-int
                • Print-escaped-atom
                • Print-atom
                • Print-escaped-symbol
                • Radix-print-complex
                • Basic-print-complex
                • Radix-print-rat
                • Spaces1
                • Basic-print-rat
                • Basic-print-nat
                • Basic-print-int
                • Spaces
                • My-needs-slashes
                • Pinstlist->max-width
                • Nat-size
                • Special-term-num
                • Print-column
                • Print-base-fix
                • Int-size
                • Keyword-fix
                • Print-instruction
                • Pinst->width
                • In-home-package-p
                • Eviscerated->guts
                • Evisceratedp
                • Pprdot
              • Eviscerate
              • Pretty
              • Revappend-pretty
              • Pretty-list
            • Printtree
            • Base64
            • Charset-p
            • Strtok!
            • Cases
            • Concatenation
            • Html-encoding
            • Character-kinds
            • Substrings
            • Strtok
            • Equivalences
            • Url-encoding
            • Lines
            • Explode-implode-equalities
            • Ordering
            • Numbers
            • Pad-trim
            • Coercion
            • Std/strings/digit-to-char
            • Substitution
            • Symbols
          • String-listp
          • Stringp
          • Length
          • Search
          • Remove-duplicates
          • Position
          • Coerce
          • Concatenate
          • Reverse
          • String
          • Subseq
          • Substitute
          • String-upcase
          • String-downcase
          • Count
          • Char
          • String<
          • String-equal
          • String-utilities
          • String-append
          • String>=
          • String<=
          • String>
          • Hex-digit-char-theorems
          • String-downcase-gen
          • String-upcase-gen
        • Program-wrapper
        • Get-internal-time
        • Basics
        • Packages
        • Oracle-eval
        • Defmacro-untouchable
        • <<
        • Primitive
        • Revert-world
        • Unmemoize
        • Set-duplicate-keys-action
        • Symbols
        • Def-list-constructor
        • Easy-simplify-term
        • Defiteration
        • Fake-oracle-eval
        • Defopen
        • Sleep
      • Operational-semantics
      • Real
      • Start-here
      • Debugging
      • Miscellaneous
      • Output-controls
      • Macros
      • Interfacing-tools
    • Interfacing-tools
    • Hardware-verification
    • Software-verification
    • Math
    • Testing-utilities
  • Pretty-printing-implementation

Printer-instructions

Internal "instruction" data structure used by our pretty-printing algorithm.

Our pretty-printing algorithm operates in two linear passes. The first pass builds a list of printer instructions ("pinst" structures) that tell the second pass how to print. (In ACL2's pretty-printer, these structures are referred to as "ppr tuples".)

We now define the valid kinds of printer instructions. To understand these, it is very helpful to start with print-instruction, the second pass of pretty-printing, which follows these instructions to produce its output. You can basically think of print-instruction as an evaluator that gives these instructions their semantics.

Subtopics

Pinst
Pflat
Print some objects all on one line.
Pinstlist
A list of pinst-p objects.