discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: "Pali Rohár" <pali.rohar@gmail.com>
Cc: discuss@mandoc.bsd.lv
Subject: Re: Broken tables in HTML output
Date: Mon, 3 Dec 2018 23:37:43 +0100	[thread overview]
Message-ID: <20181203223743.GE92067@athene.usta.de> (raw)
In-Reply-To: <20181203222045.ramwyfizw4lkk4il@pali>

Hi Pali,

Pali Rohar wrote on Mon, Dec 03, 2018 at 11:20:45PM +0100:
> On Monday 03 December 2018 23:14:54 Ingo Schwarze wrote:
>> Pali Rohar wrote on Mon, Dec 03, 2018 at 11:01:42PM +0100:

>>> Seems that it is needed to put "border-bottom-style: solid"
>>> for rowspanned td element.  At least this is working in chrome.

>> That would further degrade the quality of the HTML code written by
>> mandoc.  As a rule, "style=" attributes should be avoided and CSS
>> should instead by used.  Unfortunately, that's not possible here
>> because the hard-coded presentational decisions like "draw a border
>> right here" are already contained in the tbl(7) input, and there
>> is no way to convert those purely presentational decisions of the
>> author into semantic or structural markup that could be handled
>> with CSS.
>> 
>> But at least the amount of "style=" attributes written should be
>> minimized.  Only those "style=" attributes should be written that
>> are required to correctly express the author's intent.

> This suggestion is to move border style definition from tr do td.

That would mean writing more "style=" attributes.
If a row intersects N cells, N times more.
That is not good.

>>> And after playing a bit I was not able to achieve visible border
>>> when was specified for tr element.
>>> 
>>> It is possible such change in mandoc generator? I understand that
>>> current HTML output is (or you think) correct, but is unusable in
>>> chrome browser.  And chrome is one of the major browsers, so it
>>> should not be ignored.

>> If you think chrome is important, please report the bug with chrome,
>> because right now, it looks like mandoc output is correct and
>> chrome rendering is buggy.
>> 
>> Alternatively, please explain why you think that chrome rendering
>> is correct, and please explain in which way mandoc is violating
>> the HTML standard, according to your understanding of the standard.

> I'm not saying that mandoc output is incorrect. Just I'm trying to find
> some modification or workaround which results in non-broken tables in
> chrome which are generated by mandoc. What I like to have is ability for
> users to see tables in manpages rendered correctly in current versions
> of web browsers.

I disagree with that goal.

It is not the job of some software to work around bugs in other software.
It is the job of the maintainers of the broken software to fix it.

If every program tried to work around bugs in other programs,
every program would become more complicated (and hence more buggy).
Time is wasted for devising, implementing, testing, and maintaining
workarounds that would be better spent fixing actual bugs.
And for the authors of the other software which is buggy, the
incentive to fix their bugs is also lowered.

So everybody loses.  In particular the users, because they end up
with *both* programs more buggy than necessary.

And no, the size of the chrome project is not an excuse for letting
bugs unfixed.  Quite to the contrary, the size of a project is one
of the reasons that lead to many bugs in the first place.  So the
bigger a project, the more important it gets to diligently fix bugs.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv

  reply	other threads:[~2018-12-03 22:37 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-07-16 11:03 Pali Rohár
2018-07-16 15:29 ` Ingo Schwarze
2018-07-16 16:36   ` Pali Rohár
2018-07-16 17:44     ` Ingo Schwarze
2018-11-24 23:15   ` Ingo Schwarze
2018-11-25 19:34   ` Ingo Schwarze
2018-11-25 21:25     ` Ingo Schwarze
2018-11-26  8:53       ` Pali Rohár
2018-11-26 21:27   ` Ingo Schwarze
2018-11-26 21:58     ` Pali Rohár
2018-11-26 22:01       ` Pali Rohár
2018-11-26 22:05         ` Pali Rohár
2018-12-01 17:20           ` Ingo Schwarze
2018-12-01 19:35             ` Pali Rohár
2018-12-03 20:46             ` Pali Rohár
2018-12-04  5:33               ` Ingo Schwarze
2018-12-03 22:01             ` Pali Rohár
2018-12-03 22:14               ` Ingo Schwarze
2018-12-03 22:20                 ` Pali Rohár
2018-12-03 22:37                   ` Ingo Schwarze [this message]
2018-12-04 16:44                     ` Pali Rohár
2018-12-04 18:04                       ` Ingo Schwarze
2019-01-21  9:39                         ` Pali Rohár
2019-01-21 13:16                           ` Ingo Schwarze
2018-11-29  2:15     ` Ingo Schwarze

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20181203223743.GE92067@athene.usta.de \
    --to=schwarze@usta.de \
    --cc=discuss@mandoc.bsd.lv \
    --cc=pali.rohar@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).