summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDaniil Baturin <daniil@baturin.org>2017-01-17 13:16:17 +0700
committerGitHub <noreply@github.com>2017-01-17 13:16:17 +0700
commit1a8b435a83ef7c2a5eb472b5f2b3f1b63fcef08f (patch)
tree7ac494b83ce0f1eaa7a77df705a9d2c98becb741 /README.md
parent87fcecca68ad0c8b838d6ba47b87a34d8874d23b (diff)
parent6eb89521414e9e070ddbf75acab8cddb131dc4d5 (diff)
downloadvyconf-1a8b435a83ef7c2a5eb472b5f2b3f1b63fcef08f.tar.gz
vyconf-1a8b435a83ef7c2a5eb472b5f2b3f1b63fcef08f.zip
Merge pull request #7 from aBathologist/add_building_info_to_readme
Add a bit more build and setup instruction
Diffstat (limited to 'README.md')
-rw-r--r--README.md29
1 files changed, 24 insertions, 5 deletions
diff --git a/README.md b/README.md
index 44e6b14..a146242 100644
--- a/README.md
+++ b/README.md
@@ -79,16 +79,35 @@ and the #vyos IRC channel on Freenode.
Don't forget to add unit tests for things you add or change!
-If you are new to OCaml, you need to install (opam)[http://opam.ocaml.org/] first, then you need to install
-the compiler (e.g. "opam switch 4.03.0"), then install the build tools and build dependencies:
+If you are new to OCaml, you need to install (opam)[http://opam.ocaml.org/]
+first. Then install the correct version of the compiler, the build tools, and
+the build dependencies:
```
+opam switch 4.03.0
opam install oasis
-opam install xml-light lwt ppx_deriving_yojson pcre ounit fileutils toml
+opam install fileutils lwt ocplib-endian ounit pcre ppx_deriving_yojson sha toml xml-light
```
-I also recommend that you setup utop (a great interactive REPL) and setup your editor with merlin to
-see the inferred types. For GNU Emacs, consider installing tuareg-mode.
+To build the project, run the setup script, then `make`:
+
+```
+./build-setup.sh
+make
+```
+
+If the project gets in a weird state, and isn't building correctly, you can clean it up with
+
+```
+ocaml setup.ml -dist-clean
+```
+
+then build as before.
+
+I also recommend that you setup [utop](https://opam.ocaml.org/blog/about-utop/)
+(a great interactive REPL) and setup your editor with
+[merlin](https://github.com/ocaml/merlin) to see the inferred types. For GNU
+Emacs, consider installing [tuareg-mode](https://github.com/ocaml/tuareg).
Don't hesitate to ask if you have any setup or build issues, and specifically for OCaml issues,
there's #ocaml channel on Freenode too.