This helper script exists to create the generated files that are needed
[rsync/rsync.git] / NEWS
diff --git a/NEWS b/NEWS
index f45d762..e8b87a3 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -2,14 +2,24 @@ NEWS for rsync 3.0.0 (UNRELEASED)
 Protocol: 30 (changed)
 Changes since 2.6.9:
 
-  NOTABLE CHANGE IN BEHAVIOR:
+  NOTABLE CHANGES IN BEHAVIOR:
 
-   - The handling of implied directories when using --relative has changed
-     to send them as directories (e.g. no implied dir is ever sent as a
-     symlink).  This avoids unexpected behavior and should not adversely
-     affect most people.  If you're one of those rare people who relied
-     upon having an implied dir be duplicated as a symlink, either specify
-     --keep-dirlinks or --no-implied-dirs.
+    - The handling of implied directories when using --relative has changed to
+      send them as directories (e.g. no implied dir is ever sent as a symlink).
+      This avoids unexpected behavior and should not adversely affect most
+      people.  If you're one of those rare individuals who relied upon having
+      an implied dir be duplicated as a symlink, you should specify the
+      transfer of the symlink and the transfer of the referent directory as
+      separate args.  (See also --keep-dirlinks and --no-implied-dirs.)
+
+    - Requesting a remote file list without specifying -r (--recursive) now
+      sends the -d (--dirs) option to the remote rsync rather than sending -r
+      along with an extra exclude of /*/*.  If the remote rsync does not
+      understand the -d option (i.e. it is 2.6.3 or older), you will need to
+      either turn off -d (--no-d), or specify  -r --exclude='/*/*'  manually.
+
+    - In --dry-run mode, the last line of the verbose summary text is output
+      with a "(DRY RUN)" suffix to help remind you that no updates were made.
 
   BUG FIXES:
 
@@ -17,18 +27,18 @@ Changes since 2.6.9:
       it now itemizes all the items, not just the changed ones.
 
     - Made the output of all file types consistent when using a --*-dest
-      option.  Prior versions used to output too many creation events for
+      option.  Prior versions would output too many creation events for
       matching items.
 
     - The code that waits for a child pid now handles being interrupted by a
       signal.  This fixes a problem with the pre-xfer exec function not being
       able to get the exit status from the script.
 
-    - A negated filter rule (with a '!' modifier) no longer loses the negation
-      when sending the filter rules to the remote rsync.
+    - A negated filter rule (i.e. with a '!' modifier) no longer loses the
+      negation when sending the filter rules to the remote rsync.
 
     - Fixed a problem with the --out-format (aka --log-format) option %f:  it
-      would output superfluous directory information for a non-daemon rsync.
+      no longer outputs superfluous directory info for a non-daemon rsync.
 
     - Fixed a problem with -vv (double --verbose) and --stats when "pushing"
       files (which includes local copies).  Version 2.6.9 would complete the
@@ -55,12 +65,21 @@ Changes since 2.6.9:
     - Fixed a bug when using --backup and --inplace with --whole-file or
       --read-batch: backup files are actually created now.
 
-    - Starting up an extra copy of an rsync daemon does not delete the pidfile
-      for the running daemon -- if the pidfile exists, the extra program will
-      exit with an error.
+    - Starting up an extra copy of an rsync daemon will not clobber the pidfile
+      for the running daemon -- if the pidfile exists, the new daemon will exit
+      with an error.
 
     - The daemon pidfile is checked and created sooner in the startup sequence.
 
+    - If a daemon module's "path" value is not an absolute pathname, the code
+      now makes it absolute internally (making it work properly).
+
+    - Ensure that a temporary file always has owner-write permission while we
+      are writing to it.  This avoids problems with some network filesystems.
+
+    - Any errors output about password-file reading no longer cause an error at
+      the end of the run about a partial transfer.
+
   ENHANCEMENTS:
 
     - A new incremental-recursion algorithm is now used when rsync is talking
@@ -68,7 +87,7 @@ Changes since 2.6.9:
       (before all the files have been found), and requires much less memory.
       See the --recursive option in the manpage for some restrictions.
 
-    - Saved memory in the non-incremental-recursion algorithm for typical
+    - Lowered memory use in the non-incremental-recursion algorithm for typical
       option values (usually saving from 21-29 bytes per file).
 
     - The default --delete algorithm is now --delete-during when talking to a
@@ -78,26 +97,33 @@ Changes since 2.6.9:
 
     - Rsync now allows multiple remote-source args to be specified rather than
       having to rely on a special space-splitting side-effect of the remote-
