Ocaml Jupyter installation instruction incomplete

[emiruz]

Installation instructions here: https://ocaml.xyz/tutorial/introduction.html

These lines:

pip install jupyter
opam install jupyter
jupyter kernelspec install --name ocaml-jupyter "$(opam config var share)/jupyter"

the opam jupyter install wont create the share/jupyter directory by itself. You have to run:

ocaml-jupyter-opam-genspec

I think the jupyter kernelspec command may also be missing a parameter. Here is some corrected code sourced from https://akabe.github.io/ocaml-jupyter/:

pip install jupyter
opam install jupyter
grep topfind ~/.ocamlinit || echo '#use "topfind";;' >> ~/.ocamlinit  # For using '#require' directive
grep Topfind.log ~/.ocamlinit || echo 'Topfind.log:=ignore;;' >> ~/.ocamlinit  # Suppress logging of topfind (recommended but not necessary)
ocaml-jupyter-opam-genspec
jupyter kernelspec install --user --name "ocaml-jupyter-$(opam var switch)" "$(opam var share)/jupyter"

[mseri]

Indeed, they are pretty outdated. ocaml-jupyter had changed this installation step quite some time ago. Could you send a PR to fix it?

[mseri]

The repository should be https://github.com/owlbarn/tutorial

[emiruz]

No problem -- will do as soon as I have some time for it. I'll be making use of owl lots soon and no doubt relying on the documentation, so I don't mind submitting new PRs to update/fix things as a I go.