From 372fc7cd22be767e332a8e22266ea8209bdd5e75 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Tue, 6 Nov 2018 14:22:42 +0100 Subject: readme: add sections describing build and dev repo --- readme.rst | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/readme.rst b/readme.rst index 4a95f48..a51b7e9 100644 --- a/readme.rst +++ b/readme.rst @@ -5,6 +5,39 @@ format. Includes a utility ``sidparse`` for dissecting SIDs on the command line. +building +-------- +The main build system is Oasis_, but there is a wrapper for OPAM to simplify +dependency management. + +A manual build involves the following steps: :: + + $ opam install stdint cmdliner ounit + $ oasis setup + $ make + +This will generate the library targets for ``sid.*`` as well as a utility +``sidparse.native`` that works similarly to ``uuidparse`` for UUIDs, and +unit test binary ``sid_test.byte``. + +To view the HTML documentation, issue :: + + $ make doc + +and point your browser at ``./_build/sid_intf.docdir/index.html``. + +.. _Oasis: https://github.com/ocaml/oasis +.. _OPAM: https://opam.ocaml.org/ + +project +------- +The master repo_ is hosted on gitlab.com, please use the issue tracker there or +email me_ directly. Gitlab is also where releases_ are published. + +.. _repo: https://gitlab.com/phgsng/ocaml-sid +.. _releases: https://gitlab.com/phgsng/ocaml-sid/tags +.. _me: mailto:phg@phi-gamma.net + references ---------- SIDs are specified in MS-DTYP_. -- cgit v1.2.3