Skip to content

Clarify use of SOURCE_DATE_EPOCH environment variable. See #403. #421

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 28, 2025
Merged

Clarify use of SOURCE_DATE_EPOCH environment variable. See #403. #421

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions bin/genhtml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5471,12 +5471,19 @@ sub _computeAge
if ($then > $now) {
if (lcovutil::warn_once($lcovutil::ERROR_INCONSISTENT_DATA, $path)) {
# issue annotation warning at most once per file
# also attempt to clarify where the date comes from
my $data =
exists($ENV{SOURCE_DATE_EPOCH}) ?
"'SOURCE_DATE_EPOCH=$ENV{SOURCE_DATE_EPOCH}'" :
(
lcovutil::warn_once($lcovutil::ERROR_INCONSISTENT_DATA,
'SOURCE_DATE_EPOCH') ?
"computed from your 'SOURCE_DATE_EPOCH=$ENV{SOURCE_DATE_EPOCH}' environment variable - see 'man genhtml'"
:
"'SOURCE_DATE_EPOCH=$ENV{SOURCE_DATE_EPOCH}'") :
"'now'";

lcovutil::ignorable_error($lcovutil::ERROR_INCONSISTENT_DATA,
"File \"$path\": $data ($now) is older than annotate time '$when'"
"File \"$path\": '$now' ($data) is older than annotate time '$when'"
);
}
return 0;
Expand Down
3 changes: 2 additions & 1 deletion man/genhtml.1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1947,7 +1947,8 @@ The
.B \-\-date\-bins
option is used to specify age boundaries (cutpoints) for date\-binning classification. Each
.I age
element is expected to be an integer number of days prior to today (or SOURCE_DATE_EPOCH, if specified). If not specified, the default is to use 4 age ranges: less than 7 days, 7 to 30 days, 30 to 180 days, and more than 180 days.
element is expected to be an integer number of days prior to today (or prior to your SOURCE_DATE_EPOCH environment variable, if set). If
.I \-\-date\-bins is not specified, the default is to use 4 age ranges: less than 7 days, 7 to 30 days, 30 to 180 days, and more than 180 days.
This option is equivalent to the
.I genhtml_date_bins
config file option. See man
Expand Down