Sphinx on Windows

[Simon Peyton Jones]

Thanks.

But it's a bit inefficient to debug by email.  For now I've simply switched off the sphinx stuff in my build.mk.  Might you work it through when you have access to a machine, and document the result?

If the desired sequence is to
  * get pip
  * use pip to get sphinx

then could the docs on https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation/Windows
be update to say precisely that?  Someone went to some trouble to make that page short and easy, and perhaps there is a more direct route. I'm not sure.  

Many thanks

Simon

|  -----Original Message-----
|  From: David Kraeutmann [mailto:kane at kane.cx]
|  Sent: 26 October 2015 10:01
|  To: Simon Peyton Jones
|  Cc: ghc-devs at haskell.org
|  Subject: Re: Sphinx on Windows
|  
|  Grab
|  https://na01.safelinks.protection.outlook.com/?url=https%3a%2f%2fbootstrap.p
|  ypa.io%2fget-
|  pip.py&data=01%7c01%7csimonpj%40064d.mgd.microsoft.com%7c2143737483a740eb651
|  308d2ddec5e3d%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=YnlD5KrF3LBjq2ys8
|  M4ZSsv26Qgrwo7WdYYaUh2sNiU%3d and do `python
|  https://na01.safelinks.protection.outlook.com/?url=get-
|  pip.py&data=01%7c01%7csimonpj%40064d.mgd.microsoft.com%7c2143737483a740eb651
|  308d2ddec5e3d%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=2DVk4wuIWO9bYpS7Y
|  XBuInrDI9jER9ETucrMnvvPjEA%3d'
|  from a command prompt (might need to be elevated, not sure). After that
|  'pip' should be available and you can do 'pip install sphinx'.
|  
|  On Mon, Oct 26, 2015 at 10:41 AM, Simon Peyton Jones <simonpj at microsoft.com>
|  wrote:
|  > I have not tried that.  But 'pip' gives "command not found".
|  >
|  > Maybe I need something in my path?  I appear to have python 2.7.5
|  installed; it does not appear to have pip.exe.
|  >
|  > Simon
|  >
|  > |  -----Original Message-----
|  > |  From: David Kraeutmann [mailto:kane at kane.cx]
|  > |  Sent: 26 October 2015 08:32
|  > |  To: Simon Peyton Jones
|  > |  Cc: ghc-devs at haskell.org
|  > |  Subject: Re: Sphinx on Windows
|  > |
|  > |  'pip' is just a Python package manager. Following the steps at
|  > |
|  > | https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fsphi
|  > | nx-
|  > |  doc.org%2flatest%2finstall.html%23windows-install-python-and-
|  > |
|  > | sphinx&data=01%7c01%7csimonpj%40064d.mgd.microsoft.com%7c865e98e064e
|  > | e4e54daa
|  > | d08d2dddff6dd%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=TtHa5dAl%
|  > | 2fEASoNW
|  > |  kXJDQ0Om6ilkxRguR%2bpBrZP19ujc%3d
|  > |  should give you a working sphinx install. I can test those on my
|  > | Windows  machine once I'm home, but that won't be for a few hours.
|  > |
|  > |  On Mon, Oct 26, 2015 at 8:59 AM, Simon Peyton Jones
|  > | <simonpj at microsoft.com>
|  > |  wrote:
|  > |  > The GHC wiki says you need Sphinx to build docs,  >  >  >
|  > | https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation/Tools
|  > |  >
|  > |  > and refers to the Preparation doc for how to install Sphinx  >  >
|  > | https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation
|  > |  >
|  > |  > But the Windows sub-page of Preparation does not say how to
|  > | install  Sphinx.
|  > |  >
|  > |  > Question: how does one install Sphinx on Windows?  The sphinx-doc
|  > | home  > page mutters about ‘pip’, but I’ve never used that.  Does
|  > | anyone have  > instructions?
|  > |  >
|  > |  > Thanks
|  > |  >
|  > |  > Simon
|  > |  >
|  > |  >
|  > |  > _______________________________________________
|  > |  > ghc-devs mailing list
|  > |  > ghc-devs at haskell.org
|  > |  >
|  > | https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fmail
|  > | .h  > askell.org%2fcgi-bin%2fmailman%2flistinfo%2fghc-
|  > |
|  > | devs&data=01%7c01%7csimonpj%40064d.mgd.microsoft.com%7c865e98e064ee4
|  > | e54daad0
|  > | 8d2dddff6dd%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=zUsjfvEKGbI
|  > | jR%2b9QP
|  > |  InIXPKB7P%2bt2zXcPxLPvHlzWNs%3d
|  > |  >