reasonml / reasonml/reason

`#use "topfind";` not needed with 'rtop', and crashes 'rtop' to boot

Open
#847 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

KIND: BUG Rtop
Dominant language
OCaml
Stars
10.3k
Forks
438
PR merge metrics
No merged PRs in 30d

Description

I'm an OCaml novice (thanks to Reason 😄) and I wanted to use the opam installation of Reason along with containers as my standard library. After installing it with:

opam install containers

I found that if I entered #use "topfind"; into rtop then it exited with this error:

Fatal error: exception Syntax_util.Error(_, _)

whereas doing the same worked great in utop.

This is probably obvious to OCaml practitioners, but it wasn't to me so I thought I'd share. It turned out that by just not running that line and proceeding straight to the #require "containers"; line then everything worked correctly, and I was able to open Containers; and use it just fine.

This issue can probably be immediately closed, though maybe this should be documented in the readme.MD?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review readme.MD and reproduce the reported commands in rtop and utop. Document whether #use "topfind" should be omitted in rtop when using opam-installed Reason and containers, and explain the working #require and open Containers flow. Done means a newcomer can follow the documented setup without triggering the reported crash.

Written by the indexing model from the issue text.

Assessment

Tech stack
ocaml
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.