Diffing man 5 postconf changes between releases

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

Diffing man 5 postconf changes between releases

J Doe
Hi,

I currently use Postfix version 3.1.0.  I know that there are announcements of feature changes between each release of Postfix via e-mail and I read these, but I was wondering if there was an easy way to see the changes to the main.cf configuration parameters between versions ?

For example, can I somehow diff the difference between man 5 postconf on version 3.1.0 and the current release of Postfix ?  When I say diff, I am hoping to be able to see just the new configuration parameters.

The only way I can think of doing this is to dump the default configuration from postconf from one version and then diff that against the default configuration from postconf from the current version.  That will tell me new parameters, but it won’t show me if the documentation for existing parameters has changed.

If there isn’t an easy way to do this, is this in fact documented somewhere (perhaps a list of configuration parameter changes on the website that I just haven’t found yet) ?

Thanks,

- J
Reply | Threaded
Open this post in threaded view
|

Re: Diffing man 5 postconf changes between releases

Wietse Venema
J Doe:

> Hi,
>
> I currently use Postfix version 3.1.0.  I know that there are
> announcements of feature changes between each release of Postfix
> via e-mail and I read these, but I was wondering if there was an
> easy way to see the changes to the main.cf configuration parameters
> between versions ?
>
> For example, can I somehow diff the difference between man 5
> postconf on version 3.1.0 and the current release of Postfix ?
> When I say diff, I am hoping to be able to see just the new
> configuration parameters.
>
> The only way I can think of doing this is to dump the default
> configuration from postconf from one version and then diff that
> against the default configuration from postconf from the current
> version.  That will tell me new parameters, but it won?t show me
> if the documentation for existing parameters has changed.
>
> If there isn?t an easy way to do this, is this in fact documented
> somewhere (perhaps a list of configuration parameter changes on
> the website that I just haven?t found yet) ?
>

New features and feature changes are summarized in the RELEASE_NOTES file.

        Wietse
Reply | Threaded
Open this post in threaded view
|

Re: Diffing man 5 postconf changes between releases

Viktor Dukhovni
In reply to this post by J Doe


> On Feb 10, 2018, at 10:26 AM, J Doe <[hidden email]> wrote:
>
> I currently use Postfix version 3.1.0.  I know that there are announcements of feature changes between each release of Postfix via e-mail and I read these, but I was wondering if there was an easy way to see the changes to the main.cf configuration parameters between versions ?
>
> For example, can I somehow diff the difference between man 5 postconf on version 3.1.0 and the current release of Postfix ? When I say diff, I am hoping to be able to see just the new configuration parameters.

As Wietse said, read the RELEASE_NOTES files.  However, if you realy
want the gory details (which will likely take more effort to digest):

    $ git clone https://github.com/vdukhovni/postfix
    $ cd postfix/postfix
    $ git diff v3.1.0 v3.2.5 -- proto/postconf.proto

For more (say 20 lines of) context say:

   $ git diff -U20 v3.1.0 v3.2.5 -- proto/postconf.proto

--
        Viktor.