aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2016-01-09 13:36:46 +0100
committerLoïc Hoguin <[email protected]>2016-01-09 13:36:57 +0100
commitcc78f53af903f4e8fad8ac24fcede593ab8f6651 (patch)
tree7f5a36ea9d0695c39fe90f3841a82bcff7fa8c4b /doc/src
parentfe4aa4cf2d3eec83b7b07ee08b2d776ff43d1671 (diff)
downloaderlang.mk-cc78f53af903f4e8fad8ac24fcede593ab8f6651.tar.gz
erlang.mk-cc78f53af903f4e8fad8ac24fcede593ab8f6651.tar.bz2
erlang.mk-cc78f53af903f4e8fad8ac24fcede593ab8f6651.zip
Test and document EDoc
A change was made to the automatic EDoc generation when running 'make docs'. It is now only done if a doc/overview.edoc file exists. This behavior can of course be enabled back by adding it to the Makefile.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/guide/edoc.asciidoc46
1 files changed, 44 insertions, 2 deletions
diff --git a/doc/src/guide/edoc.asciidoc b/doc/src/guide/edoc.asciidoc
index 7827692..9fc1a74 100644
--- a/doc/src/guide/edoc.asciidoc
+++ b/doc/src/guide/edoc.asciidoc
@@ -1,6 +1,48 @@
[[edoc]]
== EDoc comments
-// @todo Write it.
+Erlang.mk provides a thin wrapper on top of EDoc, an application
+that generates documentation based on comments found in modules.
-Placeholder chapter.
+=== Writing EDoc comments
+
+The http://www.erlang.org/doc/apps/edoc/chapter.html[EDoc user guide]
+explains everything you need to know about EDoc comments.
+
+=== Configuration
+
+The `EDOC_OPTS` variable allows you to specify additional
+EDoc options. Options are documented in the
+http://www.erlang.org/doc/man/edoc.html#run-2[EDoc manual].
+
+A common use for this variable is to enable Markdown in doc
+comments, using the `edown` application:
+
+[source,make]
+DOC_DEPS = edown
+EDOC_OPTS = {doclet, edown_doclet}
+
+=== Usage
+
+To build all documentation, you would typically use:
+
+[source,bash]
+$ make docs
+
+Do note, however, that EDoc comments will only be generated
+automatically if the 'doc/overview.edoc' file exists. If you
+do not want that file and still want to generate doc comments,
+two solutions are available.
+
+You can generate EDoc documentation directly:
+
+[source,bash]
+$ make edoc
+
+You can enable automatic generation on `make docs` by adding
+the following to your Makefile:
+
+[source,make]
+----
+docs:: edoc
+----