generate index.html of html docs from mld file

4 files changed, 21 insertions, 3 deletions

diff --git a/README.md b/README.md
index ccf1b2f..9edf462 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ private information.
 `logbook` also provides a module `Log` for parsing `log` files and performing
 basic operations on an OCaml representation of a `log` file. It is currently
 mostly useful for reading `log` files and processing its information in some
-way.
+way. For details see the [API documentation](https://sternenseemann.github.io/logbook/doc/logbook/index.html).
 
 `logbook` uses a simplified version of the `log` format, which was originally
 [specified by Profpatsch](https://gist.github.com/Profpatsch/092ff68fa267b9fa0ccbe13e98149b21).
diff --git a/src/dune b/src/dune
index 1c4a997..63ff388 100644
--- a/src/dune
+++ b/src/dune
@@ -9,3 +9,6 @@
   (public_name logbook)
   (libraries logbook lwt lwt.unix jingoo cow)
   (modules logbook logbook_template logbook_models))
+
+(documentation
+  (mld_files index))
diff --git a/src/index.mld b/src/index.mld
new file mode 100644
index 0000000..d69efff
--- /dev/null
+++ b/src/index.mld
@@ -0,0 +1,17 @@
+{0 logbook}
+
+The [logbook] package includes a command line utility and a OCaml library for dealing with [log] files.
+
+{1 log files}
+
+[log] is a file format for personal diary or log keeping. For detailed information on the
+[log] file format see [man 7 logbook-log] or the [README.md] distributed with this package.
+
+{1 Log}
+
+The {!module-Log} module allows for parsing and manipulation of an OCaml representation of [log] files.
+
+{1 logbook}
+
+For usage information for the [logbook] utility that can generate HTML from [log] files see [man logbook]
+or the [README.md] distributed with this package.
diff --git a/src/log.mli b/src/log.mli
index de92068..116221f 100644
--- a/src/log.mli
+++ b/src/log.mli
@@ -52,8 +52,6 @@ val log_parser : (string log) Angstrom.t
     to apply a specific markup to a freshly parsed log file. *)
 val apply_markup : ('a -> 'b) -> 'a log -> 'b log
 
-(** {2 Log Building} *)
-
 (*---------------------------------------------------------------------------
    Copyright (c) 2017 sternenseemann