From: Stephen Seo Date: Tue, 25 Feb 2025 08:54:51 +0000 (+0900) Subject: Update README, Changelog X-Git-Tag: 1.18^2~5 X-Git-Url: https://git.seodisparate.com/stephenseo/js/darkmode.js?a=commitdiff_plain;h=1fd5f36d4a3b481dbf116a92a89211a4de72b9a3;p=SimpleArchiver Update README, Changelog --- diff --git a/Changelog.md b/Changelog.md index d3f2c2d..6670d7a 100644 --- a/Changelog.md +++ b/Changelog.md @@ -2,6 +2,11 @@ ## Upcoming Changes +Add file format version 4 to support more than 4 billion symlinks, and more +than 4 billion files. + +Some minor fixes. + ## Version 1.17 Fix `--whitelist-begins-with ` and `--whitelist-ends-with `. diff --git a/README.md b/README.md index 32a3129..a8bc6a9 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ API calls. --preserve-symlinks : preserve the symlink's path on archive creation instead of deriving abs/relative paths, ignores "--no-abs-symlink" (It is not recommended to use this option, as absolute-path-symlinks may be clobbered on extraction) --no-safe-links : keep symlinks that link to outside archive contents --temp-files-dir : where to store temporary files created when compressing (defaults to same directory as output file) - --write-version : Force write version file format (default 3) + --write-version : Force write version file format (default 4) --chunk-min-size : minimum chunk size (default 4194304 or 4MiB) when using chunks (file formats v. 1 and up) --no-pre-sort-files : do NOT pre-sort files by size (by default enabled so that the first file is the largest) --no-preserve-empty-dirs : do NOT preserve empty dirs (only for file format 2 and onwards) @@ -91,11 +91,14 @@ considered a new release/tag and/or stable. When compressing, it may be useful to set `--temp-files-dir ` as `simplearchiver` will create a temporary file (a chunk) usually in the current -working directory or in the directory specified by `-C ` by default. In -case the temporary file cannot be created in the default directory, +working directory or in the directory specified by `-C ` by default. Note +that in [Version 1.16, the default directory for temp files has been changed to +the directory holding the output archive +file](https://github.com/Stephen-Seo/SimpleArchiver/blob/dev/Changelog.md#version-116). +In case the temporary file cannot be created in the default directory, [`tmpfile()`](https://man7.org/linux/man-pages/man3/tmpfile.3.html) is used -instead as a fallback. Thus, `--temp-files-dir ` changes the default dir to -store the temporary compressed chunk. +instead as a fallback. Thus, `--temp-files-dir ` changes the default dir +to store the temporary compressed chunk. When storing symlinks, `simplearchiver` will typically store relative and absolute-paths for all symlinks. If a symlink points to something that will be