#15773: User Guide contains erroneous information about `-rtsopts` modes. -------------------------------------+------------------------------------- Reporter: _recursion | Owner: (none) Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: Resolution: | Keywords: User Guide Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- Description changed by _recursion: Old description:

Currently the user guide section on [https://downloads.haskell.org/%7Eghc/latest/docs/html/users_guide/phases.htm... #ghc-flag--rtsopts[=%E2%9F%A8none|some|all|ignore|ignoreAll%E2%9F%A9 `-rtsopts`] specifies that `-rtsopts=some` is the default setting in the text under it, while the specified default is `all`.

Happy to submit a patch if someone can confirm that `all` is actually the default, and that I'm not misunderstanding the meaning here.

"[this is the default setting] Enable only the “safe” RTS options: (Currently only `-?` and `--info`.) Any other RTS options on the command

New description: Currently the user guide section on [https://downloads.haskell.org/%7Eghc/latest/docs/html/users_guide/phases.htm... #ghc-flag--rtsopts[=%E2%9F%A8none|some|all|ignore|ignoreAll%E2%9F%A9 `-rtsopts`] specifies that `-rtsopts=some` is the default setting in the text under it, while the specified default is `all`. line or in the `GHCRTS` environment variable causes the program with to abort with an error message." Happy to submit a patch if someone can confirm that `all` is actually the default, and that I'm not misunderstanding the meaning here. -- -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/15773#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#15773: User Guide contains erroneous information about `-rtsopts` modes. -------------------------------------+------------------------------------- Reporter: _recursion | Owner: (none) Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: Resolution: | Keywords: User Guide 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 osa1): I agree that it looks a bit confusing, but it's actually correct. - The default (without any `-rtsopts`) is `-rtsopts=some` - If you just do `-rtsopts` it means `-rtsopts=all` So there are two defaults: when you don't pass `-rtsopts` at all, and you pass it without specifying the detail (all, some etc.). Not sure what's the best way to clarify this. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/15773#comment:3 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#15773: User Guide contains confusing information about `-rtsopts` modes. -------------------------------------+------------------------------------- Reporter: _recursion | Owner: (none) Type: task | Status: new Priority: normal | Milestone: Component: Documentation | Version: Resolution: | Keywords: User Guide Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Wiki Page: | -------------------------------------+------------------------------------- -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/15773#comment:5 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler