- quickstart: no segments in borg2 (packs/unreferenced-objects
wording); backend list is file:/rest: plus sftp/s3/b2; fix the
example script's exit-code handling for BORG_EXIT_CODES=modern
(highest-rc-wins ranked warnings 100..127 above errors 3..99 and
the rc==1 warning branch was dead) with a severity classifier;
regenerate the --stats and repo-list samples from real runs; make
the prose repo path match the script's rest:// URL; typos; correct
the repository model description (no manifest tracking blocks).
- repository-urls: use rest:// in the BORG_REPO example (ssh:// is
legacy-only, as the same file says).
- file-systems: rewrite for packs (chunks are grouped into pack files
of up to ~50 MB; compact works at pack granularity).
- resources: borg repo-delete (not "delete repo", not server-side);
replace the false "single-threaded, max 100% of one core" claim
with the real multi-threaded cases (zstd, blake3, pack writer).
- positional-arguments: drop borg1 repo::archive wording.
- config: fix the --print_config example (must precede the
subcommand) and the related prose.
- usage_general.rst.inc (man intro): add the archive-specification
and config includes that were only added to the usage variant when
the two files diverged (oversight from the #4587 split; the
archive-specification include uses :start-after: to avoid a
duplicate label).
- fix dead links: IEC binary prefixes (wikipedia anchor moved),
paperkey.html in the borg 1.x changelog.
- misc: update benchmark-crud commands to borg2 (with a note that the
numbers are borg1-era); add a preamble to create_chunker-params
noting it predates borg2/fastcdc.
Co-Authored-By: Claude Fable 5 <[email protected]>
Note: this is the default cache implementation in borg 1.x,
it worked well, but there were some issues:
- if the local chunks cache got out of sync with the repository,
it needed an expensive rebuild from the infos in all archives.
- to optimize that, a local chunks.archive.d cache was used to
speed that up, but at the price of quite significant space needs.
AdhocCacheWithFiles replaced this with a non-persistent chunks cache,
requesting all chunkids from the repository to initialize a simplified
non-persistent chunks index, that does not do real refcounting and also
initially does not have size information for pre-existing chunks.
We want to move away from precise refcounting, LocalCache needs to die.
One cannot "to not x", but one can "not to x".
Avoiding split infinitives gives the added bonus that machine
translation yields better results.
setup (n/adj) vs set(v) up. We don't "I setup it" but "I set it up".
Likewise for login(n/adj) and log(v) in, backup(n/adj) and back(v) up.
