C-c C-l gives uneasy suggestion

[gracjan]

C-c C-l says:

You tried to do an interaction command, but an interaction mode has not been enabled yet.
Run M-x describe-variable haskell-mode-hook for a list of such modes.

(this does not fit in minibuffer because it is two lines long, but disregarding that)

M-x describe-variable haskell-mode-hook tell the usual Emacs blurb and this:

Documentation:
Hook run after entering Haskell mode.

M-x customize-option RET haskell-mode-hook suggests a lot but neither interactive-haskell-mode nor inf-haskell-mode is in the list.

Then there is a link to "See also haskell-mode and (haskell-mode)haskell-mode-hook." and that leads to:

@vindex haskell-mode-hook
One of the important setting you should customize is the @code{haskell-mode-hook} variable  
(@pxref{Hooks,,,emacs}) which gets run right after the @code{haskell-mode} major mode is
initialized for a buffer. You can customize @code{haskell-mode-hook} by 
@kbd{M-x customize-variable @key{RET} haskell-mode-hook}. It's highly recommended you
set up indentation to match your preferences; @xref{Indentation}, for more details about
the indentation modes included with Haskell Mode.

So still nothing about interactive-haskell-mode.

There is wiki: https://github.com/haskell/haskell-mode/wiki/Haskell-Interactive-Mode-Setup , where we read:

Run C-` to make a REPL open, this will create a session, start GHCi, and open the REPL.

Meanwhile C-backtick (haskell-interactive-bring) is not bound at all.

[gracjan]

Note that more documentation for haskell-mode-hook is there, just it is not shown via describe-variable.

[gracjan]

Seems Emacs just does not show documentation for hook beyond the generic Hook run after entering XXX mode.. So helpful!

[unhammer]

Odd, when I do C-h v haskell-mode-hook RET, I get the full documentation (same as when looking at the elisp).

(By the way, what's the use of haskell-interactive-bring instead of haskell-interactive-switch? The only difference I can see is that -bring switches to the interactive buffer if and only if it's not visible; I find that a bit inconsistent.)

[gracjan]

Interesting, I use Aquamacs, that might be the reason.

No idea about -bring and -switch. Is it sensibly fixable?

[unhammer]

gracjan notifications@github.com writes:

No idea about -bring and -switch. Is it sensibly fixable?

I would do

(defalias #'haskell-interactive-bring #'haskell-interactive-switch)

but perhaps there are people who prefer the -bring behaviour.

[PinkMushroom]

@unhammer interesting if i use C-h v haskell-mode-hook RET i do NOT get the full documentation.

edit: but simply get the standard very unhelpful basic display.

[unhammer]

what do you get?

[geraldus]

This is what I see:

haskell-mode-hook is a variable defined in `haskell-mode.el'.
Its value is
(structured-haskell-mode hindent-mode interactive-haskell-mode turn-on-font-lock)

This variable may be risky if used as a file-local variable.

Documentation:
Hook run after entering Haskell mode.
No problems result if this variable is not bound.
`add-hook' automatically binds it. (This is true for all hook variables.)

[back]

[unhammer]

Oh maybe I was doing h f haskell-mode instead of haskell-mode-hook, because when I try again now I get what @geraldus gets. Anyway, perhaps the docs for C-c C-l should point at `C-h f haskell-mode'

[gracjan]

True, docs should point to `haskell-mode` as a hub for all documentation and links to specifics. Can you create a pull request? BTW: C-c C-l suggestion could fit on one line. That would be MUCH better!

[geraldus]

@gracjan is this still relevant?

[gracjan]

Yes. It is still strange to find out how to enable haskell-interaction-mode and it is a stumbling block for many.