This repository is now archived as the work done here was merged upstream into Erlang/OTP and became part of OTP 24.
Thanks to that it's now possible to generate ExDoc documentation for Erlang projects. This is already happening in the community as evidenced by projects such as rebar3_hex, but also telemetry, systemd, ram, or syn to name a few.
The same mechanism - docs chunk defined by EEP-48 - also provides the shell_docs documentation for non-OTP Erlang projects.
OTP 23.0 ships with EEP-48 support and online help in the shell. This support is based on doc chunks, a new format for storing Erlang module documentation. This fork of EDoc emits doc chunks for non-OTP projects. It means online help will be available for all Erlang projects using EDoc.
The expected end of life of this project is merging back into OTP once the changes are polished enough. See erlef/documentation-wg#4 for progress reports.
$ rebar3 compile
You can generate doc chunks for your project in two ways: via a command line script or by using a Rebar3 plugin.
ERL_LIBS=/Users/erszcz/work/erszcz/edoc/_build/default/lib/ \
bin/edoc.escript -chunks -pa _build/default/lib/edoc/ebin/ -app edoc
ERL_LIBS is necessary for the out-of-OTP EDoc to be first in the Erlang code path.
Otherwise, OTP-shipped EDoc with no chunks support would be used.
Put this in your rebar.config:
{plugins,
[
{rebar3_edoc_chunks, {git, "https://github.com/erszcz/edoc.git", {branch, "wip"}}}
]}.
{provider_hooks,
[
{post, [{compile, {edoc_chunks, compile}}]}
]}.
Then just rebar3 compile and find the chunks under
_build/default/lib/$PROJECT/doc/chunks.
See https://github.com/erszcz/kvs/blob/4feb22b5397e2ffa620dab15e72e84893d9de8ef/rebar.config
for a working rebar.config example using profiles.
It's also possible to use an experimental branch of ExDoc to generate HTML docs from the chunks. Build ExDoc and then:
/Users/erszcz/work/elixir-lang/ex_doc/ex_doc \
edoc "0.11" _build/default/lib/edoc/ebin --main edoc
Please note that as of now
wm-erlang ExDoc branch is required.