[GHC] #9665: Add "since" information to LANGUAGE extensions in GHC user guide
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: Type: task | Status: new Priority: high | Milestone: Component: Documentation | Version: 7.9 Keywords: | Operating System: Architecture: Unknown/Multiple | Unknown/Multiple Difficulty: Unknown | Type of failure: Blocked By: | None/Unknown Related Tickets: | Test Case: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- If one wants to support older versions of GHC, it is hard to find out whether one can use a certain LANGUAGE extension. One has to go to older versions of the GHC manual to find out whether the corresponding documentation was already there, or browse release notes. Requests: 1. Document for new LANGUAGE extensions that they are available since version 7.10. For example, by adding "(Since GHC 7.10)" to the heading of the new feature. 2. Do this also for the previous LANGUAGE extensions, by adding e.g., "(Since GHC 7.6)" etc. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: | Owner: andreas.abel | Status: new Type: task | Milestone: Priority: high | Version: 7.9 Component: | Keywords: Documentation | Architecture: Unknown/Multiple Resolution: | Difficulty: Unknown Operating System: | Blocked By: Unknown/Multiple | Related Tickets: Type of failure: | None/Unknown | Test Case: | Blocking: | Differential Revisions: | -------------------------------------+------------------------------------- Comment (by hvr): This reminded me I had that information in a text file for personal reference, I've placed it in LanguagePragmaHistory for everyone to see, which I guess may be helpful to whoever implements this task -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: | Owner: andreas.abel | Status: new Type: task | Milestone: Priority: high | Version: 7.9 Component: | Keywords: Documentation | Architecture: Unknown/Multiple Resolution: | Difficulty: Unknown Operating System: | Blocked By: Unknown/Multiple | Related Tickets: Type of failure: | None/Unknown | Test Case: | Blocking: | Differential Revisions: | -------------------------------------+------------------------------------- Comment (by simonpj): I'm all for it. Can someone submit a doc patch? I strongly suggest implementing it as an extra column in the (allegedly-comprehensive) [http://www.haskell.org/ghc/docs/latest/html/users_guide/flag- reference.html#idp14238080 listing of all extensions], currently section 4.20.12. Simon -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- Changes (by thomie): * keywords: => newcomer * priority: high => normal Comment: The file to change is `docs/users_guide/flags.xml`. Bonus: you'll learn something about all the language extensions GHC offers. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- Changes (by rasen): * owner: => rasen -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- Comment (by goldfire): Thanks, @rasen, for taking this on! It might also be helpful in your work to note major changes made to extensions, such as the fact that 7.8's `TypeFamilies` includes closed type families, while previously the extension worked only for open ones. (There was actually some debate at the time about whether we should create a new extension.) Tracking these changes may be challenging, though -- don't let this request hold you up from getting a baseline "since x.x.x" working. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:5 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- Comment (by rasen): For now, I'm more worried about changes that were not documented on time. For example, I know `TupleSections` and `PatternSynonyms` work on 7.8.4 but were first documented in 7.10.1. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: Phab:D1019 -------------------------------------+------------------------------------- Changes (by rasen): * differential: => Phab:D1019 -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:7 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: Phab:D1019 -------------------------------------+------------------------------------- Comment (by andreas.abel): We@agda have been using TupleSections with ghc 7.0, they must be at least that old... -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:8 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: Phab:D1019 -------------------------------------+------------------------------------- Comment (by hvr): Fyi, the list in LanguagePragmaHistory is complete; so everything that 7.10 supports but isn't mentioned in the list has been supported since before 7.0 I didn't include the list of pragmas supported in 6.12, but here is the output of `ghc-6.12 --supported-languages`: https://gist.github.com/anonymous/5b28a41345e0a59644c2 -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:9 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#9665: Add "since" information to LANGUAGE extensions in GHC user guide
-------------------------------------+-------------------------------------
Reporter: andreas.abel | Owner: rasen
Type: task | Status: new
Priority: normal | Milestone:
Component: Documentation | Version: 7.9
Resolution: | Keywords: newcomer
Operating System: Unknown/Multiple | Architecture:
Type of failure: None/Unknown | Unknown/Multiple
Blocked By: | Test Case:
Related Tickets: | Blocking:
| Differential Revisions: Phab:D1019
-------------------------------------+-------------------------------------
Comment (by Ben Gamari
#9665: Add "since" information to LANGUAGE extensions in GHC user guide -------------------------------------+------------------------------------- Reporter: andreas.abel | Owner: rasen Type: task | Status: closed Priority: normal | Milestone: Component: Documentation | Version: 7.9 Resolution: fixed | Keywords: newcomer Operating System: Unknown/Multiple | Architecture: Type of failure: None/Unknown | Unknown/Multiple Blocked By: | Test Case: Related Tickets: | Blocking: | Differential Revisions: Phab:D1019 -------------------------------------+------------------------------------- Changes (by bgamari): * status: new => closed * resolution: => fixed -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9665#comment:11 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC