1datalad check-dates(1)      General Commands Manual     datalad check-dates(1)
2
3
4

NAME

6       datalad check-dates - find repository dates that are more recent than a
7       reference date.
8

SYNOPSIS

10       datalad    check-dates    [-h]    [-D    DATE]     [--rev     REVISION]
11              [--annex   {all|tree|none}]  [--no-tags]  [--older]  [--version]
12              [PATH ...]
13
14
15

DESCRIPTION

17       The main purpose of this tool is to find "leaked" real dates in reposi‐
18       tories  that  are  configured  to  use fake dates. It checks dates from
19       three sources: (1) commit timestamps (author and committer dates),  (2)
20       timestamps  within  files  of the "git-annex" branch, and (3) the time‐
21       stamps of annotated tags.
22

OPTIONS

24       PATH   Root directory in which to search for Git repositories. The cur‐
25              rent  working  directory  will  be used by default. Constraints:
26              value must be a string or value must be NONE
27
28
29       -h, --help, --help-np
30              show this help message. --help-np forcefully disables the use of
31              a pager for displaying the help message
32
33       -D DATE, --reference-date DATE
34              Compare dates to this date. If dateutil is installed, this value
35              can be any format that  its  parser  recognizes.  Otherwise,  it
36              should  be  a unix timestamp that starts with a "@". The default
37              value corresponds to 01 Jan, 2018 00:00:00  -0000.  Constraints:
38              value must be a string [Default: '@1514764800']
39
40       --rev REVISION
41              Search timestamps from commits that are reachable from REVISION.
42              Any revision specification supported by git log, including flags
43              like  --all  and  --tags,  can be used. This option can be given
44              multiple times.
45
46       --annex {all|tree|none}
47              Mode for "git-annex" branch search. If 'all', all  blobs  within
48              the  branch are searched. 'tree' limits the search to blobs that
49              are referenced by the tree at the tip of the branch. 'none' dis‐
50              ables  search  of  "git-annex" blobs. Constraints: value must be
51              one of ('all', 'tree', 'none') [Default: 'all']
52
53       --no-tags
54              Don't check the dates of annotated tags.
55
56       --older
57              Find dates which are older than the reference date  rather  than
58              newer.
59
60       --version
61              show the module and its version which provides the command
62

AUTHORS

64        datalad is developed by The DataLad Team and Contributors <team@datal‐
65       ad.org>.
66
67
68
69datalad check-dates 0.19.3        2023-08-11            datalad check-dates(1)
Impressum