<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 15 July 2015 at 21:29, Paul Eggert <span dir="ltr"><<a href="mailto:eggert@cs.ucla.edu" target="_blank">eggert@cs.ucla.edu</a>></span> wrote:</div><div class="gmail_quote"><br></div><div class="gmail_quote"><snip></div><div class="gmail_quote"><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">       The man page for zic documents the tz<br>
       data format, but not in enough detail for a compliant<br>
implementation<br>
</blockquote>
<br></span>
It'd be helpful to fix that.  Any ambiguities should be clarified (or documented as being explicitly ambiguous), as was done in commit 2fab66aa164365209e47af24b2337b7c2ffdbe5c.  This shouldn't require a complete rewrite.</blockquote><div><br></div><div>Righto - I wasn't sure whether the intention was that the man page was complete in a specification sense, or more providing general guidance. I think it's clear in the vast majority of cases - it's only corner cases where I've found myself wondering how to interpret the rules.</div><div><br></div><div>I brought it up mostly as it was the motivation for needing regression tests, but I think we should separate the work. Obviously the burden is on me to be clear about exactly where and how I'm having problems. Would you prefer that I report my confusion on the list, or by direct mail?</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
If modifying zdump to add<br>
an extra flag is deemed an appropriate course of action, do we have any<br>
volunteers to do so?<br>
</blockquote>
<br></span>
I can volunteer to change zdump but it's not clear yet what needs to be changed.  First we'd need to design a good format for regression testing, and document that format.  This hasn't been done yet, and will take some thinking.  Existing format proposals haven't ensured that the zdump output should contain everything visible to the API.<br>
</blockquote></div><br></div><div class="gmail_extra">Right - as a non-API user, I'm mostly in the dark here. The proposal I've implemented on my github repo is very much to scratch my particular itch, and was mostly to make a start so that we could improve it.</div><div class="gmail_extra"><br></div><div class="gmail_extra">Is there any information missing on an individual transition basis, or is it more global matters (links, start/end points, range of transitions) that is missing information?</div><div class="gmail_extra"><br></div><div class="gmail_extra">Jon</div><div class="gmail_extra"><br></div></div>