• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Debugging
  • Projects
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Vwsim
    • Fgl
    • Vl
      • Syntax
      • Loader
        • Preprocessor
        • Vl-loadconfig
        • Vl-loadstate
        • Lexer
        • Parser
        • Vl-load-merge-descriptions
        • Vl-find-basename/extension
        • Vl-load-file
        • Vl-loadresult
        • Scope-of-defines
        • Vl-find-file
        • Vl-flush-out-descriptions
        • Vl-description
        • Vl-read-file
        • Vl-includeskips-report-gather
        • Vl-load-main
        • Extended-characters
        • Vl-load
        • Vl-load-description
        • Vl-descriptions-left-to-load
        • Inject-warnings
          • Vl-filter-warnings-by-loc
          • Vl-descriptionlist-inject-warnings
          • Vl-description-inject-warnings
          • Vl-description-add-warnings
          • Vl-warning->loc
        • Vl-preprocess-debug
        • Vl-write-preprocessor-debug-file
        • Vl-read-file-report-gather
        • Vl-load-descriptions
        • Vl-load-files
        • Translate-off
        • Vl-load-read-file-hook
        • Vl-read-file-report
        • Vl-loadstate-pad
        • Vl-load-summary
        • Vl-collect-modules-from-descriptions
        • Vl-loadstate->warnings
        • Vl-iskips-report
        • Vl-descriptionlist
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
      • Transforms
    • Svl
    • X86isa
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Inject-warnings

Vl-description-inject-warnings

Extract and attach in-bounds warnings to a description.

Signature

(vl-description-inject-warnings x warnings) 
  → 
(mv new-x warnings)

Arguments

x — Description to attach to.
    Guard (vl-description-p x).

warnings — List of early warnings.
    Guard (vl-warninglist-p warnings).

Returns

new-x — Perhaps updated with some warnings.
    Type (vl-description-p new-x).

warnings — Perhaps with some warnings removed.
    Type (vl-warninglist-p warnings).

Definitions and Theorems

Function: vl-description-inject-warnings

(defun vl-description-inject-warnings (x warnings)
  (declare (xargs :guard (and (vl-description-p x)
                              (vl-warninglist-p warnings))))
  (let ((__function__ 'vl-description-inject-warnings))
    (declare (ignorable __function__))
    (b* ((x (vl-description-fix x))
         (warnings (vl-warninglist-fix warnings))
         ((when (atom warnings)) (mv x warnings))
         ((unless (vl-description-has-comments-p x))
          (mv x warnings))
         (min (vl-description->minloc x))
         (max (vl-description->maxloc x))
         ((mv between beyond)
          (vl-filter-warnings-by-loc min max warnings nil nil))
         ((unless (consp between))
          (mv x warnings))
         (new-x (vl-description-add-warnings x between)))
      (mv new-x beyond))))

Theorem: vl-description-p-of-vl-description-inject-warnings.new-x

(defthm vl-description-p-of-vl-description-inject-warnings.new-x
  (b* (((mv ?new-x ?warnings)
        (vl-description-inject-warnings x warnings)))
    (vl-description-p new-x))
  :rule-classes :rewrite)

Theorem: vl-warninglist-p-of-vl-description-inject-warnings.warnings

(defthm vl-warninglist-p-of-vl-description-inject-warnings.warnings
  (b* (((mv ?new-x ?warnings)
        (vl-description-inject-warnings x warnings)))
    (vl-warninglist-p warnings))
  :rule-classes :rewrite)

Theorem: vl-description->name-of-vl-description-inject-warnings

(defthm vl-description->name-of-vl-description-inject-warnings
  (b* (((mv ?new-x ?warnings)
        (vl-description-inject-warnings x warnings)))
    (equal (vl-description->name new-x)
           (vl-description->name x)))
  :rule-classes :rewrite)

Theorem: vl-description-inject-warnings-of-vl-description-fix-x

(defthm vl-description-inject-warnings-of-vl-description-fix-x
  (equal (vl-description-inject-warnings (vl-description-fix x)
                                         warnings)
         (vl-description-inject-warnings x warnings)))

Theorem: vl-description-inject-warnings-vl-description-equiv-congruence-on-x

(defthm
 vl-description-inject-warnings-vl-description-equiv-congruence-on-x
 (implies (vl-description-equiv x x-equiv)
          (equal (vl-description-inject-warnings x warnings)
                 (vl-description-inject-warnings x-equiv warnings)))
 :rule-classes :congruence)

Theorem: vl-description-inject-warnings-of-vl-warninglist-fix-warnings

(defthm
      vl-description-inject-warnings-of-vl-warninglist-fix-warnings
 (equal
    (vl-description-inject-warnings x (vl-warninglist-fix warnings))
    (vl-description-inject-warnings x warnings)))

Theorem: vl-description-inject-warnings-vl-warninglist-equiv-congruence-on-warnings

(defthm
 vl-description-inject-warnings-vl-warninglist-equiv-congruence-on-warnings
 (implies (vl-warninglist-equiv warnings warnings-equiv)
          (equal (vl-description-inject-warnings x warnings)
                 (vl-description-inject-warnings x warnings-equiv)))
 :rule-classes :congruence)