svn commit: r1805925 - /subversion/site/publish/docs/release-notes/1.10.html

[ko...@apache.org]

Author: kotkov
Date: Wed Aug 23 15:40:15 2017
New Revision: 1805925

URL: http://svn.apache.org/viewvc?rev=1805925&view=rev
Log:
Update LZ4 compression relnotes according to the recent changes in trunk.

* site/publish/docs/release-notes/1.10.html
  (lz4): Tweak the general description.  Note that now LZ4 is used by default
   in new and upgraded repositories.  For now, remove the paragraph about
   using LZ4 over http://, as it would be better to describe this in a
   separate section.  Place a note that this behavior doesn't apply to
   the pre-release Subversion 1.10.0-alpha3 version, as it still uses
   zlib compression by default.  Describe the new default settings and
   other possible configuration options in ...
  (fsfs-lz4-configuration): ...this new sub-section.

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

Modified: subversion/site/publish/docs/release-notes/1.10.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.10.html?rev=1805925&r1=1805924&r2=1805925&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.10.html (original)
+++ subversion/site/publish/docs/release-notes/1.10.html Wed Aug 23 15:40:15 2017
@@ -519,16 +519,16 @@ compression as an alternative to the <a
 compression that has been used in the previous versions.  LZ4 offers fast
 compression and decompression while still maintaining a decent compression
 ratio.  Using LZ4 compression can significantly improve performance of most
-of the Subversion operations for repositories with large and, possibly,
-incompressible files.
+of the Subversion read and write operations, especially for repositories
+containing large files.
 </p>
 
-<p>Currently, LZ4 compression can be enabled for the data transferred over
-http(s):// to Subversion 1.10 clients by setting the <tt>SVNCompressionLevel 1</tt>
-directive in <tt>mod_dav_svn</tt>.  Apart from this, it can also be enabled
-for the on-disk data in new repositories with filesystem format 8 (see below)
-by setting <tt>compression-level = 1</tt> in the <tt>fsfs.conf</tt>
-configuration file.</p>
+<p>LZ4 compression is now used by default for the on-disk data in repositories
+with filesystem format 8 (see below).</p>
+
+<p><b>Note:</b> this does not apply to the pre-release
+<a href="https://lists.apache.org/thread.html/dd78432b301f3f95567930c242c46b308c8a017fd754c0f388245915@%3Cannounce.subversion.apache.org%3E">Subversion 1.10.0-alpha3</a>
+version, which still uses zlib compression by default.
 
 <div class="h4" id="fsfs-format8">
 <h4>Filesystem format bump
@@ -536,15 +536,13 @@ configuration file.</p>
      title="Link to this section">&para;</a>
 </h4>
 
-<p>The default filesystem format is now a new format, numbered 8.
-(The <tt>svnadmin info</tt> command displays the filesystem format number
-of a repository.)</p>
-<p>The format bump is required to allow using LZ4 compression for the on-disk
-data.  In order to use LZ4 compression for existing data, it's required to
-perform a full
-<a href="http://svnbook.red-bean.com/en/1.8/svn.reposadmin.maint.html#svn.reposadmin.maint.migrate.svnadmin">dump/load</a>
-cycle into a new repository with configured <tt>compression-level = 1</tt>
-in the <tt>fsfs.conf</tt> configuration file.
+<p>The default filesystem format is now a new format, numbered 8.  The format
+bump is required to allow using LZ4 compression for the data that is stored
+on the disk.  (The <tt>svnadmin info</tt> command displays the filesystem
+format number of a repository.)</p>
+
+<p>Existing repositories can be upgraded to the new format with the
+<tt>svnadmin upgrade</tt> command.
 
 <div class="notice">
   <p><span style="color: red"><b>WARNING:</b></span> Until Subversion 1.10
@@ -555,6 +553,30 @@ in the <tt>fsfs.conf</tt> configuration
   for pre-releases</a> for additional information.</p>
 </div>
 
+<div class="h4" id="fsfs-lz4-configuration">
+<h4>Configuring the repository to use LZ4 compression
+  <a class="sectionlink" href="#fsfs-format8"
+     title="Link to this section">&para;</a>
+</h4>
+
+Repositories created with Subversion 1.10 and existing repositories
+upgraded to format 8 will by default compress new data using LZ4.
+The compression algorithm can also be configured explicitly by setting the
+<tt>compression = none | lz4 | zlib | zlib-1 ... zlib-9</tt> option in the
+<tt>fsfs.conf</tt> repository configuration file.</p>
+
+<p>Existing repositories with the configured <tt>compression-level</tt>
+option in the <tt>fsfs.conf</tt> configuration file will continue to use
+zlib compression.  In order to start using LZ4 compression for such
+repositories, consider setting the <tt>compression = lz4</tt> option
+in the <tt>fsfs.conf</tt> configuration file.</p>
+
+<p>In order to speed up read and write operations for existing repositories,
+consider recompressing the data stored in them with LZ4.  This can be achieved
+by performing a full
+<a href="http://svnbook.red-bean.com/en/1.8/svn.reposadmin.maint.html#svn.reposadmin.maint.migrate.svnadmin">dump/load</a>
+cycle into a new format 8 repository created with Subversion 1.10.
+
 </div>  <!-- fsfs-format8 -->
 
 </div>  <!-- lz4 -->