docs: add support for ref-man man-pages

[frazze-jobb]

No description provided.

[github-actions]

CT Test Results

    4 files    228 suites   1h 55m 19s ⏱️
3 732 tests 3 629 ✅ 103 💤 0 ❌
4 862 runs  4 733 ✅ 129 💤 0 ❌

Results for commit ae6b9e7.

♻️ This comment has been updated with latest results.

To speed up review, make sure that you have read Contributing to Erlang/OTP and that all checks pass.

See the TESTING and DEVELOPMENT HowTo guides for details about how to run test locally.

Artifacts

• Complete CT logs (Download Logs)
• HTML Documentation (Download HTML Docs)
• Windows Installer

// Erlang/OTP Github Action Bot

[kikofernandez]

I believe we should add tests, similar to shell_docs_SUITE with the function docsmap.
Essentially, we want to test that we do not crash if we generate all man pages.

The main reason is that we may not crash when we test locally, but we may add some unsupported markdown that generates a new markdown AST node, and that one crashes the man page generation.

[kikofernandez]

Suggested change

	-spec extract_type_specs(atom()) -> term().
	-spec extract_type_specs(module()) -> map().

[kikofernandez]

The only external entry point to this function is passing a binary(), which means it receives markdown.
I wonder if we really need an overloaded external function, or if we could instead expect a single input type for the Markdown variable, which simplifies the typing of the function

[kikofernandez]

Suggestion, take it or leave it :)
Just trying to remove some base case with the list comprehension, and removing some more function clauses, but feel free to ignore

Suggested change

	format_p_item({code,_,Text}) ->
	[~B"\fI",format_p_item(Text),~B"\fR"];
	format_p_item({em,_,Text}) ->
	[~B"\fB",format_p_item(Text),~B"\fR"];
	format_p_item({i,_,Text}) ->
	[~B"\fI",format_p_item(Text),~B"\fR"];
	format_p_item({a,_,Text}) ->
	[~B"\fI",format_p_item(Text),~B"\fR"];
	format_p_item({strong,_,Text}) ->
	["\\fB", format_p_item(Text), "\\fR"];
	format_p_item([H|T]) ->
	[format_p_item(H)|format_p_item(T)];
	format_p_item([]) ->
	[];
	format_p_item(Text) when is_binary(Text) ->
	escape_backslashes(Text).
	format_p_item({Fi,_,Text}) when Fl =:= code;
	Fl =:= i;
	Fl =:= a->
	[~B"\fI",format_p_item(Text),~B"\fR"];
	format_p_item({Fb,_,Text}) when Fb =:= em;
	Fb =:= strong->
	[~B"\fB",format_p_item(Text),~B"\fR"];
	format_p_item(Ls) when is_list(Ls)->
	[format_p_item(H) || H <- Ls];
	format_p_item(Text) when is_binary(Text) ->
	escape_backslashes(Text).