[PATCH] fix phk build system

[Martin Blix Grydeland]

On 16 September 2015 at 15:35, Kacper Wysocki <kacperw at gmail.com> wrote:

> Fair point. there may or may not be more engineering effort into
> making opt2rst and the associated build system changes than it would
> actually take to update the rst files once in a while.
>

Once in a while sounds like an event happening fairly regularly and always
coincides with releases. Real life studies have shown that that is indeed
the case, but unfortunately there is a strict time ordering where the
release always happens just before the doc update.


> I am just guessing here, but perhaps the initial rationale was how to
> keep the documentation up to date with the code without anyone having
> to think about the options?
>

Yes, this should be considered a work around of the natural law mentioned
above.

Martin


>
> On Wed, Sep 16, 2015 at 2:54 PM, Federico Schwindt <fgsch at lodoss.net>
> wrote:
> > I never quite understood why we have binaries output'ing .rst.  It's not
> > like the options change daily.
> >
> >
> >
> > On Wed, Sep 16, 2015 at 1:00 PM, Guillaume Quintard
> > <guillaume at varnish-software.com> wrote:
> >>
> >> I thought the problem had more to do with ordering build targets and
> >> less with what binary was used, so merging de *_opt2rst may not help.
> >> And I see no real reason for a binary to output rst.
> >>
> >> However, it would greatly improve readability/maintainability (that
> >> could be done using GNU make features, but we'd lose bmake
> >> compatibility), and I'm all for that.
> >> --
> >> Guillaume Quintard
> >>
> >>
> >> On Wed, Sep 16, 2015 at 12:38 PM, Poul-Henning Kamp <phk at phk.freebsd.dk
> >
> >> wrote:
> >> > --------
> >> > In message
> >> > <CABaBnj48U7gS7F7UfY5kzFOgVnk2JPp3ob7m2HGv2xiQNkjOpw at mail.gmail.com>
> >> > , Kacper Wysocki writes:
> >> >
> >> >>A discussion with Martin at the VDD concluded that a good way to clean
> >> >> this up
> >> >>would be to take the opt2rst functions into each binary as an
> >> >>undocumented option. I'll be happy to try that if noone objects.
> >> >
> >> > I think that makes sense.  We also have the RST emitting stuff
> >> > integrated
> >> > in varnishd, and it's not like diskspace is horribly expensive these
> >> > days.
> >> >
> >> > --
> >> > Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
> >> > phk at FreeBSD.ORG         | TCP/IP since RFC 956
> >> > FreeBSD committer       | BSD since 4.3-tahoe
> >> > Never attribute to malice what can adequately be explained by
> >> > incompetence.
> >> >
> >> > _______________________________________________
> >> > varnish-dev mailing list
> >> > varnish-dev at varnish-cache.org
> >> > https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev
> >>
> >> _______________________________________________
> >> varnish-dev mailing list
> >> varnish-dev at varnish-cache.org
> >> https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev
> >
> >
> >
> > _______________________________________________
> > varnish-dev mailing list
> > varnish-dev at varnish-cache.org
> > https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev
>
>
>
> --
> http://comotion.delta9.pl
> http://u.delta9.pl
> http://kacper.doesntexist.org
> Too much order is its own chaos.
> Employ no technique to gain supreme enlightment.
>
> _______________________________________________
> varnish-dev mailing list
> varnish-dev at varnish-cache.org
> https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev
>



-- 
<http://varnish-software.com>*Martin Blix Grydeland*
Senior Developer | Varnish Software AS
Mobile: +47 992 74 756
We Make Websites Fly!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://www.varnish-cache.org/lists/pipermail/varnish-dev/attachments/20150916/c8a03d02/attachment.html>