<div class="gmail_quote">On Thu, Jun 18, 2009 at 5:17 PM, Braden McDaniel <span dir="ltr"></span>wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">

<div><div></div><div class="h5">On 6/18/09 5:03 PM, Orcan Ogetbil wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Thu, Jun 18, 2009 at 4:59 PM, Braden McDaniel  wrote:<br>
<br>
    On 6/18/09 2:42 PM, Orcan Ogetbil wrote:<br>
<br>
        Hi,<br>
<br>
        Toshio asked me to write up a proposal for clarification of the<br>
        removal of pre-built binaries. I came up with two proposals. I'd<br>
        like<br>
        to have them considered and voted separately.<br>
<br>
        <a href="https://fedoraproject.org/wiki/PackagingDrafts/Removal_of_pre-built_binaries" target="_blank">https://fedoraproject.org/wiki/PackagingDrafts/Removal_of_pre-built_binaries</a><br>
<br>
<br>
    In general, this is simply a nonstarter for Doxygen-generated HTML<br>
    documentation.  There is nontrivial (and generally unpredictable)<br>
    variance in the style sheet that Doxygen generates from one version<br>
    to the next.  Accordingly, the interactions between this style sheet<br>
    any any that the package upstream may have added cannot be foreseen.<br>
<br>
<br>
That's why the statement starts with "If possible..."<br>
</blockquote>
<br></div></div>
It is "possible" in that one can perform the regeneration operation without any obvious errors.  It is not "desirable" in that there is a reasonable possibility of nonobvious errors; that is, errors that are detectable only by viewing the generated documentation and furthermore perhaps only readily obvious to someone familiar with how the documentation is intended to be rendered.<br>


<br>
The point is that, in light of this, the guideline should be that these files should *not* be regenerated unless doing so affords some tangible improvement.<div><div></div><div class="h5"><br>
</div></div></blockquote><div><br>Sure, it is just a draft. Things can be added or replaced. Maybe "possible" is not the best word. What would be better? "feasible", "desirable", "affords tangible improvement" ?<br>

<br>Orcan<br></div></div>