From ce8774c37ddf4d79c66ffbfedb00f7682d907ece Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 30 Jun 2022 17:50:29 -0500 Subject: [PATCH 2/2] =?UTF-8?q?Document=20that=20zic=20-r=20doesn=E2=80=99?= =?UTF-8?q?t=20necessarily=20shrink?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * zic.8: Mention that -r can grow output. --- zic.8 | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/zic.8 b/zic.8 index df09e1e..3f228a6 100644 --- a/zic.8 +++ b/zic.8 @@ -136,8 +136,7 @@ are possibly-signed decimal counts of seconds since the Epoch Omitted counts default to extreme values. The output files use UT offset 0 and abbreviation .q "\*-00" -in place of the omitted timestamp data; -this typically reduces the files' sizes. +in place of the omitted timestamp data. For example, .q "zic \*-r @0" omits data intended for negative timestamps (i.e., before the Epoch), and @@ -148,6 +147,14 @@ On platforms with GNU .BR date , .q "zic \-r @$(date +%s)" omits data intended for past timestamps. +Although this option typically reduces the output file's size, +the size can increase due to the need to represent the timestamp range +boundaries, particularly if +.I hi +causes a TZif file to contain explicit entries for +.RI pre- hi +transitions rather than concisely representing them +with an extended POSIX TZ string. Also see the .B "\*-b slim" option for another way to shrink output size. -- 2.36.1