elixir-lang / ex_doc

ExDoc produces HTML and EPUB documentation for Elixir projects
http://elixir-lang.org
Other
1.47k stars 327 forks source link

Output man pages #1962

Open zuiderkwast opened 1 day ago

zuiderkwast commented 1 day ago

When OTP switched to using ex_doc in OTP 27, we lost the man pages for the OTP modules.

Would you accept a PR to produce man pages, or is there a way to access the intermediate markdown format and use an external tool (e.g. pandoc) to generate man pages from it?

Example of an OTP man page from OTP 26:

image

josevalim commented 1 day ago

It probably makes the most sense for us to have a markdown output. Then you can use something like pandoc to convert it to man. :) PRs exploring this would be welcome!