[GHC] #14475: Upload documentation dumps
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: bgamari Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Keywords: | Operating System: Unknown/Multiple Architecture: | Type of failure: None/Unknown Unknown/Multiple | Test Case: | Blocked By: Blocking: | Related Tickets: Differential Rev(s): | Wiki Page: -------------------------------------+------------------------------------- Having a nightly job that would update https://downloads.haskell.org/~ghc/master/users-guide/ would be lovely. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: bgamari Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by gander): I would like to work on this. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by gander): * owner: bgamari => gander -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by gander): I have begun some investigation but wondered if it might be best if you gave me a starting point or background. I have: - used {{{make -C docs}}}, {{{make pdf}}} etc. to generate documentation in docs/user_guide but they fail with: make[2]: * * * No rule to make target 'html_docs/users_guide'. Stop. - tried a freshly built haddock (./inplace/bin/haddock) but havent yet figured out the options; - installed Sphinx for python2 & 3 but but, also, havent yet figured out the options; So, am I on the right track with any of the above? Q: How would you want it to work? A: Triggered by the recent successful GHC CI? Or unsuccessful. Please tell me if you prefer another approach. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): First, I suspect it would be best to build on top of the new Hadrian build system as we are nearly ready to phase-out the `make`-based build system. My vision for this is to upload tarballs containing the built documentation alongside the binary distribution that CI already produces. See `.circleci/config.yml` to see how we binary distribution upload works. The question then is what we do with the tarballs after they have been uploaded. If we just wanted to keep http://downloads.haskell.org/~ghc/latest/doc up-to-date then we could just have a cron job that periodically downloads and extracts the latest tarball. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by gander): Sorry, am caught napping on this. Just noticed an email request to upload the latest documents. So, can I do this manually,for now? -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:5 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): I updated the `~ghc/latest` symlink earlier this week. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: gander Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by bgamari): I have started looking into fixing this on top of GitLab CI (https://gitlab.haskell.org/ghc/ghc/merge_requests/79). -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:7 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#14475: Upload documentation dumps -------------------------------------+------------------------------------- Reporter: bgamari | Owner: (none) Type: task | Status: new Priority: normal | Milestone: Component: Continuous | Version: 8.2.1 Integration | Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: | Unknown/Multiple Type of failure: None/Unknown | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by gander): * owner: gander => (none) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14475#comment:8 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC