diff options
Diffstat (limited to 'doc/RELEASE_NOTES-1.0.4.md')
-rw-r--r-- | doc/RELEASE_NOTES-1.0.4.md | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/doc/RELEASE_NOTES-1.0.4.md b/doc/RELEASE_NOTES-1.0.4.md new file mode 100644 index 0000000..30e75a8 --- /dev/null +++ b/doc/RELEASE_NOTES-1.0.4.md @@ -0,0 +1,81 @@ +# shFlags.sh 1.0.4 Release Notes + +Preface +======= + +Copyright 2008-2009 Kate Ward. All Rights Reserved. +Released under the Apache License. +Author: kate.ward@forestent.com (Kate Ward) + +This document covers any known issues and workarounds for the stated release of +shFlags. + +Release info +============ + +This is a minor bug fix release. + +Please see the `CHANGES-1.0.txt` file for a complete list of changes. + +Major changes +------------- + +Changed from the LGPL v2.1 license to the Apache v2.0 license so that others can +include the library or make changes without needing to release the modified +source code as well. + +Obsolete items +-------------- + +None + +Bug fixes +--------- + +Issue #10 - Changed the internal usage of the `expn` command to fix issues +under FreeBSD. + +General info +============ + +The unit tests +-------------- + +shFlags is designed to work on as many environments as possible, but not all +environments are created equal. As such, not all of the unit tests will succeed +on every platform. The unit tests are therefore designed to fail, indicating to +the tester that the supported functionality is not present, but an additional +test is present to verify that shFlags properly caught the limitation and +presented the user with an appropriate error message. + +shFlags tries to support both the standard and enhanced versions of `getopt`. +As each responds differently, and not everything is supported on the standard +version, some unit tests will be skipped (i.e. ASSERTS will not be thrown) when +the standard version of `getopt` is detected. The reason being that there is +no point testing for functionality that is positively known not to exist. A +tally of skipped tests will be kept for later reference. + +Standard vs Enhanced getopt +--------------------------- + +Here is a matrix of the supported features of the various `getopt` variants. + +| Feature | std | enh | +|-----------------------------------------|-----|-----| +| short option names | Y | Y | +| long option names | N | Y | +| spaces in string options | N | Y | +| intermixing of flag and non-flag values | N | Y | + +Known Issues +------------ + +The `getopt` version provided by default with all versions of Mac OS X (up to +and including 10.10.2) and Solaris (up to and including Solaris 10 and +OpenSolaris) is the standard version. + +Workarounds +----------- +The Zsh shell requires the `shwordsplit` option to be set and the special +`FLAGS_PARENT` variable must be defined. See `src/shflags_test_helpers` to +see how the unit tests do this. |