<div dir="ltr">Committed-ish.</div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Feb 25, 2017 at 3:30 AM, Daniel Shahaf <span dir="ltr"><<a href="mailto:danielsh@apache.org" target="_blank">danielsh@apache.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Someone just asked on users@ about the -r {DATE} binary search issue,<br>
and I realized the warning box doesn't describe the most likely cause of<br>
that (svnadmin load).<br>
<br>
I suppose the warning box might want to grow an id="" attribute.<br>
<br>
Feel free to tweak.  I left the first hunk unreflowed to make the diff<br>
readable.<br>
<br>
Cheers,<br>
<br>
Daniel<br>
<br>
Index: ch03-advanced-topics.xml<br>
==============================<wbr>==============================<wbr>=======<br>
--- ch03-advanced-topics.xml    (revision 5302)<br>
+++ ch03-advanced-topics.xml    (working copy)<br>
@@ -308,11 +308,7 @@<br>
       </informalexample><br>
<br>
       <warning><br>
-        <para>Since the timestamp of a revision is stored as an<br>
-          unversioned, modifiable property of the revision (see <xref<br>
-          linkend="svn.advanced.props" />), revision timestamps can be<br>
-          changed to represent complete falsifications of true<br>
-          chronology, or even removed altogether.  Subversion's<br>
+        <para>Subversion's<br>
           ability to correctly convert revision dates into real<br>
           revision numbers depends on revision datestamps maintaining<br>
           a sequential ordering&mdash;the younger the revision, the<br>
@@ -319,7 +315,15 @@<br>
           younger its timestamp.  If this ordering isn't maintained,<br>
           you will likely find that trying to use dates to specify<br>
           revision ranges in your repository doesn't always return the<br>
-          data you might have expected.</para><br>
+          data you might have expected.<br>
+<br>
+          The <literal>svn:date</literal> timestamps are stored in<br>
+          unversioned, modifiable property of the revision (see <xref<br>
+            linkend="svn.advanced.props" />).  The most common reason<br>
+          for them to be unordered is loading history into an existing<br>
+          repository (see <xref linkend="svn.reposadmin.maint.<wbr>migrate"<br>
+            />).<br>
+        </para><br>
       </warning><br>
<br>
     </sect2><br>
<br>
______________________________<wbr>_________________<br>
svnbook-dev mailing list<br>
<a href="mailto:svnbook-dev@red-bean.com">svnbook-dev@red-bean.com</a><br>
<a href="http://www.red-bean.com/mailman/listinfo/svnbook-dev" rel="noreferrer" target="_blank">http://www.red-bean.com/<wbr>mailman/listinfo/svnbook-dev</a></blockquote></div><br></div>