Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SignedCapsulePkg: make Doxygen interpret ASCII art as unparsed code #6476

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

bexcran
Copy link
Contributor

@bexcran bexcran commented Nov 27, 2024

Description

By default, Doxygen tries to nicely format all text within doc blocks. Unfortunately this mangles ASCII art: add @code{.unparsed} statements to EdkiiSystemFmpCapsule.h to cause Doxygen to display the text as provided.

  • Breaking change?
    • Breaking change - Does this PR cause a break in build or boot behavior?
    • Examples: Does it add a new library class or move a module to a different repo.
  • Impacts security?
    • Security - Does this PR have a direct security impact?
    • Examples: Crypto algorithm change or buffer overflow fix.
  • Includes tests?
    • Tests - Does this PR include any explicit test code?
    • Examples: Unit tests or integration tests.

How This Was Tested

Ran Doxygen after making the changes and verified the page at https://bsdio.com/edk2/docs/master/_edkii_system_fmp_capsule_8h.html is now displayed correctly.

Integration Instructions

N/A

By default, Doxygen tries to nicely format all text within doc blocks.
Unfortunately this mangles ASCII art: add @code{.unparsed} statements
to EdkiiSystemFmpCapsule.h to cause Doxygen to display the text as
provided.

Signed-off-by: Rebecca Cran <[email protected]>
@bexcran bexcran force-pushed the fmp-capsule-ascii-doc branch from 9fc682b to d7ddbca Compare December 2, 2024 15:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant