diff options
| author | Adam Spragg <adam@spra.gg> | 2022-05-18 16:35:35 +0100 |
|---|---|---|
| committer | Adam Spragg <adam@spra.gg> | 2022-05-24 10:12:33 +0100 |
| commit | 7292804c1bafd43389defc0d7b4352ada666d626 (patch) | |
| tree | 9e0390c7f45dd20b7db92d3f64bdcecaa3d9c1dc /metastore.txt | |
| parent | ce62a76e4570b6368384b3995c1ba106389df454 (diff) | |
Add ability to not save mtime in metadata files
If you're storing metadata in a version control system with multiple
branches, mtime differences are going to produce a whole bunch of
conflicts that you likely don't care about. This allows you to not
save mtime and avoid those.
Note that we use a sentinel value of -1 for the mentry `mtimensec` field
to indicate this in the data, as all values of `mtime` are theoretically
valid, but `mtimensec` must always be between 0 and 999,999,999 in the
real world.
I'm not 100% sure about the mechanism for selecting this feature. The
legacy behaviour for metastore was to save mtimes in the metadata files,
but ignore them for compare/apply by default, with a `--mtime` option to
use the mtime data.
Keeping the legacy behaviour for backwards compatibility, but adding a
`--no-mtime` option to ignore mtimes when saving felt like a reasonable
way of making this happen, but something about it doesn't feel great.
Maybe I just didn't figure out how to make the documentation clear
enough. ¯\_(ツ)_/¯
Diffstat (limited to 'metastore.txt')
| -rw-r--r-- | metastore.txt | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/metastore.txt b/metastore.txt index 39fdf5e..ba81a05 100644 --- a/metastore.txt +++ b/metastore.txt @@ -54,6 +54,9 @@ OPTIONS Causes metastore to also take mtime into account for the compare or apply actions. + -M, --no-mtime + Causes metastore to not save mtime in the metadata + -e, --empty-dirs Also attempts to recreate missing empty directories. May be use‐ ful where empty directories are not tracked (e.g. by git or @@ -100,7 +103,7 @@ FORMATS resentation of the 16-bit "file type and mode" field described in inode(7), and mtime is the ISO-8601 extended format represen‐ tation of the last-modified time in UTC, with nanosecond preci‐ - sion. + sion, or a literal "0" if mtime is not saved. Strings are URL-encoded, and all characters from 0x00 to 0x20 (inclusive), 0x25 (%) and 0x7F must be encoded. |