Bad indentation in man output for various html constructs

[MarkCallow]

Describe the bug
When a list, e.g. <ul> is included in a <dd> the list is not indented enough and indentation of the content following the <dd> is wrong in the man output. HTML output is fine.

Screenshots
Man output showing the bad indentation:

HTML output with the correct indentation:

To Reproduce
Use bad-list-indent.tar.gz

To view the man page use

cd man
man -M . 1 _foo

Expected behavior
The list should be indented as it is in the HTML output.

Version
v1.11.0 on MacOS Sonoma. From DMG downloaded from doxygen.nl. The problem is not new in 1.11.0. It has been around for a long time.

Stack trace
n/a

Additional context
n/a

[MarkCallow]

Please look into a fix for this. We use Doxygen to create the man pages for our applications and, on Linux and macOS, the applications use the man command and these man pages to display their help. So many users see this bad rendering and I've been unable to find any workaround.

[doxygen]

@MarkCallow Please verify if the referenced commit fixes the problem for you. Do not close the issue, this will be done automatically when the next official release becomes available.

[MarkCallow]

@MarkCallow Please verify if the referenced commit fixes the problem for you.

Thanks @doxygen. I am not set up to build Doxygen. Is there a way to verify the commit without building Doxygen myself?

[doxygen]

@MarkCallow Please verify if the referenced commit fixes the problem for you.

Thanks @doxygen. I am not set up to build Doxygen. Is there a way to verify the commit without building Doxygen myself?

You can try one of the build results from the GitHub actions. See the bottom of this page:
https://github.com/doxygen/doxygen/actions/runs/9862637120

[MarkCallow]

You can try one of the build results from the GitHub actions.

It is a little better but still has issues. The list has been indented, but not enough. There is no change to the broken indentation of the following paragraph.

The good news is this build fixes the snippet problem of issue #10957.

Regarding the build, please provide an Apple Silicon build for macOS. I almost wasn't going to install the build artifact from GitHub Actions because of this but then I checked the release 1.11.0 build I have installed and found it too is x86_64.

The downloaded doxygen did not have execute permissions set which made Finder show it as a "Document" with TextEdit as the default opener. Also it is much smaller, 27MB vs the 155MB of the Resources/doxygen that came with the 1.11.0 Doxygen.app that I have installed. Both of these things gave me pause before deciding to try replacing that Resource/doxygen with the artifact and set its execute permissions. Fortunately it worked.

[albert-github]

I see another problem in the man version as well with nested <dl> tags.
when having:

        <dd>The format will be used to verify and load all input files into a texture before
            performing any specified encoding.
        <dd>
    <dl>
        <dt>\--format Second level &lt;enum&gt;</dt>
        <dd>KTX format enum that specifies the data format of the images in the created texture.
            The enum names are matching the VkFormats without the VK_FORMAT_ prefix.

this renders in HTML (correct) as:

but in the man page (wrong) we get:

so as if the --format Second level is a new top level <dl> instead of a sublevel.

Used doxygen version: 1.12.0 (78c3d1c)
Example: example.tar.gz

[MarkCallow]

I have updated the issue title to reflect that this covers various indentation issues with the man format output. Here is a new example covering the uncovered issues:

bad-list-indent2.tar.gz

Here are screen shots of output generated by Doxygen 12.0.0. First the HTML output to show what is expected.

And here is the man output.

[MarkCallow]

Please fix these indentation problems. I've gathered them all in one example for you. For reasons see #10956 (comment).