Page MenuHomeFreeBSD

date: refer to tzdata as a 'distribution' rather than 'package'
ClosedPublic

Authored by kevans on Wed, Jul 27, 5:33 PM.

Details

Summary

This is perhaps a bit pedantic, but one could misunderstand the use of
'package' here to mean a package provided by pkg, rather than the fact
that we use the distributable package provided by the tzdata project.

Sponsored by: Klara, Inc.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

This revision is now accepted and ready to land.Wed, Jul 27, 6:03 PM

I agree "package" is unclear, but I have mixed feelings about "distribution". "tzdata data" read weirdly to me, so what about "information"?

I agree "package" is unclear, but I have mixed feelings about "distribution". "tzdata data" read weirdly to me, so what about "information"?

"tzdata files"?

(But I think "tzdata distribution" is fine.)

philip requested changes to this revision.Thu, Jul 28, 1:57 AM

The maintainers of the time zone database consistently use the term "database" to refer to the data. The term "distribution" in the tz context refers exclusively to the tarballs (tzcode, tzdata and tzdb).

I would suggest using database in preference to package or distribution too. I agree that package is ambiguous.

Something like this could work:

which contains the time zone definitions from the IANA Time Zone Database
.Sy (tzdata) .

Or:

...Time Zone Database
.Sy tzdata ,
distributed by IANA.

Or something along those lines.

This revision now requires changes to proceed.Thu, Jul 28, 1:57 AM

Change course, expand tzdata to "IANA Time Zone Database (tzdata)" on first use,
then just call it "tzdata" in later references without trying to call it a
distribution or package.

Good compromise! Thank you.

This revision is now accepted and ready to land.Thu, Jul 28, 6:25 AM