svn commit: r1697932 - /subversion/site/publish/docs/release-notes/1.9.html

[st...@apache.org]

Author: stefan2
Date: Wed Aug 26 13:44:40 2015
New Revision: 1697932

URL: http://svn.apache.org/r1697932
Log:
In the 1.9 release notes, document the issues and workarounds for
svnfsfs load-index in 1.9.0.

* publish/docs/release-notes/1.9.html
  (svnfsfs-index-manipulation): Add reference to the "known issues" section.
  (svnfsfs-issues): New "known issues" section.

Modified:
    subversion/site/publish/docs/release-notes/1.9.html

Modified: subversion/site/publish/docs/release-notes/1.9.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.9.html?rev=1697932&r1=1697931&r2=1697932&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.9.html (original)
+++ subversion/site/publish/docs/release-notes/1.9.html Wed Aug 26 13:44:40 2015
@@ -609,7 +609,8 @@ contents, updating the index data after
 manipulation is mandatory in format 7. <tt>svnfsfs load-index</tt>
 allows you to do that.  It consumes the same table format as produced
 above, except that the checksum field is optional and will be ignored
-if given.
+if given.  See <a href="#svnfsfs-issues">the known issues list</a>
+for problems in released versions of that tool.
 </p>
 
 <div class="notice">
@@ -620,6 +621,39 @@ if given.
 
 </div>  <!-- svnfsfs-index-manipulation -->
 
+<div class="h4" id="svnfsfs-issues">
+<h4>Known issues
+  <a class="sectionlink" href="#svnfsfs-issues"
+    title="Link to this section">&para;</a>
+</h4>
+
+<p>In 1.9.0, the <tt>svnfsfs load-index</tt> does not work as described
+in its documentation.  The following restrictions and workarounds apply:
+</p>
+
+<ul>
+  <li>The lines must be sorted by offset (first column).</li>
+  <li>The item number (5th column) must be given as hexadecimal.  However,
+      <tt>svnfsfs dump-index</tt> produces decimal numbers in that column.
+  </li>
+  <li>The first entry must refer to the first revision in the pack file.
+      This is a non-issue for unpacked revisions. A simple solution is
+      inserting a line for empty section of length 0: 
+  </li>
+<pre>
+       Start       Length Type   Revision     Item 
+           0            0 none       3000        0
+           0          25a chgs       3999        1
+         25a          3b9 chgs       3998        1
+       ...
+</pre>
+</ul>
+
+<p>Later 1.9.x releases will likely fix these problems.
+</p>
+
+</div>  <!-- svnfsfs-issues -->
+
 </div>  <!-- svnfsfs -->
 
 <div class="h3" id="fsx">