<div dir="ltr">i'm sure patches are welcome to improve hackage infrastructure in these ways! :) </div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Jan 6, 2014 at 3:00 PM, Peter Selinger <span dir="ltr"><<a href="mailto:selinger@mathstat.dal.ca" target="_blank">selinger@mathstat.dal.ca</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thank you, this worked like a charm! (Modulo using dist/doc/html<br>
instead of dist/doc). Now all my packages have online documentation.<br>
<br>
One day I'd still like to find out why it didn't build automatically.<br>
But as long as documentation builder doesn't generate a log saying<br>
what problem it thought could not be solved, there is no way of<br>
knowing really.<br>
<br>
Thanks again, -- Peter<br>
<div class="HOEnZb"><div class="h5"><br>
Mateusz Kowalczyk wrote:<br>
><br>
> On 05/01/14 18:15, Peter Selinger wrote:<br>
> > I agree. Two of my packages are in your list: easyrender and newsynth<br>
> > (both have "Nothing" for a reason in your list).<br>
><br>
> If a package has Nothing for a reason, that means that no build log is<br>
> available. From what I've read yesterday, it's a problem with their<br>
> report system and I think it happens when cabal can't find<br>
> dependency candidates for your package. I link to a comment on GitHub<br>
> in my opening post which explains this.<br>
><br>
> > The problem for me is that, although you seem to have access to build<br>
> > logs, I don't. I have not found the way to access the hackage build<br>
> > logs for my packages or their documentation. Could you let me know<br>
> > where I can find them?<br>
><br>
> I do not have any special access to Hackage, I didn't even log in. See<br>
> my opening post for how to access the build log or see my reply to<br>
> Sven for an example. I really think there should be a button on the<br>
> site for this. If the build logs existed for newsynth, you could do<br>
> the following: check general build status[1] then check the first<br>
> report[2] then check the build log for the first report[3]. If the<br>
> build status is empty, you won't have any reports.<br>
><br>
> Check out [4][5][6] for an example on a package which failed to build<br>
> and has logs.<br>
><br>
> Effectively, the Nothing in my ‘report’ indicates no build status.<br>
><br>
> > For both packages, the documentation builds just fine on my local<br>
> > machine. It also builds fine in a virtual machine, under Windows and<br>
> > Ubuntu. Since I don't have access to Hackage's build logs, I cannot<br>
> > really figure out why the documentation is not building there. This is<br>
> > what has prevented me from fixing it.<br>
><br>
> I suspect Hackage fails to resolve your dependencies, at least that<br>
> what seems to be causing no logs. See [7] for a comment and [8] for an<br>
> existing GitHub issue (although one without any activity).<br>
><br>
> > I even created "candidates" for the packages, before uploading the<br>
> > packages to the main index. Again, the documentation did not build,<br>
> > and again, I could not find any logs to tell me what went wrong. So<br>
> > the whole "candidate" mechanism has so far been useless to me.<br>
> ><br>
> > You mentioned that there is a way to upload the documentation<br>
> > manually. I'd love to do that. But how? I don't see any buttons or<br>
> > links on the package maintainer's pages that would allow me to do<br>
> > that.<br>
><br>
> I post a link in my opening post to a comment about this. See [9].<br>
> I just tried to do it for one of my packages (yi-monokai-0.1.1.1) and<br>
> here are the steps I took:<br>
><br>
> 1. cd ~/programming/yi-monokai<br>
> 2. cabal configure && cabal build && cabal haddock --hyperlink-source<br>
> 3. cd dist/doc<br>
> 4. mv yi-monokai yi-monokai-0.1.1.1-docs<br>
> 5. tar -c -v -z -Hustar -f yi-monokai-0.1.1.1-docs.tar.gz<br>
> yi-monokai-0.1.1.1-docs<br>
> 6. curl -X PUT -H 'Content-Type: application/x-tar' -H<br>
> 'Content-Encoding: gzip' --data-binary<br>
> '@yi-monokai-0.1.1.1-docs.tar.gz'<br>
> '<a href="http://USERNAME:PASSWORD@hackage.haskell.org/package/yi-monokai-0.1.1.1/docs" target="_blank">http://USERNAME:PASSWORD@hackage.haskell.org/package/yi-monokai-0.1.1.1/docs</a>'<br>
><br>
> With these steps, my little package now has documentation. There's<br>
> some info on format at [10]. I might write a small blog post outlining<br>
> these steps later as it was not easy to figure out.<br>
><br>
> > Any help appreciated, -- Peter<br>
><br>
> [1]: <a href="http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/" target="_blank">http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/</a><br>
> [2]: <a href="http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/1" target="_blank">http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/1</a><br>
> [3]: <a href="http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/1/log" target="_blank">http://hackage.haskell.org/package/newsynth-0.1.0.0/reports/1/log</a><br>
> [4]: <a href="http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/" target="_blank">http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/</a><br>
> [5]: <a href="http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/1" target="_blank">http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/1</a><br>
> [6]:<br>
> <a href="http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/1/log" target="_blank">http://hackage.haskell.org/package/yi-monokai-0.1.1.1/reports/1/log</a><br>
> [7]:<br>
> <a href="https://github.com/haskell/hackage-server/issues/145#issuecomment-30129142" target="_blank">https://github.com/haskell/hackage-server/issues/145#issuecomment-30129142</a><br>
> [8]: <a href="https://github.com/haskell/hackage-server/issues/142" target="_blank">https://github.com/haskell/hackage-server/issues/142</a><br>
> [9]:<br>
> <a href="https://github.com/haskell/hackage-server/issues/145#issuecomment-29468613" target="_blank">https://github.com/haskell/hackage-server/issues/145#issuecomment-29468613</a><br>
> [10]: <a href="https://github.com/haskell/hackage-server/issues/56" target="_blank">https://github.com/haskell/hackage-server/issues/56</a><br>
> --<br>
> Mateusz K.<br>
><br>
<br>
_______________________________________________<br>
</div></div><div class="HOEnZb"><div class="h5">cabal-devel mailing list<br>
<a href="mailto:cabal-devel@haskell.org">cabal-devel@haskell.org</a><br>
<a href="http://www.haskell.org/mailman/listinfo/cabal-devel" target="_blank">http://www.haskell.org/mailman/listinfo/cabal-devel</a><br>
</div></div></blockquote></div><br></div>