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

doc: fix mansrc generation #7107

Merged
merged 1 commit into from
Aug 20, 2024
Merged

doc: fix mansrc generation #7107

merged 1 commit into from
Aug 20, 2024

Conversation

hzhou
Copy link
Contributor

@hzhou hzhou commented Aug 20, 2024

Pull Request Description

Just using the name without prefix, e.g. MPI_Send -> send.txt, resulting in duplicated filenames between MPI_/MPI_T_/MPIX_ functions, and they overwrite each other. This resulted in certain man pages missing. For example, MPI_Finalize and MPI_Init_thread man pages were missing because they were overwritten by the MPI_T_ correspondents.

The fix is to use the whole name for mansrc files, e.g. MPI_Finalize.txt and MPI_T_Finalize.txt.

Fixes #7089
[skip warnings]

Author Checklist

  • Provide Description
    Particularly focus on why, not what. Reference background, issues, test failures, xfail entries, etc.
  • Commits Follow Good Practice
    Commits are self-contained and do not do two things at once.
    Commit message is of the form: module: short description
    Commit message explains what's in the commit.
  • Passes All Tests
    Whitespace checker. Warnings test. Additional tests via comments.
  • Contribution Agreement
    For non-Argonne authors, check contribution agreement.
    If necessary, request an explicit comment from your companies PR approval manager.

Just using the name without prefix, e.g. MPI_Send -> send.txt, resulting
in duplicated filenames between MPI_/MPI_T_/MPIX_ functions, and they
overwrite each other. This resulted in certain man pages missing. For
example, MPI_Finalize and MPI_Init_thread man pages were missing because
they were overwritten by the MPI_T_ correspondents.
@hzhou
Copy link
Contributor Author

hzhou commented Aug 20, 2024

I locally verified the man pages for MPI_Finalize and MPI_Init_thread are generated after this PR.

@hzhou
Copy link
Contributor Author

hzhou commented Aug 20, 2024

Somehow the CI triggers are stuck. I'm going to merge anyway since the fix is trivial and won't be covered by the CI anyway.

@hzhou hzhou merged commit b1e8f30 into pmodels:main Aug 20, 2024
1 of 4 checks passed
@hzhou hzhou deleted the 2408_doctxt branch August 20, 2024 21:49
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.

Manpages of MPI_Finalize and MPI_Init_thread not available in v4.2.2
2 participants