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

Resolve Haddock out-of-scope identifier warnings #404

Merged
merged 1 commit into from
Dec 14, 2024

Conversation

pgujjula
Copy link
Contributor

Fix all broken Haddock links. Now Haddock doesn't emit any warnings about out-of-scope identifiers. Warnings about unknown link destinations more complicated to resolve and are not handled in this PR.

That's because GHCi will default any type variables in your property to '()', so in the example
above @quickCheck@ was really testing that '()' is equal to itself. To avoid this behaviour it
That's because GHCi will default any type variables in your property to @()@, so in the example
above @quickCheck@ was really testing that @()@ is equal to itself. To avoid this behaviour it
Copy link
Contributor Author

Choose a reason for hiding this comment

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

() is not actually in the Haddocks for Prelude, so linking to () would require pulling in ghc-prim as a dependency. So we just make () monospaced instead of linking to it.

@MaximilianAlgehed
Copy link
Collaborator

Would you mind rebasing on master and we can try to get this over the line ASAP.

Fix all broken Haddock links. Now Haddock doesn't emit any warnings
about out-of-scope identifiers. Warnings about unknown link destinations
are more complicated to resolve and are not handled in this commit.
@pgujjula
Copy link
Contributor Author

pgujjula commented Dec 9, 2024

Hey @MaximilianAlgehed, sorry I missed your comment, I just rebased against the latest master and added one more fix that for a warning that appeared in the last few months related to isSuccess here: (link).

cc @UlfNorell

@MaximilianAlgehed MaximilianAlgehed merged commit 3e15ee2 into nick8325:master Dec 14, 2024
52 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