Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
New comment on block [block-idp9138704] #236
I just spent ~45 minutes trying to get everything working. In short, I am NOT happy.
I tried following the instructions in Chapter 1, which basically say all you need to do is:
$ opam init
AFAICT, this is completely false: these instructions are not at all sufficient, as no matter what I tried,
Apparently, typing in all of the commands in this section is what I finally needed to do.
I would not have ignored this section if Chapter 1 had not made it sound like it should be so simple to install OCaml. If people get utop working but can't install Core, then I think many of your examples will not work for them and your readers will be extremely upset.
I know that you want to dive right into the language in Chapter 1, but if you do not emphasize how important it is to get set up correctly (and provide the instructions to do so), then your readers will be unsuccessful.
Also, it seems like I should put the following steps (or something like them) into my ~/.bashrc:
$ opam init
You should be explicit about this, as well. For example: which of these commands do I have to run every time? It seems weird to have to run
This comment has been minimized.
This comment has been minimized.Show comment Hide comment
This comment references this from milestone alpha2: http://www.realworldocaml.org/alpha2/en/html/installation.html#idp9138704
I've added a preface section which explains why this isn't "just ocaml", but also "ocaml + core". This also has a note to reviewers warning them to get installed properly first, with a pointer to Appendix A: Installation.
I'm holding this issue open to further explain why
I've elaborated more on what files get installed where, and also which commands only need to be run once, and also improved the TL;DR at the start of the guided tour to remind the user to create an ocamlinit file.
There's still some explanation left about what ocamlfind does, but I've marked a TODO there.