-      shell.  Additional remote args must specify the same host or have an
-      empty hostname, as seen here:  :file1  ::module/file2.  This means that
-      local use of brace expansion now works:  rsync -av host:path/{f1,f2} .
+      shell.  Additional remote args must specify the same host or an empty one
+      (e.g. empty:  :file1  or  ::module/file2).  This means that local use of
+      brace expansion now works:  rsync -av host:dir/{f1,f2} .
+
+    - Added the --protect-args (-s) option, that tells rsync to send most of
+      the command-line args at the start of the transfer rather than as args
+      to the remote-shell command.  This protects them from space-splitting,
+      and only interprets basic wildcard special shell characters (*?[).
 
     - Added the --delete-delay option, which is a more efficient way to delete
       files at the end of the transfer without needing a separate delete pass.
 
     - Added the --acls (-A) option to preserve Access Control Lists.  This is
       an improved version of the prior patch that was available, and it even
-      supports OS X ACLs.  (If you need to have backward compatibility with
-      old, patched versions of rsync, apply the acls.diff file from the patches
-      dir.)
+      supports OS X ACLs.  If you need to have backward compatibility with old,
+      acl-patched versions of rsync, apply the acls.diff file from the patches
+      dir.
 
     - Added the --xattrs (-X) option to preserver extended attributes.  This is
-      an improved version of the prior patch that was available.  (If you need
-      to have backward compatibility with old, patched versions of rsync, apply
-      the xattrs.diff file from the patches dir.)
+      an improved version of the prior patch that was available, and it even
+      supports OS X xattrs (which includes their resource fork data).  If you
+      need to have backward compatibility with old, xattr-patched versions of
+      rsync, apply the xattrs.diff file from the patches dir.
 
     - Added the --fake-super option that allows a non-super user to preserve
       all attributes of a file by using a special extended-attribute idiom.
+      It even supports the storing of foreign ACL data on your backup server.
       There is also an analogous "fake super" option for an rsync daemon.
 
     - Added the --iconv option, which allows rsync to convert filenames from
@@ -107,10 +133,10 @@ Changes since 2.6.9:
       rebuild.  If you want rsync to perform character-set conversions by
       default, you can specify --enable-iconv=CONVERT_STRING with the default
       value for the --iconv option that you wish to use.  For example,
-      --enable-iconv=. is a good choice.  See the rsync manpage for an
+      "--enable-iconv=." is a good choice.  See the rsync manpage for an
       explanation of the --iconv option's settings.
 
-    - Added the --skip-compress=LIST option to override of the default list of
+    - Added the --skip-compress=LIST option to override the default list of
       file suffixes that will not be compressed when using --compress.
       
     - The daemon's default for "dont compress" was extended to include:
@@ -147,9 +173,6 @@ Changes since 2.6.9:
 
     - Protocol 30 now uses MD5 checksums instead of MD4.
 
-    - If a daemon module's "path" value is not an absolute pathname, the code
-      now makes it absolute internally (making it work properly).
-
     - Changed the --append option to not checksum the existing data in the
       destination file, which speeds up file appending.
 
@@ -161,11 +184,6 @@ Changes since 2.6.9:
     - Documented and extended the support for the RSYNC_CONNECT_PROG variable
       that can be used to enhance the client side of a daemon connection.
 
-    - Added the --protect-args (-s) option, that tells rsync to send most of
-      the command-line args at the start of the transfer rather than as args
-      to the remote-shell command.  This protects them from space-splitting,
-      and only interprets basic wildcard special shell characters (*?[).
-
     - Improved the dashes and double-quotes in the nroff manpage output.
 
     - We now support a lot more --no-OPTION override options.
@@ -205,6 +223,10 @@ Changes since 2.6.9:
     - Improved J.W.'s pool_alloc routines to add a way of freeing older
       sections of a pool's memory.
 
+    - The getaddrinfo.c compatibility code in the "lib" dir was replaced with
+      some new code (derived from samba, derived from PostgreSQL) that has a
+      better license than the old code.
+
   DEVELOPER RELATED:
 
     - Rsync is now licensed under the GPLv3 or later.
@@ -213,11 +235,13 @@ Changes since 2.6.9:
       directory named testtmp (which is created, if missing).  This allows
       someone to symlink the testtmp directory to another filesystem (which is
       useful if the build dir's filesystem does not support ACLs and xattrs,
-      and another file system does).
+      but another file system does).
 
     - Rsync now has a way of handling protocol-version changes during the
-      development of a new protocol version.  This exchange of sub-version
-      info does not interfere with the {MIN,MAX}_PROTOCOL_VERSION checking
-      in older versions (since we'd quickly exceed the MAX_PROTOCOL_VERSION
-      if we incremented the main PROTOCOL_VERSION value for every minor
-      change during development).
+      development of a new protocol version.  This causes any out-of-sync
+      versions to speak an older protocol rather than fail in a cryptic manner.
+      This addition makes it safe to deploy a pre-release version that may
+      interact with the public.  This new exchange of sub-version info does not
+      interfere with the {MIN,MAX}_PROTOCOL_VERSION checking algorithm (which
+      does not have enough range to allow the main protocol number to be
+      incremented for every minor tweak in that happens during development).