diff options
author | kate.ward <kate.ward@forestent.com> | 2010-03-28 23:12:17 +0000 |
---|---|---|
committer | kate.ward <kate.ward@forestent.com> | 2010-03-28 23:12:17 +0000 |
commit | 929261fb95f6949701e1d93c8159c055fb21face (patch) | |
tree | 789ce9ba6e73dc8edb764cc376ea5ccc4f98987f /source/1.0/doc | |
parent | 93203d95ab0e7ca2493dc1046edf7a4b82287cd6 (diff) | |
download | shflags-929261fb95f6949701e1d93c8159c055fb21face.tar.gz |
fixed flakey functionality of booleans
Diffstat (limited to 'source/1.0/doc')
-rw-r--r-- | source/1.0/doc/CHANGES-1.0.txt | 7 | ||||
-rw-r--r-- | source/1.0/doc/RELEASE_NOTES-1.0.4.txt | 81 |
2 files changed, 86 insertions, 2 deletions
diff --git a/source/1.0/doc/CHANGES-1.0.txt b/source/1.0/doc/CHANGES-1.0.txt index 0ec3471..60e8040 100644 --- a/source/1.0/doc/CHANGES-1.0.txt +++ b/source/1.0/doc/CHANGES-1.0.txt @@ -4,8 +4,11 @@ Changes in shFlags 1.0.x Changes with 1.0.4 ------------------ -Fixed usage of ``expn`` under FreeBSD 7.2 (FreeNAS 0.7.1) that was causing many -unit tests to fail. +Fixed issue #10. Usage of ``expn`` under FreeBSD 7.2 (FreeNAS 0.7.1) and FreeBSD +8.0 that was causing many unit tests to fail. + +Fixed issue where booleans were sometimes mis-configured to require additional +values like other flags. Changes with 1.0.3 diff --git a/source/1.0/doc/RELEASE_NOTES-1.0.4.txt b/source/1.0/doc/RELEASE_NOTES-1.0.4.txt new file mode 100644 index 0000000..06cca0d --- /dev/null +++ b/source/1.0/doc/RELEASE_NOTES-1.0.4.txt @@ -0,0 +1,81 @@ +------------------------------ +shFlags.sh 1.0.4 Release Notes +------------------------------ + +Preface +======= +Copyright 2008-2009 Kate Ward. All Rights Reserved. +Released under the LGPL (GNU Lesser General Public 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 +------------- + +Obsolete items +-------------- + +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.5.6) 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. + +.. vim:fileencoding=latin1:ft=rst:spell:tw=80 |