Set need_name_pipe if --fuzzy was specified.
[rsync/rsync.git] / NEWS
diff --git a/NEWS b/NEWS
index a5f6260..4548af1 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -8,9 +8,10 @@ Changes since 2.6.3:
       it, it now appends a trailing slash to the name instead of (only
       sometimes) outputting a preceding "directory " string.
 
       it, it now appends a trailing slash to the name instead of (only
       sometimes) outputting a preceding "directory " string.
 
-    - The --stats output will contain file-list time statistics if both
+    - The --stats output will contain file-list time-statistics if both
       sides are 2.6.4, or if the local side is 2.6.4 and the files are
       being pushed (since the stats come from the sending side).
       sides are 2.6.4, or if the local side is 2.6.4 and the files are
       being pushed (since the stats come from the sending side).
+      (Requires protocol 29.)
   
   BUG FIXES:
 
   
   BUG FIXES:
 
@@ -18,8 +19,9 @@ Changes since 2.6.3:
       was only treating it as a special token in an rsync include/exclude
       file).
 
       was only treating it as a special token in an rsync include/exclude
       file).
 
-    - The --dry-run option (-n) now mentions changes in directories (w/-v).
-      It also now includes the normal uptodate output information for -vv.
+    - The combination of --verbose and --dry-run now mentions changes in
+      directories and it now includes the full update information that
+      would be output without --dry-run at higher levels of verbosity.
 
     - Avoid a mkdir warning when removing a directory in the destination
       that already exists in the --backup-dir.
 
     - Avoid a mkdir warning when removing a directory in the destination
       that already exists in the --backup-dir.
@@ -64,6 +66,14 @@ Changes since 2.6.3:
       if the block-size for a file was large enough (i.e. rsync might have
       exited with an error for large files).
 
       if the block-size for a file was large enough (i.e. rsync might have
       exited with an error for large files).
 
+    - If a daemon can't open the specified log file (i.e. syslog is not
+      being used), die without crashing.  We also try to output an error
+      about the failure (which will only be seen if --no-detach was
+      specified).
+
+    - A local transfer no longer duplicates all its include/exclude options
+      by sending the forked process a copy of the list it already has.
+
   ENHANCEMENTS:
 
     - Rsync now supports popt's option aliases, which means that you can
   ENHANCEMENTS:
 
     - Rsync now supports popt's option aliases, which means that you can
@@ -75,7 +85,14 @@ Changes since 2.6.3:
       default, before-the-transfer behavior of --delete).  Note that the
       --del option is implemented as an internally-defined popt alias, so
       an rsync daemon that refuses "delete" (which, for safety's sake,
       default, before-the-transfer behavior of --delete).  Note that the
       --del option is implemented as an internally-defined popt alias, so
       an rsync daemon that refuses "delete" (which, for safety's sake,
-      really matches "delete*") will still refuse all delete options.
+      really matches "delete*") will still refuse all delete options.  The
+      default --delete behavior is also explicitly selectable via
+      --delete-before.
+
+    - All the --delete-WHEN options are now more memory efficient:
+      Previously an entire duplicate set of file-list objects was created
+      on the receiving side for the entire destination hierarchy.  The new
+      algorithm only creates one directory of objects at a time.
 
     - Added the --copy-dest option, which works like --link-dest except
       that it includes copies of identical files.
 
     - Added the --copy-dest option, which works like --link-dest except
       that it includes copies of identical files.
@@ -96,14 +113,16 @@ Changes since 2.6.3:
       that cannot be exceeded by a user-specified --bwlimit option.
 
     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
       that cannot be exceeded by a user-specified --bwlimit option.
 
     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
-      the patches dir.)  Also added "address".
+      the patches dir.)  Also added "address".  A command-line option
+      will take precedence over a config-file option, as expected.
 
     - In _exit_cleanup(): when we are exiting with a partially-received
       file, we now flush any data in the write-cache before closing the
       partial file.
 
     - The --inplace support was enhanced to work with --compare-dest,
 
     - In _exit_cleanup(): when we are exiting with a partially-received
       file, we now flush any data in the write-cache before closing the
       partial file.
 
     - The --inplace support was enhanced to work with --compare-dest,
-      --link-dest, and (the new) --copy-dest options.
+      --link-dest, and (the new) --copy-dest options. (Requires protocol
+      29.)
 
     - Added the --dirs (-d) option for an easier way to copy directories
       without recursion.
 
     - Added the --dirs (-d) option for an easier way to copy directories
       without recursion.
@@ -120,7 +139,8 @@ Changes since 2.6.3:
       modified time for directories when --times was specified.  This
       option will avoid an extra pass through the file-list at the end of
       the transfer (to tweak all the directory times), which can result in
       modified time for directories when --times was specified.  This
       option will avoid an extra pass through the file-list at the end of
       the transfer (to tweak all the directory times), which can result in
