From: Steven Baltakatei Sandoval <baltakatei@gmail.com>
Date: Tue, 23 May 2023 02:11:01 +0000 (+0000)
Subject: doc(user/bkdatev):Add comment warning about macOS compatibility
X-Git-Tag: 0.8.2^2~6
X-Git-Url: https://zdv2.bktei.com/gitweb/BK-2020-03.git/commitdiff_plain/79cb35dcab82101c36b5035f242d39d0e1593767

doc(user/bkdatev):Add comment warning about macOS compatibility

- Note: Basically, the `bkdatev` command by itself should work with
  macOS 11.1. Additional arguments are passed along to `date` so the
  provided example (`bkdatev --date="2001-09-11T09:02:59-04"`) will fail
  due to BSD `date` not accepting ISO-8601 date strings like GNU
  Coreutils `date` does.
---

diff --git a/user/bkdatev b/user/bkdatev
index 3cc96d9..1b80477 100644
--- a/user/bkdatev
+++ b/user/bkdatev
@@ -2,7 +2,8 @@
 # Desc: Baltakatei's verbose date command
 # Usage: bkdatev [args]
 # Example: bkdatev --date="2001-09-11T09:02:59-04"
-# Version: 0.3.1
+# Version: 0.3.2
+# Depends: GNU Coreutils 8.32, Bash 3.2.57
 # Ref/Attrib: [1] "ISO 8601". Wikipedia. https://en.wikipedia.org/wiki/ISO_8601
 #             [2] "Changing the Locale in Wine" https://stackoverflow.com/a/16428951
 #             [3] "Shanghai vs Beijing" https://bugs.launchpad.net/ubuntu/+source/libgweather/+bug/228554
@@ -11,6 +12,9 @@
 #         * For list of valid locales, see: https://manpages.ubuntu.com/manpages/bionic/man3/DateTime::Locale::Catalog.3pm.html
 #         * Locations chosen for population, personal signifiance, and spatial coverage.
 #         * For International Atomic Time (TAI), use offsets from UTC provided in `/usr/share/zoneinfo/leap-seconds.list`.
+#         * Compatibility with macOS may be limited if any arguments
+#             are provided when running `bkdatev`; e.g. passing a
+#             `--date` option to `bkdatev` will fail.
 
 yell() { echo "$0: $*" >&2; }
 die() { yell "$*"; exit 111; }