diff options
author | Loïc Hoguin <[email protected]> | 2019-07-18 09:59:28 +0200 |
---|---|---|
committer | Loïc Hoguin <[email protected]> | 2019-07-18 10:08:46 +0200 |
commit | 136d443b5c38bee96f5d995dfea3629ef07564c3 (patch) | |
tree | 1d31540baebc43ca0b2dceeda212c44f5da7e7a8 /docs/en/erlang.mk/1/guide/edoc.asciidoc | |
parent | e031713c0e8bd871248dbbbbdec1ea28609f4431 (diff) | |
download | ninenines.eu-136d443b5c38bee96f5d995dfea3629ef07564c3.tar.gz ninenines.eu-136d443b5c38bee96f5d995dfea3629ef07564c3.tar.bz2 ninenines.eu-136d443b5c38bee96f5d995dfea3629ef07564c3.zip |
Announce Ranch 2.0.0-rc.1
Adds Ranch 2.0 documentation and removes documentation for
very old Cowboy and Ranch, along with Erlang.mk documentation
which is available on its own website.
Diffstat (limited to 'docs/en/erlang.mk/1/guide/edoc.asciidoc')
-rw-r--r-- | docs/en/erlang.mk/1/guide/edoc.asciidoc | 61 |
1 files changed, 0 insertions, 61 deletions
diff --git a/docs/en/erlang.mk/1/guide/edoc.asciidoc b/docs/en/erlang.mk/1/guide/edoc.asciidoc deleted file mode 100644 index 2992a37d..00000000 --- a/docs/en/erlang.mk/1/guide/edoc.asciidoc +++ /dev/null @@ -1,61 +0,0 @@ -[[edoc]] -== EDoc comments - -Erlang.mk provides a thin wrapper on top of EDoc, an application -that generates documentation based on comments found in modules. - -=== 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 ----- - -=== Running EDoc on all applications - -In a multi-application project you may want to run EDoc -against all applications at the same time, instead of -against each applications independently. To do so, you -need to configure the `EDOC_SRC_DIRS` at the end of -your Makefile, after including 'erlang.mk': - -[source,make] ----- -EDOC_SRC_DIRS = $(ALL_APPS_DIRS) ----- |