diff options
| author | Klaus Aehlig <klaus.aehlig@huawei.com> | 2024-05-03 11:05:50 +0200 |
|---|---|---|
| committer | Klaus Aehlig <klaus.aehlig@huawei.com> | 2024-05-03 12:35:01 +0200 |
| commit | 981a4646a99740a3e02564845b3164a30c2554a5 (patch) | |
| tree | ab6cabe2073c8a41fe20c608b964cb3a47a3dc78 | |
| parent | 8b86f071ae7f2100c0a03c2869f8fcc83a048583 (diff) | |
| download | justbuild-981a4646a99740a3e02564845b3164a30c2554a5.tar.gz | |
Update man page and CHANGELOG to reflect blob splitting
| -rw-r--r-- | CHANGELOG.md | 8 | ||||
| -rw-r--r-- | share/man/just.1.md | 11 |
2 files changed, 17 insertions, 2 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md index 2419a0fe..15608eb0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,8 +36,12 @@ A feature release on top of `1.2.0`, backwards compatible. - Support for fetching archives from FTP and TFTP was added to `just-mr` if it was built with bundled curl. For package builds, libcurl has enabled whatever the distro considers suitable. -- The `gc` subcommand supports an option `--no-rotate` to carry out - only local clean up. +- The `gc` subcommand supports an option `--no-rotate` to carry + out only local clean up. Part of that local clean up, that is + also done as part of a full `gc`, is splitting large files. Note + that stable versions before `1.3.0` cannot use those split files. + Hence a downgrade after a `gc` with `1.3.0` (or higher) requires + cleaning of cache and CAS. - The expression language has been extended and, in particular, allows indexed access to an array (basically using it as a tuple) and a generic form of assertion (to report user errors). diff --git a/share/man/just.1.md b/share/man/just.1.md index f4d613bf..ccd1964e 100644 --- a/share/man/just.1.md +++ b/share/man/just.1.md @@ -277,6 +277,17 @@ to the youngest generation; therefore, upon a call to **`gc`** everything not referenced since the last call to **`gc`** is purged and the corresponding disk space reclaimed. +Additionally, and before doing generation rotation, + - left-over temporary directories (e.g., from interrupted `just` + invocations) are removed, and + - large files are split and only the chunks and the information + how to assemble the file from the chunks are kept; in this way + disk space is saved without losing information. + +As the non-rotating tasks can be useful in their own right, the +`--no-rotate` option can be used to request only the clean-up tasks +that do not lose information. + **`execute`** ------------- |