Skip to content

podcheck.t: Minimize exceptions db entries #23245

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

Merged
merged 1 commit into from
May 4, 2025

Conversation

khwilliamson
Copy link
Contributor

@khwilliamson khwilliamson commented May 3, 2025

cThis program examines the files in the distribution looking for ones that contain pod. When one is found, it knows that it is safe to link to its NAME.

It also maintains a data base that contains two types of entries: 1) known issues; and 2) entries that are safe to link to that are external to the distribution. The latter type includes things like man pages or perl modules not shipped with the core.

Commit 1fb05c6 added code to better know that it was safe to link to files containing pod in the distribution. But what happened was that that commit caused all such to be needlessly written out to the data base. That db is supposed to contain things that are exceptions, that can't be found otherwise. It is not intended to have the many entries that get resolved in the normal course of executing this program.

This commit solves this by marking the entries it finds normally in parsing as to not be written out to the data base. The data base is regenerated, removing these unnecesary entries that got added in 1fb05c6.

This replaces #23231

  • This set of changes does not require a perldelta entry.

@jkeenan
Copy link
Contributor

jkeenan commented May 3, 2025

This commit solves this by marking the entries it finds normally in parsing as to not be written out to the data base. The data base is regenerated, removing these unneccessary entries that got added in 1fb05c6.

s/unneccessary/unnecessary/

jkeenan
jkeenan previously requested changes May 3, 2025
Copy link
Contributor

@jkeenan jkeenan left a comment

Choose a reason for hiding this comment

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

Correct the commit message; otherwise LGTM

This program examines the files in the distribution looking for ones
that contain pod.  When one is found, it knows that it is safe to link
to its NAME.

It also maintains a data base that contains two types of entries: 1)
known issues; and 2) entries that are safe to link to that are external
to the distribution.  The latter type includes things like man pages or
perl modules not shipped with the core.

Commit 1fb05c6 added code to better
know that it was safe to link to files containing pod in the
distribution.  But what happened was that that commit caused all such to
be needlessly written out to the data base.  That db is supposed to
contain things that are exceptions, that can't be found otherwise.  It
is not intended to have the many entries that get resolved in the normal
course of executing this program.

This commit solves this by marking the entries it finds normally in
parsing as to not be written out to the data base.  The data base is
regenerated, removing these unnecessary entries that got added in
1fb05c6.
@jkeenan jkeenan added the Infrastructure Things needed to maintain Perl development label May 4, 2025
@khwilliamson khwilliamson merged commit 9ecd438 into Perl:blead May 4, 2025
33 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Infrastructure Things needed to maintain Perl development
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants