#2518: hard-to-find .hs-boot docs
------------------------------+---------------------------------------------
    Reporter:  Isaac Dupree   |        Owner:         
        Type:  bug            |       Status:  new    
    Priority:  normal         |    Milestone:         
   Component:  Documentation  |      Version:  6.8.3  
    Severity:  normal         |   Resolution:         
    Keywords:                 |     Testcase:         
Architecture:  Unknown        |           Os:  Unknown
------------------------------+---------------------------------------------
Comment (by Isaac Dupree):

 Well, I don't think that .hs-boot files are information that "imported
 modules contain", because it's in a separate file, which is a nuisance to
 me in practice.  And there's no inherent reason that `ghc --make` has to
 use separate compilation, so it's not completely obvious that that
 paragraph -as written- should apply.  But I don't think the details matter
 so much as that the documentation should point out in that location what's
 going on, because users regularly get confused about it.  If it really
 doesn't even count as an infelicity, then it should go in the "undefined
 behavior in Haskell 98" section of that page,
 <http://www.haskell.org/ghc/docs/latest/html/users_guide/bugs-and-
 infelicities.html#haskell98-undefined>, a section that unfortunately is
 harder to read due to the lack of sub-headings in the table of contents.

-- 
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/2518#comment:2>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler
_______________________________________________
Glasgow-haskell-bugs mailing list
[email protected]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs

Reply via email to