<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 16 September 2015 at 15:35, Kacper Wysocki <span dir="ltr"><<a href="mailto:kacperw@gmail.com" target="_blank">kacperw@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Fair point. there may or may not be more engineering effort into<br>
making opt2rst and the associated build system changes than it would<br>
actually take to update the rst files once in a while.<br></blockquote><div><br></div><div>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.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I am just guessing here, but perhaps the initial rationale was how to<br>
keep the documentation up to date with the code without anyone having<br>
to think about the options?<br></blockquote><div><br></div><div>Yes, this should be considered a work around of the natural law mentioned above.</div><div><br></div><div>Martin</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="HOEnZb"><div class="h5"><br>
On Wed, Sep 16, 2015 at 2:54 PM, Federico Schwindt <<a href="mailto:fgsch@lodoss.net">fgsch@lodoss.net</a>> wrote:<br>
> I never quite understood why we have binaries output'ing .rst. It's not<br>
> like the options change daily.<br>
><br>
><br>
><br>
> On Wed, Sep 16, 2015 at 1:00 PM, Guillaume Quintard<br>
> <<a href="mailto:guillaume@varnish-software.com">guillaume@varnish-software.com</a>> wrote:<br>
>><br>
>> I thought the problem had more to do with ordering build targets and<br>
>> less with what binary was used, so merging de *_opt2rst may not help.<br>
>> And I see no real reason for a binary to output rst.<br>
>><br>
>> However, it would greatly improve readability/maintainability (that<br>
>> could be done using GNU make features, but we'd lose bmake<br>
>> compatibility), and I'm all for that.<br>
>> --<br>
>> Guillaume Quintard<br>
>><br>
>><br>
>> On Wed, Sep 16, 2015 at 12:38 PM, Poul-Henning Kamp <<a href="mailto:phk@phk.freebsd.dk">phk@phk.freebsd.dk</a>><br>
>> wrote:<br>
>> > --------<br>
>> > In message<br>
>> > <<a href="mailto:CABaBnj48U7gS7F7UfY5kzFOgVnk2JPp3ob7m2HGv2xiQNkjOpw@mail.gmail.com">CABaBnj48U7gS7F7UfY5kzFOgVnk2JPp3ob7m2HGv2xiQNkjOpw@mail.gmail.com</a>><br>
>> > , Kacper Wysocki writes:<br>
>> ><br>
>> >>A discussion with Martin at the VDD concluded that a good way to clean<br>
>> >> this up<br>
>> >>would be to take the opt2rst functions into each binary as an<br>
>> >>undocumented option. I'll be happy to try that if noone objects.<br>
>> ><br>
>> > I think that makes sense. We also have the RST emitting stuff<br>
>> > integrated<br>
>> > in varnishd, and it's not like diskspace is horribly expensive these<br>
>> > days.<br>
>> ><br>
>> > --<br>
>> > Poul-Henning Kamp | UNIX since Zilog Zeus 3.20<br>
>> > phk@FreeBSD.ORG | TCP/IP since RFC 956<br>
>> > FreeBSD committer | BSD since 4.3-tahoe<br>
>> > Never attribute to malice what can adequately be explained by<br>
>> > incompetence.<br>
>> ><br>
>> > _______________________________________________<br>
>> > varnish-dev mailing list<br>
>> > <a href="mailto:varnish-dev@varnish-cache.org">varnish-dev@varnish-cache.org</a><br>
>> > <a href="https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev" rel="noreferrer" target="_blank">https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev</a><br>
>><br>
>> _______________________________________________<br>
>> varnish-dev mailing list<br>
>> <a href="mailto:varnish-dev@varnish-cache.org">varnish-dev@varnish-cache.org</a><br>
>> <a href="https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev" rel="noreferrer" target="_blank">https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev</a><br>
><br>
><br>
><br>
> _______________________________________________<br>
> varnish-dev mailing list<br>
> <a href="mailto:varnish-dev@varnish-cache.org">varnish-dev@varnish-cache.org</a><br>
> <a href="https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev" rel="noreferrer" target="_blank">https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev</a><br>
<br>
<br>
<br>
</div></div><span class="HOEnZb"><font color="#888888">--<br>
<a href="http://comotion.delta9.pl" rel="noreferrer" target="_blank">http://comotion.delta9.pl</a><br>
<a href="http://u.delta9.pl" rel="noreferrer" target="_blank">http://u.delta9.pl</a><br>
<a href="http://kacper.doesntexist.org" rel="noreferrer" target="_blank">http://kacper.doesntexist.org</a><br>
Too much order is its own chaos.<br>
Employ no technique to gain supreme enlightment.<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
varnish-dev mailing list<br>
<a href="mailto:varnish-dev@varnish-cache.org">varnish-dev@varnish-cache.org</a><br>
<a href="https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev" rel="noreferrer" target="_blank">https://www.varnish-cache.org/lists/mailman/listinfo/varnish-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div><table border="0" cellpadding="0" cellspacing="0" style="font-size:12px;line-height:1.5em;font-family:'Helvetica Neue',Arial,sans-serif;color:rgb(102,102,102);width:550px;border-top-width:1px;border-top-style:solid;border-top-color:rgb(238,238,238);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);margin-top:20px;padding-top:5px;padding-bottom:5px"><tbody><tr><td width="100"><a href="http://varnish-software.com" target="_blank"><img src="http://www.varnish-software.com/static/media/logo-email.png"></a><span></span><span></span></td><td><strong style="font-size:14px;color:rgb(34,34,34)">Martin Blix Grydeland</strong><br>Senior Developer | Varnish Software AS<br>Mobile: +47 992 74 756<br><span style="font-weight:bold">We Make Websites Fly!</span></td></tr></tbody></table></div></div></div></div>
</div></div>