-      an appreciable speedup for a really large transfer.
+      an appreciable speedup for a really large transfer. (Promoted from
+      the patches dir.)
 
     - Added the --filter (-f) option and its helper option, -F.  Filter
       rules are an extension to the existing include/exclude handling
 
     - Added the --filter (-f) option and its helper option, -F.  Filter
       rules are an extension to the existing include/exclude handling
@@ -128,7 +148,8 @@ Changes since 2.6.3:
       filter files (like .cvsignore, but with full filter-rule parsing).
       This new option was chosen in order to ensure that all existing
       include/exclude processing remained 100% compatible with older
       filter files (like .cvsignore, but with full filter-rule parsing).
       This new option was chosen in order to ensure that all existing
       include/exclude processing remained 100% compatible with older
-      versions.
+      versions.  (Protocol 29 needed for full filter-rule support, but
+      backward-compatible rules work with earlier protocol versions.)
 
     - Added the --delay-updates option that puts all updated files into
       a temporary directory (by default ".~tmp~", but settable via the
 
     - Added the --delay-updates option that puts all updated files into
       a temporary directory (by default ".~tmp~", but settable via the
@@ -138,6 +159,13 @@ Changes since 2.6.3:
     - If rsync is put into the background, any output from --progress is
       reduced.
 
     - If rsync is put into the background, any output from --progress is
       reduced.
 
+    - Documented the "max verbosity" setting for rsyncd.conf.  (This
+      setting was added a couple releases ago, but left undocumented.)
+
+    - The sender and the generator now double-check the file-list index
+      they are given, and refuse to operate on a directory index (since
+      that would indicate that something had gone very wrong).
+
   SUPPORT FILES:
 
     - Added support/atomic-rsync -- a perl script that will transfer some
   SUPPORT FILES:
 
     - Added support/atomic-rsync -- a perl script that will transfer some
@@ -159,6 +187,8 @@ Changes since 2.6.3:
       perl script.  This helps to ensure that only certain rsync commands
       can be run by an ssh invocation.
 
       perl script.  This helps to ensure that only certain rsync commands
       can be run by an ssh invocation.
 
+    - Improved the option descriptions in the --help text.
+
   INTERNAL:
 
     - Added better checking of the checksum-header values that come over
   INTERNAL:
 
     - Added better checking of the checksum-header values that come over
@@ -172,6 +202,50 @@ Changes since 2.6.3:
 
     - Got rid of the uint64 type (which we didn't need).
 
 
     - Got rid of the uint64 type (which we didn't need).
 
+    - Use a slightly more compatible set of core #include directives.
+
+    - Defined int32 in a way that ensures that the build dies if we can't
+      find a variable with at least 32 bits.
+
+  PROTOCOL DIFFERENCES FOR VERSION 29:
+
+    - If --inplace is specified, the generator sends an extra byte after
+      each index integer indicating what kind of basis file is being used
+      for the transfer (see the FNAMECMP_* defines).
+
+    - The sending of exclude names is done using filter-rule syntax.  This
+      means that all names have a prefixed rule indicator, even excludes
+      (which used to be sent as a bare pattern, when possible).  The -C
+      option will include the per-dir .cvsignore merge file in the list of
+      filter rules so it is positioned correctly (unlike in some older
+      transfer scenarios).
+
+    - Rsync sorts the filename list in a different way:  it sorts the
+      subdir names after the non-subdir names for each dir's contents, and
+      it always puts a dir's contents immediately after the dir's name in
+      the list.  (Previously an item named "foo.txt" would sort in between
+      directory "foo/" and "foo/bar".)
+
+    - When talking to a protocol 29 rsync daemon, a list-only request
+      is able to note this before the options are sent over the wire, and
+      the new --list-only option is enabled.
+
+    - When the --stats bytes are sent over the wire (or stored in a batch),
+      they now include two elapsed-time values: one for how long it took to
+      build the file-list, and one for how long it took to send it over the
+      wire (each expressed in thousandths of a second).
+
+    - When --delete-excluded is specified with some filter rules (AKA
+      excludes), a client sender will still initiate a send of the filter
+      rules to the receiver, but it only includes those rules that are
+      receiver-specific.  Older protocols used to omit the sending of
+      excludes in this situation (since there were no receiver-specific
+      rules that survived --delete-excluded back then).
+
+    - A protocol-29 batch file includes a bit for the setting of the --dirs
+      option.  Also, the shell script created by --write-batch will use the
+      --filter option instead of --exclude-from to capture any filter rules.
+
   BUILD CHANGES:
 
     - Handle an operating system that use mkdev() in place of makedev().
   BUILD CHANGES:
 
     - Handle an operating system that use mkdev() in place of makedev().