table of contents
- bookworm 1:25.2.3+dfsg-1
- testing 1:25.3.2.8+dfsg-1
- unstable 1:25.3.2.11+dfsg-1
- experimental 1:26.2.1+dfsg-1
| edoc_layout_chunks(3erl) | Erlang Module Definition | edoc_layout_chunks(3erl) |
NAME¶
edoc_layout_chunks - Convert EDoc module documentation to an
EEP-48
docs_v1 chunk.
DESCRIPTION¶
Convert EDoc module documentation to an EEP-48 docs_v1 chunk.
This layout is only expected to work with edoc_doclet_chunks. Section Using the EDoc API in the EDoc User's Guide shows an example of using this module.
This module breaks the convention stated in edoc_doclet to not rely on edoc.hrl in doclets and layouts. It uses #entry{} records directly to recover information that is not otherwise available to layouts.
DATA TYPES¶
- beam_language() = atom():
- doc() = #{doc_language() => doc_string()} | none | hidden:
- doc_language() = binary():
- doc_string() = binary():
- docs_v1() = #docs_v1{anno=erl_anno:anno(), beam_language=beam_language(), format=mime_type(), module_doc=doc(), metadata=metadata(), docs=[docs_v1_entry()]}:
The Docs v1 chunk according to EEP 48.
A tuple equivalent to the #docs_v1_entry{} record, but with the record name field skipped.
EXPORTS¶
module(Doc::edoc:edoc_module(), Options::proplists:proplist())
-> binary()
Convert EDoc module documentation to an EEP-48 style doc chunk.
SEE ALSO¶
edoc_doclet_chunks, shell_docs(3erl)
AUTHORS¶
Radek Szymczyszyn <lavrin@gmail.com>
| edoc 1.2.1 |