[GHC] #14475: Upload documentation dumps

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

[GHC] #14475: Upload documentation dumps

GHC - devs mailing list
#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

_______________________________________________
ghc-tickets mailing list
[hidden email]
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #14475: Upload documentation dumps

GHC - devs mailing list
#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

_______________________________________________
ghc-tickets mailing list
[hidden email]
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #14475: Upload documentation dumps

GHC - devs mailing list
In reply to this post by GHC - devs mailing list
#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

_______________________________________________
ghc-tickets mailing list
[hidden email]
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #14475: Upload documentation dumps

GHC - devs mailing list
In reply to this post by GHC - devs mailing list
#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

_______________________________________________
ghc-tickets mailing list
[hidden email]
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #14475: Upload documentation dumps

GHC - devs mailing list
In reply to this post by GHC - devs mailing list
#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

_______________________________________________
ghc-tickets mailing list
[hidden email]
http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-tickets