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 3cc96d9fe7fe0da08932f19a0221b1a4f24ff6ad..1b8047750e80f269073083ff55c4cebc9d06fab7 100644 (file)
--- 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"
 # 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
 # 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`.
 #         * 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; }
 
 yell() { echo "$0: $*" >&2; }
 die() { yell "$*"; exit 111; }