Re: documentation links broken in 7.10.1
Hi Evan, This was due to bug #10206 - https://ghc.haskell.org/trac/ghc/ticket/10206 It should already be fixed in the STABLE branch and will be part of 7.10.2. On Thu, May 21, 2015 at 12:49 PM, Evan Laforge qdun...@gmail.com wrote: It seems like haddock's index.html generation is broken in 7.10.1. Namely, it creates links to e.g. Codec-Binary-UTF8-Generic.html when it should be to utf8-string-1/html/Codec-Binary-UTF8-Generic.html This is haddock 2.16.0, which comes with the binary distribution for 7.10.1. I looked at https://github.com/haskell/haddock/issues but didn't see anything related to this, which makes me think it's just me. You'd think someone would notice if all documentation links were broken. Does anyone else see this? ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/glasgow-haskell-users -- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/ ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/glasgow-haskell-users
Re: documentation links broken in 7.10.1
Glad to hear. I guess I should have tested the release candidate. Next time I will! On Thu, May 21, 2015 at 2:30 PM, Austin Seipp aus...@well-typed.com wrote: Hi Evan, This was due to bug #10206 - https://ghc.haskell.org/trac/ghc/ticket/10206 It should already be fixed in the STABLE branch and will be part of 7.10.2. On Thu, May 21, 2015 at 12:49 PM, Evan Laforge qdun...@gmail.com wrote: It seems like haddock's index.html generation is broken in 7.10.1. Namely, it creates links to e.g. Codec-Binary-UTF8-Generic.html when it should be to utf8-string-1/html/Codec-Binary-UTF8-Generic.html This is haddock 2.16.0, which comes with the binary distribution for 7.10.1. I looked at https://github.com/haskell/haddock/issues but didn't see anything related to this, which makes me think it's just me. You'd think someone would notice if all documentation links were broken. Does anyone else see this? ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/glasgow-haskell-users -- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/ ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/glasgow-haskell-users
Re: Documentation build failure
On Sun, Mar 06, 2011 at 01:05:12AM +, Ian Lynagh wrote:
On Sat, Mar 05, 2011 at 01:20:03PM +0100, Malte Sommerkorn wrote:
Building the ps/pdf documentation works only with a specific, outdated
version of dblatex
I've just won a battle with dblatex to get the docs built on OS X. If
you're having problems then the attached may be of help.
Thanks
Ian
From http://www.tug.org/mactex/ downloaded and installed
http://mirror.ctan.org/systems/mac/mactex/MacTeX.mpkg.zip
From http://dblatex.sourceforge.net/ downloaded and built
http://prdownloads.sourceforge.net/dblatex/dblatex-0.3.tar.bz2?download
Now building users_guide.pdf will fail, as we generate things like:
ͱt\nolinkurl{ͰuC:\Documentsͱu}\texttt{\ }\nolin[...]
rather than:
ͱt\nolinkurl{ͰuC:\\Documentsͱu}\texttt{\ }\nolin[...]
(note number of backslashes). To fix this, patch param.xsl:
--- param.xsl 2011-03-18 18:10:23.0 +
+++ /usr/share/dblatex/xsl/param.xsl2010-10-27 08:56:16.0 +0100
@@ -16,7 +16,7 @@
xsl:param name=latex.class.articlearticle/xsl:param
xsl:param name=latex.class.bookreport/xsl:param
xsl:param name=latex.unicode.use0/xsl:param
-xsl:param name=texlive.version2010/xsl:param
+xsl:param name=texlive.version2009/xsl:param
This is a little odd. The Debian package has this patch applied, and on
Debian:
$ latex --version
pdfTeX 3.1415926-1.40.10-2.2 (TeX Live 2009/Debian)
[...]
but on OS X:
$ latex --version
pdfTeX 3.1415926-1.40.11-2.2 (TeX Live 2010)
[...]
so it doesn't seem like it should be needed. But anyway...
Now the PDF will fail to build with:
makeindex: Not writing to /private/tmp/tmpw4xTzV/users_guide.ind
(openout_any = p).
Can't create output index file /private/tmp/tmpw4xTzV/users_guide.ind.
So we put
openout_any = r
in /usr/local/texlive/2010/texmf.cnf
And the docs will finally build!
___
Glasgow-haskell-users mailing list
Glasgow-haskell-users@haskell.org
http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Documentation build failure
On Sat, Mar 05, 2011 at 11:27:40AM +0100, Daniel Fischer wrote: make-ing 7.0.2 failed with: -- everything fine up to here, users guide html okay Build users_guide.ps This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/openSUSE) entering extended mode latex failed users_guide_tmp.tex:1631: Undefined control sequence \Documents. users_guide_tmp.tex:1631: leading text: } Building the ps/pdf documentation works only with a specific, outdated version of dblatex (Simon will probably tell you which one). Trying to build with a different dblatex installed exhibits the error you encountered above. The error occurs everywhere where Windows-style pathnames are used; the backslashes end up raw in the tex. I'm not sure either if a fix should go into dblatex, the user's guide, or the build system. ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Documentation build failure
On Sat, Mar 05, 2011 at 11:27:40AM +0100, Daniel Fischer wrote: $ dblatex --version /usr/lib/python2.6/site-packages/dbtexmf/dblatex/grubber/util.py:8: DeprecationWarning: the md5 module is deprecated; use hashlib instead import md5 dblatex version 0.2.7 I don't know if this is the problem, but I have $ dblatex --version dblatex version 0.3-2 Debian's previous stable release had 0.2.9, so that's probably fine too. $ make docs/users_guide/users_guide.ps ===--- building phase 0 make -r --no-print-directory -f ghc.mk phase=0 phase_0_builds make[1]: Nothing to be done for `phase_0_builds'. ===--- building phase 1 make -r --no-print-directory -f ghc.mk phase=1 phase_1_builds make[1]: Nothing to be done for `phase_1_builds'. ===--- building final phase make -r --no-print-directory -f ghc.mk phase=final docs/users_guide/users_guide.ps /usr/bin/dblatex docs/users_guide/users_guide.xml --ps -o docs/users_guide/users_guide.ps Build the book set list... Build the listings... XSLT stylesheets DocBook - LaTeX 2e (0.3-2) === subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen Pixel unit not handled (replaced by pt) Pixel unit not handled (replaced by pt) subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen subscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen superscript: default template used in programlisting or screen Found eps for 'prof_scc' Build users_guide.ps This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) restricted \write18 enabled. entering extended mode processing index /tmp/tmp2gpTyl/users_guide.idx... This is makeindex, version 2.15 [TeX Live 2009] (kpathsea + Thai support). Scanning style file /usr/share/dblatex/latex/scripts/doc.istdone (4 attributes redefined, 0 ignored). Scanning input file /tmp/tmp2gpTyl/users_guide.idxdone (779 entries accepted, 0 rejected). Sorting entries.done (7976 comparisons). Generating output file /tmp/tmp2gpTyl/users_guide.inddone (902 lines written, 0 warnings). Output written in /tmp/tmp2gpTyl/users_guide.ind. Transcript written in /tmp/tmp2gpTyl/users_guide.ilg. This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) restricted \write18 enabled. entering extended mode This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) restricted \write18 enabled. entering extended mode running dvips on /tmp/tmp2gpTyl/users_guide.dvi... This is dvips(k) 5.98 Copyright 2009 Radical Eye Software (www.radicaleye.com) ' TeX output 2011.03.06:0100' - /tmp/tmp2gpTyl/users_guide.ps /usr/share/texmf-texlive/dvips/base/tex.pro /usr/share/texmf-texlive/fonts/enc/dvips/base/8r.enc /usr/share/texmf-texlive/dvips/base/texps.pro /usr/share/texmf-texlive/dvips/base/special.pro /usr/share/texmf-texlive/dvips/base/color.pro. /usr/share/texmf-texlive/fonts/type1/public/amsfonts/symbols/msam10.pfb /usr/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb /usr/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi10.pfb[1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38] [39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] [95] [96] [97] [98] [99] [100] [101] [102] [103] [104] [105] [106]
Re: Documentation build failure
On Sat, Mar 05, 2011 at 01:20:03PM +0100, Malte Sommerkorn wrote: Building the ps/pdf documentation works only with a specific, outdated version of dblatex I don't think that's true, but IIRC miktex includes a completely different program, also called dblatex, which doesn't do what we want. Thanks Ian ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Documentation build failure
On Sunday 06 March 2011 02:03:12, Ian Lynagh wrote: On Sat, Mar 05, 2011 at 11:27:40AM +0100, Daniel Fischer wrote: $ dblatex --version /usr/lib/python2.6/site-packages/dbtexmf/dblatex/grubber/util.py:8: DeprecationWarning: the md5 module is deprecated; use hashlib instead import md5 dblatex version 0.2.7 I don't know if this is the problem, but I have $ dblatex --version dblatex version 0.3-2 Debian's previous stable release had 0.2.9, so that's probably fine too. That seems to be the problem, after installing dblatex-0.3-1.2: $ make docs/users_guide/users_guide.ps ===--- updating makefiles phase 0 make -r --no-print-directory -f ghc.mk phase=0 just-makefiles snip [242] [243] [244] [245] [246] 'users_guide.ps' successfully built [ -f docs/users_guide/users_guide.ps ] Check for dblatex = 0.2.9 in configure? ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: Documentation of System.Process
Hi Simon, thanks for the clarification. Regards, Jean Simon Marlow marlo...@gmail.com writes: On 26/11/2010 10:00, Jean-Marie Gaillourdet wrote: Hi all, I've been searching information regarding file handles to pipes created by System.Process.createProcess. The documentation does not state whether they are in binary mode, i.e. whether they have line ending conversion or an encoding enabled. That kind of information is available for runInteractiveCommand in the same module. runInteractiveCommand opens all pipes in binary mode. I've concluded from the source of that module that the same is probably true for createProcess. I've two questions now: 1. Is it correct that createProcess returns file handles in binary mode when creating pipes? No, in fact the Handles use localeEncoding and nativeNewlineMode by default. You can use hSetBinaryMode if you want no encoding or newline translation. 2. Could you add that information to the haddock docs? Yes. Is their some other place where I could have found this? The source :-) Cheers, Simon ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
Re: documentation of -M option insufficient
On Tue, Mar 13, 2007 at 02:37:09PM +0100, Marc Weber wrote: The description of the -M option looks like this: -M Generate dependency information suitable for use in a Makefile. (copied from http://www.haskell.org/ghc/docs/latest/html/users_guide/flag-reference.html#id3152912) It should contain the hint that it writes this information to a Makefile. I'm thinking of something like -M writes dependency information suitable for use in a Makefile into the Makefile Simon Warlow: -M is well documented: http://www.haskell.org/ghc/docs/latest/html/users_guide/separate-compilation.html#sec-makefile-depe +ndencies The section of the documentation you're referring to is just the summary (and the summary links to +the full docs). Simon Peyton-Jones: So it is. I'll just add a helpful cross-ref. Arguably redundant if you follow the link to Section +4.4, but nevertheless helpful. Simon I agree. After following 2 links I might get the information that the result is written to a Makefile. Thanks Simon. The reason why I've missed the link is because I did use find as you type of firefox. The link was not on screen then. I was confused because ghc -M did return exit code 0, no message, no output to stdout (like cpp -M switch). I did not try a ls (which wouldn't have helped much because I already had a Makefile in that directory) Marc ___ Glasgow-haskell-users mailing list Glasgow-haskell-users@haskell.org http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
RE: Documentation
That does not work. make answers make: *** No rule to make target `set'. Any ideas? Do I have to take special actions when configuring? Simon meant "make html" and "make ps". "make set.html" and "make set.ps" also work, I think. -- http://sc3d.org/rrt/ | free, a. already paid for (Peyton Jones) ___ Glasgow-haskell-users mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
RE: Documentation
Yup, you have to explicitly ask for the documentation. Go to ghc/docs/set, and type 'make set'. The full documentation (combined Users' Guide and Library reference) will end up in set/ after a while. That does not work. make answers make: *** No rule to make target `set'. Any ideas? Do I have to take special actions when configuring? oops, sorry I meant 'make html'. You can also do 'make dvi', 'make ps', 'make pdf' etc. Cheers, Simon ___ Glasgow-haskell-users mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
RE: Documentation
Dear all, I just successfully installed GHC 4.08.1 and Happy 1.9 from source under SuSE linux. However, it seems that the doumentation is not generated. Do I have to take special actions (NB configure seems to be satisfied with the DocBook installation)? Yup, you have to explicitly ask for the documentation. Go to ghc/docs/set, and type 'make set'. The full documentation (combined Users' Guide and Library reference) will end up in set/ after a while. Cheers, Simon ___ Glasgow-haskell-users mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
RE: Documentation
Yup, you have to explicitly ask for the documentation. Go to ghc/docs/set, and type 'make set'. The full documentation (combined Users' Guide and Library reference) will end up in set/ after a while. That does not work. make answers make: *** No rule to make target `set'. Any ideas? Do I have to take special actions when configuring? Ralf ___ Glasgow-haskell-users mailing list [EMAIL PROTECTED] http://www.haskell.org/mailman/listinfo/glasgow-haskell-users
