Andreas Klebinger pushed to branch wip/andreask/since_docs at Glasgow Haskell Compiler / GHC Commits: 699deef5 by Andreas Klebinger at 2025-07-16T11:20:32+02:00 Add since tag and more docs for do-clever-arg-eta-expansion Fixes #26113 - - - - - cc4a8163 by Andreas Klebinger at 2025-07-16T11:20:51+02:00 Add since tag for -fexpose-overloaded-unfoldings Fixes #26112 - - - - - 1 changed file: - docs/users_guide/using-optimisation.rst Changes: ===================================== docs/users_guide/using-optimisation.rst ===================================== @@ -547,16 +547,24 @@ as such you shouldn't need to set any of them explicitly. A flag Eta-expand let-bindings to increase their arity. .. ghc-flag:: -fdo-clever-arg-eta-expansion - :shortdesc: Enable sophisticated argument eta-expansion. Implied by :ghc-flag:`-O2`. + :shortdesc: Enable sophisticated argument eta-expansion. Implied by :ghc-flag:`-O`. :type: dynamic :reverse: -fno-do-clever-arg-eta-expansion :category: :default: off + :since: 9.10.1 Eta-expand arguments to increase their arity to avoid allocating unnecessary thunks for them. + For example in code like `foo = f (g x)` this flag will determine which analysis + is used to decide the arity of `g x`, with the goal of avoiding a thunk for `g x` + in cases where `g` is a function with an arity higher than one. + + Enabling the flag enables a more sophisticated analysis, resulting in better + runtime but longer compile time. + .. ghc-flag:: -feager-blackholing :shortdesc: Turn on :ref:`eager blackholing <parallel-compile-options>` :type: dynamic @@ -617,6 +625,7 @@ as such you shouldn't need to set any of them explicitly. A flag :category: :default: off + :since: 9.12.1 This experimental flag is a slightly less heavy weight alternative to :ghc-flag:`-fexpose-all-unfoldings`. View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/compare/58721dd46fbf04c945f10ac794a4e99... -- View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/compare/58721dd46fbf04c945f10ac794a4e99... You're receiving this email because of your account on gitlab.haskell.org.