Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
  • Sign in / Register
  • GHC GHC
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 5,357
    • Issues 5,357
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
  • Merge requests 566
    • Merge requests 566
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Releases
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • Glasgow Haskell CompilerGlasgow Haskell Compiler
  • GHCGHC
  • Merge requests
  • !6224

Hi Haddock 2021 - Generate docs from .hi files

  • Review changes

  • Download
  • Email patches
  • Plain diff
Closed Zubin requested to merge wip/hi-haddock2021 into master Jul 23, 2021
  • Overview 54
  • Commits 1
  • Pipelines 46
  • Changes 139

This is a rebased and improved version of @harpocrates rebase of @sjakobi's original patch

See also !608 (closed)

Major differences from that patch include

  • We now properly attribute docs for default method signatures, which required quite a bit of plumbing
  • Identifiers in documentation strings are just acculated in a NameSet, haddock then picks appropriate names for the identifiers from this set, with the correct name space. We don't map individual substrings of the docstring corresponding to the list of possible Names anymore, since this is fragile and unnecessary, as the naming environment is the same for the entire docstring. This in turn means that HsDocIdentifierSpan is unnecessary since neither GHC nor Haddock use it for anything. It might be good to delete it entirely, but other tooling might like to know where exactly in the docstring certain names occur so I'm not sure. The logic to compute HsDocIdentifierSpan in HaddockLex is quite tricky, so I'm leaning towards removing it.
  • Haddock no longer uses a plugin since we don't need access to the parsed module.
  • Various other minor improvements and bug fixes
Edited Mar 22, 2022 by Matthew Pickering
Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: wip/hi-haddock2021