[GHC] #12404: Document version availability for each language extension
#12404: Document version availability for each language extension -------------------------------------+------------------------------------- Reporter: dfeuer | Owner: Type: feature | Status: new request | Priority: normal | Milestone: 8.2.1 Component: Documentation | Version: 8.0.1 Keywords: | Operating System: Unknown/Multiple Architecture: | Type of failure: Documentation Unknown/Multiple | bug Test Case: | Blocked By: Blocking: | Related Tickets: Differential Rev(s): | Wiki Page: -------------------------------------+------------------------------------- A certain amount of "historical" information about language extensions is of sufficient practical utility to deserve a place in the GHC documentation. I believe that the documentation for each language extension should include 1. The GHC version in which it first appeared. 2. Any major changes that have been made to the extension since the previous major-major version. For example, the GHC 8.x.x documentation for any given language extension should include any major changes to it since 7.0.1. At present, the only way I see to get this information is to dig through previous versions of the documentation and change logs, which is rather inefficient. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12404 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12404: Document version availability for each language extension -------------------------------------+------------------------------------- Reporter: dfeuer | Owner: Type: feature request | Status: new Priority: normal | Milestone: 8.2.1 Component: Documentation | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by thomie): Fwiw, there is [wiki:LanguagePragmaHistory]. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12404#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12404: Document version availability for each language extension -------------------------------------+------------------------------------- Reporter: dfeuer | Owner: Type: feature request | Status: new Priority: normal | Milestone: 8.2.1 Component: Documentation | Version: 8.0.1 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Comment (by dfeuer): Replying to [comment:1 thomie]:
Fwiw, there is [wiki:LanguagePragmaHistory].
Imitation is the sincerest form of flattery. I think this is something that belongs in the GHC documentation proper. And that list does not (yet) include many details on changes made to the extensions from version to version. There have been some wobbles around `PolyKinds`, for example, although I don't know the details, and several changes to `PatternSynonyms` from 7.8 to 8.0. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12404#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#12404: Document version availability for each language extension -------------------------------------+------------------------------------- Reporter: dfeuer | Owner: Type: feature request | Status: closed Priority: normal | Milestone: 8.2.1 Component: Documentation | Version: 8.0.1 Resolution: fixed | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * status: new => closed * resolution: => fixed Comment: As of eb8bc4dadb767729ae267db7ec7d3bee29f48463 the users guide will include `since` annotations on nearly all language extension flags. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/12404#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC