Merge pull request #9807 from ThomasWaldmann/update-changes-1.4

Update changes (1.4-maint)

Author: ThomasWaldmann

docs/changes.rst

@@ -422,25 +422,28 @@ above.
 
 New features:
 
-- create/import-tar --quick-stats: faster than --stats by omitting "All archives"
-  and repository chunk statistics, #9579
-- delete/prune --quick-stats: faster than --stats by omitting "All archives" statistics, #9757
+- create/import-tar/delete/prune --quick-stats: faster than --stats by omitting "All archives"
+  and repository chunk statistics, #9579, #9757
 - prune: show total vs matching archives in output, #9262
+- create --exclude-dataless: macOS: skip cloud files not materialized locally, #9746
 - Minimal implementation of "related repositories", #9645
 
-  This feature allows multiple repositories to share deduplication-relevant secrets (id_key and chunk_seed) while maintaining secure, independent encryption keys.
+  This feature allows multiple repositories to share deduplication-relevant secrets
+  (id_key and chunk_seed) while maintaining secure, independent encryption keys.
 
   - borg key export-related-secrets <REPO> <SPATH>
   - borg init --import-related-secrets <SPATH> <REPO>
 
-
 Fixes:
 
-- hashindex: fix new checks for big endian archs, #9521
+- Archive.delete: don't reuse msgpack Unpacker after an unpacking failure
 - slashdot hack: fix exclusion of source directory metadata, #9534
+- hashindex: fix new checks for big endian archs, #9521
 
-Note: Many of the fixed issues listed below relate to rather rare or theoretical
-      issues and were found by automated code checking.
+Note:
+
+    Many of the fixed issues listed below relate to rather rare or theoretical
+    issues and were found by automated code checking.
 
 - LRUCache: resolve KeyError and memory leaks, #9587
 - crypto.low_level: fix freeing of memory, #9585
@@ -473,10 +476,15 @@ Note: Many of the fixed issues listed below relate to rather rare or theoretical
 
 Other changes:
 
-- msgpack: also allow 1.2.0 and 1.2.1
+- msgpack: also allow up to 1.2.1
 - use F_FULLFSYNC on macOS for SyncFile data durability, #9383
 - mount: improve error msg when uid/gid cannot be resolved, #9574
+- properly handle invalid and dev versions in version parser, fixes #9014
+- tests: reset borg.output.progress logger between tests to fix flakiness
 - docs:
+
+  - borgbackup.readthedocs.io: offer PDF and html downloads in sidebar, #9731
+  - fix 'borg key change-passphrase' docs, #9697
   - impact of the slashdot hack on pattern matching, #9647
   - pull-backup.rst minor fixes
   - sshfs + chroot does not support different CPU architectures, #6878
@@ -490,6 +498,7 @@ Other changes:
   - improve macOS Keychain instructions, #5156
   - add DoS warning for none encryption mode, #6715
   - document error handling in borg create, #4912
+  - update year in LICENSE and docs/conf.py
 
 
 Version 1.4.4 (2026-03-19)

docs/man/borg-benchmark-crud.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-benchmark-crud" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-benchmark-crud" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-benchmark-crud \- Benchmark Create, Read, Update, Delete for archives.
 .SH SYNOPSIS

docs/man/borg-benchmark.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-benchmark" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-benchmark" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-benchmark \- benchmark command
 .SH SYNOPSIS

docs/man/borg-break-lock.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-break-lock" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-break-lock" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-break-lock \- Break the repository lock (e.g. in case it was left by a dead borg.
 .SH SYNOPSIS

docs/man/borg-check.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-check" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-check" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-check \- Check repository consistency
 .SH SYNOPSIS

docs/man/borg-common.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-common" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-common" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-common \- Common options of Borg commands
 .SH SYNOPSIS

docs/man/borg-compact.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-compact" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-compact" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-compact \- compact segment files in the repository
 .SH SYNOPSIS

docs/man/borg-compression.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-compression" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-compression" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-compression \- Details regarding compression
 .SH DESCRIPTION

docs/man/borg-config.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-config" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-config" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-config \- get, set, and delete values in a repository or cache config file
 .SH SYNOPSIS
@@ -97,6 +97,12 @@ $ borg config /path/to/repo additional_free_space 2G
 
 # make a repo append\-only
 $ borg config /path/to/repo append_only 1
+
+# set storage quota to 50 GB
+$ borg config /path/to/repo storage_quota 50G
+
+# set maximum segment size to 100 MiB (see \(dqAdjusting segment size\(dq in Usage Notes)
+$ borg config /path/to/repo max_segment_size 104857600
 .EE
 .UNINDENT
 .UNINDENT

docs/man/borg-create.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "borg-create" "1" "2026-03-18" "" "borg backup tool"
+.TH "borg-create" "1" "2026-06-25" "" "borg backup tool"
 .SH Name
 borg-create \- Create new archive
 .SH SYNOPSIS
@@ -132,7 +132,9 @@ the currently processed path.
 When using \fB\-\-stats\fP, you will get some statistics about how much data was
 added \- the \(dqThis Archive\(dq deduplicated size there is most interesting as that is
 how much your repository will grow. Please note that the \(dqAll archives\(dq stats refer to
-the state after creation. Also, the \fB\-\-stats\fP and \fB\-\-dry\-run\fP options are mutually
+the state after creation. \fB\-\-stats\fP can be slow \- if you want something faster, use
+\fB\-\-quick\-stats\fP (this skips the repository\-wide \(dqAll archives\(dq and chunk index statistics).
+The \fB\-\-stats\fP / \fB\-\-quick\-stats\fP and \fB\-\-dry\-run\fP options are mutually
 exclusive because the data is not actually compressed and deduplicated during a dry run.
 .sp
 For more help on include/exclude patterns, see the \fIborg_patterns\fP command output.
@@ -159,6 +161,9 @@ do not create a backup archive
 .B  \-s\fP,\fB  \-\-stats
 print statistics for the created archive
 .TP
+.B  \-\-quick\-stats
+print only archive statistics, skipping repository\-wide statistics
+.TP
 .B  \-\-list
 output verbose list of items (files, dirs, ...)
 .TP
@@ -221,6 +226,9 @@ if tag objects are specified with \fB\-\-exclude\-if\-present\fP, don\(aqt omit
 .TP
 .B  \-\-exclude\-nodump
 exclude files flagged NODUMP
+.TP
+.B  \-\-exclude\-dataless
+exclude files flagged DATALESS (macOS: placeholder files whose content is not materialized locally, e.g. not\-downloaded cloud storage files)
 .UNINDENT
 .SS Filesystem options
 .INDENT 0.0
@@ -405,6 +413,22 @@ Linux examples for this are bind mounts (possibly same device number, but always
 subvolumes of a Btrfs file system (different device numbers from the parent but not necessarily mount points).
 macOS examples are the APFS mounts of a typical macOS installation.
 Therefore, when using \fB\-\-one\-file\-system\fP, you should double\-check that the backup works as intended.
+.SS Error handling
+.sp
+When Borg encounters a file or directory it cannot read (e.g., due to permission
+denied, or another process holding an exclusive lock on Windows), it will:
+.INDENT 0.0
+.IP \(bu 2
+Log a warning message.
+.IP \(bu 2
+Skip that file or directory and continue backing up the remaining files.
+.IP \(bu 2
+Exit with a Warning RC at the end of the operation.
+.UNINDENT
+.sp
+This ensures that a single problematic file does not abort your entire backup.
+You should check your logs for these warnings to ensure that all important data
+is being backed up.
 .SS Item flags
 .sp
 \fB\-\-list\fP outputs a list of all files, directories and other