edoc failing for cowboy_http3.erl

[NedSmitty]

Hi,

While generating edoc, cowboy_http3.erl gets this error:

=ERROR REPORT==== 9-Oct-2025::06:58:39.503716 ===
3114- fatal: {invalid_name,"<"http"}

cowboy_http3.erl, in module footer: at line 726: error in XML parser: {fatal,{{invalid_name,"<"http"},
{file,file_name_unknown},
{line,731},
{col,19}}}.

It looks like it's due to "push promise" @todo tag before the commented out commands/3 function clauses and edoc parsing the commented out code like a function header. That means the << characters on lines 731, 732 and 736 will give errors.

For edoc to work, if you want to keep the commented out function clause in the module then the easiest way to sort to would be to add an %% @end before the commented out code on line 728.

Thanks
Alan

[essen]

Cowboy doesn't use edoc, the manual is in doc/src/manual.