[pfx] Re: [PATCH] Drop removed -style option from html2text

2024-03-11 Thread Wietse Venema via Postfix-users
Wietse Venema via Postfix-users:
> Christian Goettsche via Postfix-users:
> > On Mon, 11 Mar 2024 at 17:50, Wietse Venema  wrote:
> > >
> > > Christian Goettsche via Postfix-users:
> > > > html2text dropped the command line option -style in version 2[1].
> > >
> > > I am not using that html2text version on the machine where I prepare
> > > Postfix releases. I found that removing that flag makes the output
> > > massively different.
> > >
> > > I need that documentation builds are reproducible. Otherwise, that
> > > greatly affects the sizes of source-code diffs and patches.
> > 
> > Maybe one could incorporate the "pretty" default values from
> > https://github.com/grobian/html2text/blob/master/contrib/pretty.style
> > into the bundled proto/html2text.rc?
> 
> Someone who is more familiar with html2text could do that. But this
> still would not address the need for reproducible documentation builds.
> 
> Almost every improvement to html2text will change the result
> (othewise, why bother :-), so that earlier results are no longer
> reproducible, and diffs and patches will bloat.
> 
> It's the same problem with code formatting: the indent tool has
> imperfections, but the result needs to be reproducible otherwise
> (bug or emergency) patches will bloat, and worse: they will fail
> to apply when I need to rebase them to an earlier Postfix release.

Just for due diligence I appended the pretty.style settings at the
end of html2text.rc. With the existing html2text version on my
release machine, that does not reproduce the existing results, for
example, less leading space with items in unordered lists, and more
leading space with block quotes. That in turn changes word wrapping.

This is not a request to update the Postfix settings for the html2text
version on the machine that builds documentation for releases, or
to arrive at settings that reproduce existing output with a current
html2text version. That would take hours away from the time that I
want to spend on Postfix.

Wietse
___
Postfix-users mailing list -- postfix-users@postfix.org
To unsubscribe send an email to postfix-users-le...@postfix.org


[pfx] Re: [PATCH] Drop removed -style option from html2text

2024-03-11 Thread Wietse Venema via Postfix-users
Christian Goettsche via Postfix-users:
> On Mon, 11 Mar 2024 at 17:50, Wietse Venema  wrote:
> >
> > Christian Goettsche via Postfix-users:
> > > html2text dropped the command line option -style in version 2[1].
> >
> > I am not using that html2text version on the machine where I prepare
> > Postfix releases. I found that removing that flag makes the output
> > massively different.
> >
> > I need that documentation builds are reproducible. Otherwise, that
> > greatly affects the sizes of source-code diffs and patches.
> 
> Maybe one could incorporate the "pretty" default values from
> https://github.com/grobian/html2text/blob/master/contrib/pretty.style
> into the bundled proto/html2text.rc?

Someone who is more familiar with html2text could do that. But this
still would not address the need for reproducible documentation builds.

Almost every improvement to html2text will change the result
(othewise, why bother :-), so that earlier results are no longer
reproducible, and diffs and patches will bloat.

It's the same problem with code formatting: the indent tool has
imperfections, but the result needs to be reproducible otherwise
(bug or emergency) patches will bloat, and worse: they will fail
to apply when I need to rebase them to an earlier Postfix release.

Wietse
___
Postfix-users mailing list -- postfix-users@postfix.org
To unsubscribe send an email to postfix-users-le...@postfix.org


[pfx] Re: [PATCH] Drop removed -style option from html2text

2024-03-11 Thread Christian Göttsche via Postfix-users
On Mon, 11 Mar 2024 at 17:50, Wietse Venema  wrote:
>
> Christian Goettsche via Postfix-users:
> > html2text dropped the command line option -style in version 2[1].
>
> I am not using that html2text version on the machine where I prepare
> Postfix releases. I found that removing that flag makes the output
> massively different.
>
> I need that documentation builds are reproducible. Otherwise, that
> greatly affects the sizes of source-code diffs and patches.

Maybe one could incorporate the "pretty" default values from
https://github.com/grobian/html2text/blob/master/contrib/pretty.style
into the bundled proto/html2text.rc?

>
> Wietse
___
Postfix-users mailing list -- postfix-users@postfix.org
To unsubscribe send an email to postfix-users-le...@postfix.org


[pfx] Re: [PATCH] Drop removed -style option from html2text

2024-03-11 Thread Wietse Venema via Postfix-users
Christian Goettsche via Postfix-users:
> html2text dropped the command line option -style in version 2[1].

I am not using that html2text version on the machine where I prepare
Postfix releases. I found that removing that flag makes the output
massively different.

I need that documentation builds are reproducible. Otherwise, that
greatly affects the sizes of source-code diffs and patches.

Wietse
___
Postfix-users mailing list -- postfix-users@postfix.org
To unsubscribe send an email to postfix-users-le...@postfix.org