#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: (none) Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.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 MikolajKonarski): That's actually an easy, nice, introductory ticket for would-be GHC- contributors, so why waste computing power, when humans can do it almost as well. :) We'd just need to post it once a major release on a page with intro tickets and perhaps advertise the page on some hacker forums. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:2 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: (none) Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers 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 voanhduy1512): Hello, I am new to Haskell (never use in prod) and ghc but i think i can help. I need to follow this process https://ghc.haskell.org/trac/ghc/wiki/WorkingConventions/DocumentationChange... to update the document right? -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528 Wiki Page: | -------------------------------------+------------------------------------- Comment (by Ben Gamari ): In [changeset:"c16df6061abd33c67797b1cd676a980457f52533/ghc" c16df60/ghc]: {{{ #!CommitTicketReference repository="ghc" revision="c16df6061abd33c67797b1cd676a980457f52533" document: fix trac issue #14229 Accroding to https://git.haskell.org/ghc.git/commitdiff/49672659113371c3bee691e6d913d f8e6f60a1d8, `-Wredundant-constraints` is no longer turn on by default. Reviewers: bgamari Reviewed By: bgamari Subscribers: rwbarton, thomie, carter Differential Revision: https://phabricator.haskell.org/D4528 }}} -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528 Wiki Page: | -------------------------------------+------------------------------------- Comment (by voanhduy1512): Replying to [comment:7 bgamari]:

Thanks voanhduy1512! Have you checked whether any of the other issues brought up in this ticket still need fixing?

I think there are other missing doc, likes no mentions about `deferred- type-errors`, `type-holes` ... I will send another patch to address all missing pieces that i can identify. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:8 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528 Wiki Page: | -------------------------------------+------------------------------------- Comment (by MikolajKonarski): Indeed, thank you, voanhduy1512. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:10 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528 Wiki Page: | -------------------------------------+------------------------------------- Comment (by MikolajKonarski): I'm not sure, because many of the new warnings are added with the intention of adding them to -Wall sooner or later, so the positive list would need to grow, too. Also, the list of warnings included in -Wall is much longer than the list of warnings excluded. An option is to provide both lists and remark that if a warning is on neither list, it must be a new one and please file a Trac ticket. Then we are at least not stating a falsehood. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:12 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528, Wiki Page: | Phab:D4562 -------------------------------------+------------------------------------- Comment (by voanhduy1512): Replying to [comment:12 MikolajKonarski]:

I'm not sure, because many of the new warnings are added with the intention of adding them to -Wall sooner or later, so the positive list would need to grow, too. Also, the list of warnings included in -Wall is much longer than the list of warnings excluded. An option is to provide both lists and remark that if a warning is on neither list, it must be a new one and please file a Trac ticket. Then we are at least not stating a falsehood.

I try to build a list status of options here https://gist.github.com/voanhduy1512/7769e04b925069170212400b57f5d4a3. Right now there is more options which excluded in `-Wall` than included. Maybe it will be change in future but i think it's easier to add positive list. For example i add a option to `-Wall` but forgot to update the doc, it's easy to update the doc to correct state just by looking at the code. As for current state, i need to get all options, minus all default options, minus all `-W`, `-Wall`, to get the real list that are not in `-Wall`. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:14 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#14229: Contraditions in users_guide/using-warnings.html -------------------------------------+------------------------------------- Reporter: MikolajKonarski | Owner: voanhduy1512 Type: bug | Status: new Priority: low | Milestone: Component: Documentation | Version: 8.2.1 Resolution: | Keywords: newcomers Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D4528, Wiki Page: | Phab:D4562 -------------------------------------+------------------------------------- Comment (by MikolajKonarski): There is a new comment Phab (I know there were problems with notification emails recently): https://phabricator.haskell.org/D4562#128940 -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/14229#comment:16 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler