[GHC] #8253: example "Core syntax" is ancient
#8253: example "Core syntax" is ancient -------------------------------------+------------------------------------- Reporter: rwbarton | Owner: Type: bug | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.6.3 Keywords: | Operating System: Unknown/Multiple Architecture: Unknown/Multiple | Type of failure: Documentation Difficulty: Easy (less than 1 | bug hour) | Test Case: Blocked By: | Blocking: Related Tickets: | -------------------------------------+------------------------------------- [http://www.haskell.org/ghc/docs/7.6.3/html/users_guide/options- debugging.html#idp39365504 User's guide section 4.19.5] has some funky "Core syntax" that (according to git blame) dates back to at least 2000, and probably longer ago than that. It could use an update. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/8253 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#8253: example "Core syntax" is ancient -------------------------------------+------------------------------------- Reporter: rwbarton | Owner: Type: bug | Status: new Priority: normal | Milestone: Component: Documentation | Version: 7.6.3 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Unknown/Multiple Type of failure: Documentation | Difficulty: Easy (less than 1 bug | hour) Test Case: | Blocked By: Blocking: | Related Tickets: -------------------------------------+------------------------------------- Comment (by afleck): Wow, that's very different, the same comments don't even apply. Is it necessary to re-comment the code? I've attached a log of the output. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/8253#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#8253: example "Core syntax" is ancient -------------------------------------+------------------------------------- Reporter: rwbarton | Owner: Type: bug | Status: new Priority: normal | Milestone: Component: | Version: 7.6.3 Documentation | Keywords: Resolution: | Architecture: Unknown/Multiple Operating System: | Difficulty: Easy (less than 1 Unknown/Multiple | hour) Type of failure: | Blocked By: Documentation bug | Related Tickets: Test Case: | Blocking: | Differential Revisions: | -------------------------------------+------------------------------------- Comment (by thomie): Replying to [comment:1 afleck]:
Wow, that's very different, the same comments don't even apply. Is it necessary to re-comment the code?
I've attached a log of the output.
If you understand that output, could you indeed add some comments. Then we can update the documentation and close this ticket. The current version is not very helpful. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/8253#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
#8253: example "Core syntax" is ancient -------------------------------------+------------------------------------- Reporter: rwbarton | Owner: Type: bug | Status: closed Priority: normal | Milestone: Component: Documentation | Version: 7.6.3 Resolution: fixed | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Revisions: -------------------------------------+------------------------------------- Changes (by thomie): * status: new => closed * resolution: => fixed Comment: In commit a66e1ba60d9be67dda2a57a71bde96bc6f8dc5f0: {{{ Author: Thomas Miedema <> Date: Fri Jul 31 17:15:10 2015 +0200 User's guide: delete ancient "Core syntax" example }}} There are resources online to learn how to read GHC Core, such as: * http://stackoverflow.com/questions/6121146/reading-ghc-core * http://blog.ezyang.com/2011/04/tracing-the-compilation-of-hello- factorial/ If someone feels like contributing a new section on Core to the User's guide, they are of course free to do so. The section I just deleted wasn't doing any good. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/8253#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC