Merge branch 'docs/readme-refresh' into dev

# Conflicts:
#	README.md

src/client/client_cli.c

@@ -1206,17 +1206,20 @@ static bool cli_handle_meta_flags(CliParseCtx* ctx) {
     return true;
   }
   if (opt_is(arg, "-a", "--archive")) {
-    /* Real rsync archive (-rlptgoD).  FastSync is always recursive and always
+    /* FastSync archive mode (-rlptD).  FastSync is always recursive and always
      * preserves hard-link/other transfer semantics per its own flags, so -a
-     * implies links, full metadata (perms/times/group/owner as FastSync's
-     * broad bundle), devices and specials.  Compression and multithreading
-     * are NOT implied (they are no longer part of archive mode). */
+     * implies links, metadata (perms/times), devices and specials.  Owner/group
+     * are NOT implied; they require an explicit identity flag
+     * (--numeric-ids/--usermap/--groupmap/--chown/--copy-as).  Compression and
+     * multithreading are NOT implied either (they are no longer part of
+     * archive mode). */
     config->follow_symlinks = true;
     config->use_metadata = true;
     config->preserve_devices = true;
     config->preserve_specials = true;
     log_info_message(LOG_INFO_MISC,
-                     "Enabled archive mode (-rlptgoD: links, metadata, devices, specials)");
+                     "Enabled archive mode (-rlptD: links, metadata, devices, specials; "
+                     "owner/group opt-in)");
     return true;
   }
   if (opt_is(arg, "-p", "--perms")) {

src/client/usage.c

@@ -20,8 +20,9 @@ void print_usage(void) {
   printf("Options:\n");
   printf("  -c, --checksum      Verify content by checksum instead of size+mtime\n");
   printf("  -z, --compress [level]  Enable compression (level 1-22, default 5)\n");
-  printf("  -a, --archive       rsync archive mode (-rlptgoD): links, metadata,\n");
-  printf("                      devices and specials (not compression/multithreading)\n");
+  printf("  -a, --archive       rsync archive mode (-rlptD): links, perms, times,\n");
+  printf("                      devices and specials; owner/group are not implied;\n");
+  printf("                      not compression/multithreading\n");
   printf("  -n, --dry-run       Show what would be transferred\n");
   printf("  --remove-source-files  Remove regular source files after successful transfer\n");
   printf("  -p, --perms         Preserve permission bits (part of the metadata bundle)\n");
@@ -162,6 +163,9 @@ void print_usage(void) {
   printf("                      none suppresses info even with --verbose\n");
   printf("  --preserve          Preserve file metadata (long form only)\n");
   printf("  -E, --executability Preserve executable permission bits\n");
+  printf("  -U, --atimes        Preserve access times\n");
+  printf("  -N, --crtimes       Capture birth time; cannot be applied (documented\n");
+  printf("                      divergence)\n");
   printf("  -X, --xattrs        Preserve user extended attributes (user.* only;\n");
   printf("                      privileged security.*/trusted.* namespaces are\n");
   printf("                      never captured or applied)\n");