GHC issueshttps://gitlab.haskell.org/ghc/ghc/-/issues2019-07-07T19:15:16Zhttps://gitlab.haskell.org/ghc/ghc/-/issues/1098Broken link in the User's Guide2019-07-07T19:15:16Zgn@oglaroon.deBroken link in the User's GuideOn http://www.haskell.org/ghc/docs/latest/html/users_guide/syntax-extns.html\#hierarchical-modules there's a link called "Haskell Libraries" to a nonexistant page: http://www.haskell.org/\~simonmar/libraries/libraries.html
<details><sum...On http://www.haskell.org/ghc/docs/latest/html/users_guide/syntax-extns.html\#hierarchical-modules there's a link called "Haskell Libraries" to a nonexistant page: http://www.haskell.org/\~simonmar/libraries/libraries.html
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | ------------- |
| Version | 6.6 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | low |
| Resolution | Unresolved |
| Component | Documentation |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | Multiple |
| Architecture | Multiple |
</details>
<!-- {"blocked_by":[],"summary":"Broken link in the User's Guide","status":"New","operating_system":"Multiple","component":"Documentation","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.6","keywords":[],"differentials":[],"test_case":"","architecture":"Multiple","cc":[""],"type":"Bug","description":"On http://www.haskell.org/ghc/docs/latest/html/users_guide/syntax-extns.html#hierarchical-modules there's a link called \"Haskell Libraries\" to a nonexistant page: http://www.haskell.org/~simonmar/libraries/libraries.html","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1Simon MarlowSimon Marlowhttps://gitlab.haskell.org/ghc/ghc/-/issues/1082Documentation missing from MacOS PPC binary2019-07-07T19:15:21ZguestDocumentation missing from MacOS PPC binaryThe installation from the MacOS PPC binary distribution works fine but ends with
```
=======================================================================
Installation of ghc-6.6 was successful.
To use, add /usr/local/bin to your PAT...The installation from the MacOS PPC binary distribution works fine but ends with
```
=======================================================================
Installation of ghc-6.6 was successful.
To use, add /usr/local/bin to your PATH.
For documentation, see /usr/local/share/ghc-6.6/html/index.html
=======================================================================
```
However, there is no documentation there, nor does `make html` work. And unfortunately for us who often work offline, there doesn't seem to be a separate download for the documentation.
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | ------------- |
| Version | 6.6 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | normal |
| Resolution | Unresolved |
| Component | Documentation |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | |
| Architecture | |
</details>
<!-- {"blocked_by":[],"summary":"Documentation missing from MacOS PPC binary","status":"New","operating_system":"","component":"Documentation","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.6","keywords":[],"differentials":[],"test_case":"","architecture":"","cc":[""],"type":"Bug","description":"The installation from the MacOS PPC binary distribution works fine but ends with\r\n\r\n{{{\r\n=======================================================================\r\nInstallation of ghc-6.6 was successful.\r\n\r\nTo use, add /usr/local/bin to your PATH.\r\n\r\nFor documentation, see /usr/local/share/ghc-6.6/html/index.html\r\n=======================================================================\r\n\r\n}}}\r\n\r\nHowever, there is no documentation there, nor does {{{make html}}} work. And unfortunately for us who often work offline, there doesn't seem to be a separate download for the documentation.","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1thorkilnaurthorkilnaurhttps://gitlab.haskell.org/ghc/ghc/-/issues/1077documentation error and omission2019-07-07T19:15:23Zguestdocumentation error and omission1. broken link in the building guide
in: http://www.haskell.org/ghc/docs/latest/html/building/sec-build-checks.html
points to: http://www.haskell.org/ghc/docs/latest/set/bug-reporting.html
This is what I see:
```
Not Found
The reque...1. broken link in the building guide
in: http://www.haskell.org/ghc/docs/latest/html/building/sec-build-checks.html
points to: http://www.haskell.org/ghc/docs/latest/set/bug-reporting.html
This is what I see:
```
Not Found
The requested URL /ghc/docs/latest/set/bug-reporting.html was not found on this server.
Apache/2.0.46 (Red Hat) Server at www.haskell.org Port 80
```
1. automake not mentioned in "building and developing GHC".
I think it deserves a mention next to autoconf, here:
http://www.haskell.org/ghc/docs/latest/html/building/sec-pre-supposed.html
I found that running autoreconf fails without it. Here's the output I got before installing automake:
```
micky@cellar:/build/ghc$ autoreconf
Can't exec "aclocal": No such file or directory at /usr/bin/autoreconf line 176.
Use of uninitialized value in pattern match (m//) at /usr/bin/autoreconf line 176.
Can't exec "automake": No such file or directory at /usr/bin/autoreconf line 177.
Use of uninitialized value in pattern match (m//) at /usr/bin/autoreconf line 177.
```
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | ------------- |
| Version | 6.6 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | low |
| Resolution | Unresolved |
| Component | Documentation |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | Multiple |
| Architecture | Unknown |
</details>
<!-- {"blocked_by":[],"summary":"documentation error and omission","status":"New","operating_system":"Multiple","component":"Documentation","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.6","keywords":[],"differentials":[],"test_case":"","architecture":"Unknown","cc":[""],"type":"Bug","description":"1. broken link in the building guide\r\n\r\nin: http://www.haskell.org/ghc/docs/latest/html/building/sec-build-checks.html\r\n\r\npoints to: http://www.haskell.org/ghc/docs/latest/set/bug-reporting.html\r\n\r\nThis is what I see:\r\n\r\n{{{\r\nNot Found\r\n\r\nThe requested URL /ghc/docs/latest/set/bug-reporting.html was not found on this server.\r\nApache/2.0.46 (Red Hat) Server at www.haskell.org Port 80\r\n}}}\r\n\r\n2. automake not mentioned in \"building and developing GHC\".\r\n\r\nI think it deserves a mention next to autoconf, here:\r\n\r\nhttp://www.haskell.org/ghc/docs/latest/html/building/sec-pre-supposed.html\r\n\r\nI found that running autoreconf fails without it. Here's the output I got before installing automake:\r\n\r\n{{{\r\nmicky@cellar:/build/ghc$ autoreconf\r\nCan't exec \"aclocal\": No such file or directory at /usr/bin/autoreconf line 176.\r\nUse of uninitialized value in pattern match (m//) at /usr/bin/autoreconf line 176.\r\nCan't exec \"automake\": No such file or directory at /usr/bin/autoreconf line 177.\r\nUse of uninitialized value in pattern match (m//) at /usr/bin/autoreconf line 177.\r\n}}}","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1Ian Lynagh <igloo@earth.li>Ian Lynagh <igloo@earth.li>https://gitlab.haskell.org/ghc/ghc/-/issues/1044library docs on web have broken link2019-07-07T19:15:32Znewshamlibrary docs on web have broken linkThe source links in the Haskell Hierarchical Libraries pages on the web
points to the wrong place. It's almost correct. For example the
page:
http://www.haskell.org/ghc/docs/latest/html/libraries/mtl/Control-Monad-State.html
has a sourc...The source links in the Haskell Hierarchical Libraries pages on the web
points to the wrong place. It's almost correct. For example the
page:
http://www.haskell.org/ghc/docs/latest/html/libraries/mtl/Control-Monad-State.html
has a source link that points to:
http://darcs.haskell.org/packages/mtl/Control/Monad/State.raw-hs
but the correct link is:
http://darcs.haskell.org/packages/mtl/Control/Monad/State.hs
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | ------------- |
| Version | 6.6 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | normal |
| Resolution | Unresolved |
| Component | Documentation |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | Unknown |
| Architecture | Unknown |
</details>
<!-- {"blocked_by":[],"summary":"library docs on web have broken link","status":"New","operating_system":"Unknown","component":"Documentation","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.6","keywords":[],"differentials":[],"test_case":"","architecture":"Unknown","cc":[""],"type":"Bug","description":"The source links in the Haskell Hierarchical Libraries pages on the web\r\npoints to the wrong place. It's almost correct. For example the\r\npage:\r\n\r\nhttp://www.haskell.org/ghc/docs/latest/html/libraries/mtl/Control-Monad-State.html\r\nhas a source link that points to:\r\nhttp://darcs.haskell.org/packages/mtl/Control/Monad/State.raw-hs\r\nbut the correct link is:\r\nhttp://darcs.haskell.org/packages/mtl/Control/Monad/State.hs","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1Ian Lynagh <igloo@earth.li>Ian Lynagh <igloo@earth.li>https://gitlab.haskell.org/ghc/ghc/-/issues/1014Mangled module name in __stginit_Module symbol2019-07-07T19:15:51ZguestMangled module name in __stginit_Module symbolJust discovered that Module names are mangled in the _ _stginit_\* symbols. Don't know if it should be considered a bug or a feature, but at least I think it should be mentioned at
http://www.haskell.org/ghc/docs/latest/html/users_guide...Just discovered that Module names are mangled in the _ _stginit_\* symbols. Don't know if it should be considered a bug or a feature, but at least I think it should be mentioned at
http://www.haskell.org/ghc/docs/latest/html/users_guide/sec-ffi-ghc.html
It would be a good idea to document as well how the symbol would be transformed.
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | -------------- |
| Version | 6.6 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | normal |
| Resolution | Unresolved |
| Component | Compiler (FFI) |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | Unknown |
| Architecture | Unknown |
</details>
<!-- {"blocked_by":[],"summary":"Mangled module name in __stginit_Module symbol","status":"New","operating_system":"Unknown","component":"Compiler (FFI)","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.6","keywords":[],"differentials":[],"test_case":"","architecture":"Unknown","cc":[""],"type":"Bug","description":"Just discovered that Module names are mangled in the _ _stginit_* symbols. Don't know if it should be considered a bug or a feature, but at least I think it should be mentioned at\r\n\r\nhttp://www.haskell.org/ghc/docs/latest/html/users_guide/sec-ffi-ghc.html\r\n\r\n\r\nIt would be a good idea to document as well how the symbol would be transformed.","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1Ian Lynagh <igloo@earth.li>Ian Lynagh <igloo@earth.li>https://gitlab.haskell.org/ghc/ghc/-/issues/839Generate documentation for built-in types and primitve operations2019-07-07T19:16:40ZSimon Peyton JonesGenerate documentation for built-in types and primitve operationsGHC has a bunch of primitive types, which are not definable in Haskell, such as
- Int\#, Float\#, Double\# etc
- ByteArray\#
- etc
They are defined in `TysPrim` but nowhere documented.
GHC also has a handful of built-in functions, tha...GHC has a bunch of primitive types, which are not definable in Haskell, such as
- Int\#, Float\#, Double\# etc
- ByteArray\#
- etc
They are defined in `TysPrim` but nowhere documented.
GHC also has a handful of built-in functions, that are
- Not primops
- Are not definable in Haskell
- But are definable in Core
- Are defined in the compiler itself, in basicTypes/MkId.lhs
- Come from the pseudo-module `GHC.Prim`, like primops and primitive types.
The examples I can think of are
- unsafeCoerce
- inline
- lazy
Currently they are documented in the [(HEAD) user manual](http://www.haskell.org/ghc/dist/current/docs/users_guide/special-ids.html).
However, **both the primitive types, and these built-in functions, are invisible to Haddock**, and hence do not appear in the online Haddock documentation. This is bad.
You might think that the same would be true of the primitive operations (primops). However, the primops are described by a text file `prelude/primops.txt.pp}}, and there's a preprocessor ({{{utils/genprimopcode`) that generates the base-package pseudo-module `GHC/Prim.hs` from the text file. This pseudo-module is not compiled; but it *is* given to Haddock, and that's how the primops appear in the Haddock docs.
So the task is to add a bit of extra markup syntax to `primops.txt.pp` so that it can describe these special built-in types and functions, and inject their type signatures and documentation into `GHC/Prim.hs`, so that Haddock can see it. Not a huge task.
Thanks to Neil Mitchell for pointing out the difficulty.6.6.1Ian Lynagh <igloo@earth.li>Ian Lynagh <igloo@earth.li>https://gitlab.haskell.org/ghc/ghc/-/issues/744ghc-pkg lies about location of haddock-interfaces and haddock-html2019-07-07T19:17:10Zavatar@hot.eeghc-pkg lies about location of haddock-interfaces and haddock-htmlI installed ghc from ghc-6.4.1-1.i386.rpm. This places the haddock interfaces and haddock-documenation into /usr/share/doc/ghc-6.4.1/libraries. However
> ghc-pkg field base haddock-interfaces
/usr/share/ghc-6.4.1/html/libraries/base/b...I installed ghc from ghc-6.4.1-1.i386.rpm. This places the haddock interfaces and haddock-documenation into /usr/share/doc/ghc-6.4.1/libraries. However
> ghc-pkg field base haddock-interfaces
/usr/share/ghc-6.4.1/html/libraries/base/base.haddock
> which is wrong. (had to modify package.conf by hand)
Cheers,
> Misha
Additional info:
SuSE 10
\> uname -a
Linux avatar 2.6.13-15.8-default #1 Tue Feb 7 11:07:24 UTC 2006 i686 i686 i386 GNU/Linux
> \> ghc -v
Glasgow Haskell Compiler, Version 6.4.1, for Haskell 98, compiled by GHC version 6.4.1
Using package config file: /usr/lib/ghc-6.4.1/package.conf
Using package config file: /home/avatar/.ghc/i386-linux-6.4.1/package.conf
Hsc static flags: -static
<details><summary>Trac metadata</summary>
| Trac field | Value |
| ---------------------- | ------------- |
| Version | 6.4.1 |
| Type | Bug |
| TypeOfFailure | OtherFailure |
| Priority | normal |
| Resolution | Unresolved |
| Component | Documentation |
| Test case | |
| Differential revisions | |
| BlockedBy | |
| Related | |
| Blocking | |
| CC | |
| Operating system | |
| Architecture | x86 |
</details>
<!-- {"blocked_by":[],"summary":"ghc-pkg lies about location of haddock-interfaces and haddock-html","status":"New","operating_system":"","component":"Documentation","related":[],"milestone":"","resolution":"Unresolved","owner":{"tag":"Unowned"},"version":"6.4.1","keywords":[],"differentials":[],"test_case":"","architecture":"x86","cc":[""],"type":"Bug","description":"I installed ghc from ghc-6.4.1-1.i386.rpm. This places the haddock interfaces and haddock-documenation into /usr/share/doc/ghc-6.4.1/libraries. However\r\n\r\n> ghc-pkg field base haddock-interfaces\r\n /usr/share/ghc-6.4.1/html/libraries/base/base.haddock\r\n\r\n which is wrong. (had to modify package.conf by hand)\r\n\r\nCheers,\r\n Misha\r\n\r\nAdditional info:\r\n SuSE 10\r\n > uname -a\r\n Linux avatar 2.6.13-15.8-default #1 Tue Feb 7 11:07:24 UTC 2006 i686 i686 i386 GNU/Linux\r\n > ghc -v\r\nGlasgow Haskell Compiler, Version 6.4.1, for Haskell 98, compiled by GHC version 6.4.1\r\nUsing package config file: /usr/lib/ghc-6.4.1/package.conf\r\nUsing package config file: /home/avatar/.ghc/i386-linux-6.4.1/package.conf\r\nHsc static flags: -static","type_of_failure":"OtherFailure","blocking":[]} -->6.6.1pannepanne