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

No package names in haddock index #2886

Closed
UnkindPartition opened this issue Dec 30, 2016 · 4 comments
Closed

No package names in haddock index #2886

UnkindPartition opened this issue Dec 30, 2016 · 4 comments

Comments

@UnkindPartition
Copy link
Contributor

The package index generated by stack haddock does not contain the package names. The package names seem to be present for the packages distributed with ghc but not for the packages installed with stack.

Here's a screenshot of my ~/.stack/snapshots/x86_64-linux/lts-7.0/8.0.1/doc/index.html. Notice the difference between, say, BasicTypes (distributed with ghc) and Bio.Core (from the biocore package, installed with stack from hackage).

stack-haddock

It's been a while since I looked at haddock, but my guess is that it has a command line option to specify the package name that stack does not pass.

The practical significance of this is that it makes it harder to search the index page, especially for packages that are named differently from their modules.

Stack version

$ stack --version
Version 1.3.3, Git revision 87068d8edb64e81f4062ae889472ef74452a2b97 (4441 commits) x86_64 hpack-0.15.0

Method of installation

from git master

@mgsloan
Copy link
Contributor

mgsloan commented Feb 1, 2017

Hmm, not sure why that would be, considering we are essentially using runhaskell Setup.hs haddock, which should know about the package name / version. I tried passing them in manually at

cabal False (concat [["haddock", "--html", "--hoogle", "--html-location=../$pkg-$version/"]
with

                                 ,"--haddock-options=--package-name=" ++ packageNameString (packageName package) ++ " --package-version=" ++ versionString (packageVersion package)

But no difference in the index :/

@mgsloan mgsloan added this to the P3: Optional milestone Feb 1, 2017
judah added a commit to judah/stack that referenced this issue Jun 21, 2017
…ents.

It turned out that Haddock expects to see packages with those names
in the GHC package DB.  Pointing Haddock to the local and snapshot DBs
resolved the issue.
judah added a commit to judah/stack that referenced this issue Jun 21, 2017
…ents.

It turned out that Haddock expects to see packages with those names
in the GHC package DB, and omits the names otherwise.  Pointing
Haddock to the local and snapshot DBs resolved the issue.
judah added a commit to judah/stack that referenced this issue Jun 21, 2017
…ents.

It turned out that Haddock expects to see packages with those names
in the GHC package DB, and omits the names otherwise.  Pointing
Haddock to the local and snapshot DBs resolved the issue.
judah added a commit to judah/stack that referenced this issue Jun 21, 2017
It turned out that Haddock expects to see packages with those names
in the GHC package DB, and omits the names otherwise.  Pointing
Haddock to the local and snapshot DBs resolved the issue.
@snoyberg
Copy link
Contributor

PR #3226 has been merged.

@UnkindPartition
Copy link
Contributor Author

Thanks a lot!

@snoyberg
Copy link
Contributor

Sure, thanks goes to @judah for figuring out the problem and writing the patch!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants