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

Docs[mqbcfg]: Complete conversion of mqbcfg documentation from BDE style to Doxygen style #575

Merged
merged 2 commits into from
Feb 4, 2025

Conversation

pniedzielski
Copy link
Collaborator

This continues the work started in PR #570 into the mqbcfg package. It contains two independent patches:

  • Convert mqbcfg documentation to Doxygen format: Migrates in-code documentation to Doxygen format.

  • Migrate mqbcfg docs directory into a Doxygen file: Migrates package-level documentation to Doxygen format.

This patch makes two changes:

1. First, it converts the BDE-style component documentation into Doxygen
   `@file` documentation.

2. Next, it converts stray BDE-style documentation that was not
   automatically converted to Doxygen format when we open-sourced.

This patch continues the work from commit d47304d.

Signed-off-by: Patrick M. Niedzielski <[email protected]>
This patch removes the old `doc/*.txt` file and migrates some
information in it into a file Doxygen can read.  The information not
migrated is:

  1. the table of contents for this package, which can be
     auto-generated from each component’s documentation, and

  2. the hierarchical synopsis.

This continues the changes made in commit 8c8af57.

Signed-off-by: Patrick M. Niedzielski <[email protected]>
Copy link
Contributor

@chrisbeard chrisbeard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@chrisbeard chrisbeard merged commit 12bc29e into bloomberg:main Feb 4, 2025
24 of 29 checks passed
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.

2 participants