• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
      • Warnings
      • Primitives
      • Use-set
      • Syntax
      • Getting-started
      • Utilities
      • Loader
      • Transforms
      • Lint
      • Mlib
      • Server
      • Kit
      • Printer
        • Ps
        • Basic-printing
        • Verilog-printing
          • Vl-fmt
          • Vl-ppc-module
            • Vl-make-item-map-for-ppc-module
          • Vl-pp-expr
          • Vl-maybe-escape-identifier
          • Vl-print-ext-wirename
          • Vl-pp-module
          • Vl-print-wirename
          • Vl-print-loc
          • Vl-print-modname
          • Vl-pp-origexpr
          • Vl-pps-module
          • Vl-pps-expr
          • Vl-ppc-modulelist
          • Vl-ppcs-module
          • Vl-ps-update-show-atts
          • Vl-pps-origexpr
          • Vl-pps-modulelist
          • Vl-ppcs-modulelist
          • Vl-cw-obj
          • Vl-ps->show-atts-p
          • Vl-cw
        • Printing-locally
        • Formatted-printing
        • Accessing-printed-output
        • Vl-printedlist
        • Json-printing
      • Esim-vl
      • Well-formedness
    • Sv
    • Fgl
    • Vwsim
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Verilog-printing
• Vl-module-p

Vl-ppc-module

Pretty print a module with comments to ps.

Signature

(vl-ppc-module x ss &key (ps 'ps)) → ps

Arguments

x — Guard (vl-module-p x).

ss — Guard (vl-scopestack-p ss).

(vl-ppc-module x ss &key (ps 'ps)) extends ps with a pretty-printed representation of the module x.

For interactive use you may prefer vl-ppcs-module which writes to a string instead of ps.

The mods here should be the list of all modules and modalist is its vl-modalist; these arguments are only needed for hyperlinking to submodules in HTML mode.

Definitions and Theorems

Function: vl-ppc-module-fn

(defun vl-ppc-module-fn (x ss ps)
 (declare (xargs :stobjs (ps)))
 (declare (xargs :guard (and (vl-module-p x)
                             (vl-scopestack-p ss))))
 (let ((__function__ 'vl-ppc-module))
   (declare (ignorable __function__))
   (b*
    (((vl-module x) (vl-module-fix x))
     (ss (vl-scopestack-push x ss))
     ((mv imap ps)
      (vl-make-item-map-for-ppc-module x ss))
     (comments (vl-add-newlines-after-block-comments x.comments))
     (comments
          (if (vl-ps->htmlp)
              (vl-html-encode-commentmap comments (vl-ps->tabsize))
            comments))
     (guts (cwtime (vl-commentmap-entry-sort (append comments imap))
                   :mintime 1/2
                   :name vl-commentmap-entry-sort))
     (guts (vl-remove-empty-commentmap-entries guts)))
    (vl-ps-seq
         (vl-when-html (vl-println-markup "<div class=\"vl_src\">"))
         (vl-pp-atts x.atts)
         (vl-ps-span "vl_key" (vl-print "module "))
         (vl-print-modname x.name)
         (vl-print " (")
         (vl-pp-portlist x.ports)
         (vl-println ");")
         (vl-pp-encoded-commentmap guts)
         (vl-ps-span "vl_key" (vl-println "endmodule"))
         (vl-println "")
         (vl-when-html (vl-println-markup "</div>"))))))

Theorem: vl-ppc-module-fn-of-vl-module-fix-x

(defthm vl-ppc-module-fn-of-vl-module-fix-x
  (equal (vl-ppc-module-fn (vl-module-fix x)
                           ss ps)
         (vl-ppc-module-fn x ss ps)))

Theorem: vl-ppc-module-fn-vl-module-equiv-congruence-on-x

(defthm vl-ppc-module-fn-vl-module-equiv-congruence-on-x
  (implies (vl-module-equiv x x-equiv)
           (equal (vl-ppc-module-fn x ss ps)
                  (vl-ppc-module-fn x-equiv ss ps)))
  :rule-classes :congruence)

Theorem: vl-ppc-module-fn-of-vl-scopestack-fix-ss

(defthm vl-ppc-module-fn-of-vl-scopestack-fix-ss
  (equal (vl-ppc-module-fn x (vl-scopestack-fix ss)
                           ps)
         (vl-ppc-module-fn x ss ps)))

Theorem: vl-ppc-module-fn-vl-scopestack-equiv-congruence-on-ss

(defthm vl-ppc-module-fn-vl-scopestack-equiv-congruence-on-ss
  (implies (vl-scopestack-equiv ss ss-equiv)
           (equal (vl-ppc-module-fn x ss ps)
                  (vl-ppc-module-fn x ss-equiv ps)))
  :rule-classes :congruence)

Subtopics

Vl-make-item-map-for-ppc-module

Build a commentmap that has the encoded items for a module.