From 79cb35dcab82101c36b5035f242d39d0e1593767 Mon Sep 17 00:00:00 2001
From: Steven Baltakatei Sandoval <baltakatei@gmail.com>
Date: Tue, 23 May 2023 02:11:01 +0000
Subject: [PATCH] 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.
---
 user/bkdatev | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

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; }
-- 
2.30.2