Debian / debiman

debiman generates a static manpage HTML repository out of a Debian archive
Apache License 2.0
185 stars 46 forks source link

buggy overlapping text for multi-option <dd> entries #143

Closed jzacsh closed 2 years ago

jzacsh commented 2 years ago

tl;dr synonymous flags become unreadable because they're accidentally rendered ontop of eacother's pixels.

It appears that whenever there's an empty dd it causes the multiple synonymous dts (eg: -k and --DOS-names synonyms or zip(1)) then the first n-1 synonyms have a necessarily empty <dd> that cause all the synomyms to get rendered on top of eachother and become illegible. Interestingly there's a seemingly relevant clear: right but it doesn't appear to do anything, at least not now-a-days, so I'll send a fix to simply replace it.

bug (before fix)

Here's a bunch of examples of the buggy behavior: image

after fix

After fixing - by replacing this particular clear: right with clear: both - here's what things look like: image

stapelberg commented 2 years ago

I’ve pushed your fix to the Debian-specific assets, too: https://salsa.debian.org/manpages-team/debian-assets/-/commit/9d7bae59c19070076032f7b8bce58c7d9e3e4a81

stapelberg commented 2 years ago

I have also started a full re-render so that manpages.debian.org picks up the changes. It’ll probably be a day or two until all pages are rendered and synchronized to all web servers.