• Top
    • Documentation
      • Xdoc
        • Undocumented
        • Save
        • Defsection
        • Markup
        • Preprocessor
        • Terminal
        • Emacs-links
        • Defxdoc
        • Katex-integration
        • Constructors
        • Entities
        • Defxdoc+
        • Save-rendered
        • Add-resource-directory
        • Testing
        • Order-subtopics
        • Save-rendered-event
        • Archive-matching-topics
        • Archive-xdoc
        • Xdoc-extend
        • Set-default-parents
        • Missing-parents
        • Defpointer
        • Defxdoc-raw
        • Xdoc-tests
        • Xdoc-prepend
          • Defsection-progn
          • Gen-xdoc-for-file
        • ACL2-doc
        • Recursion-and-induction
        • Loop$-primer
        • Operational-semantics
        • Pointers
        • Doc
        • Documentation-copyright
        • Course-materials
        • Args
        • ACL2-doc-summary
        • Finding-documentation
        • Broken-link
        • Doc-terminal-test-2
        • Doc-terminal-test-1
      • Books
      • Boolean-reasoning
      • Projects
      • Debugging
      • Std
      • Proof-automation
      • Macro-libraries
      • ACL2
      • Interfacing-tools
      • Hardware-verification
      • Software-verification
      • Math
      • Testing-utilities
    • Xdoc

    Xdoc-prepend

    Extend an existing XDOC topic with additional content, at the front.

    (xdoc-prepend name long) is very much like xdoc-extend, except that it extends the :long string for name at the front, instead of at the back.

    Basic example:

    (defxdoc foo
      :short "Example of xdoc-prepend."
      :long "<p>Foo is very important.</p>")
    
    (xdoc::xdoc-prepend foo
      "<p>Never use Foo, use Bar instead!</p>")

    is roughly equivalent to just writing:

    (defxdoc foo
      :short "Example of xdoc-prepend."
      :long "<p>Never use Foo, use Bar instead!</p>
              <p>Foo is very important.</p>")

    See xdoc-extend for related commentary.