kate.ward | 1469dda | 2008-11-17 17:56:43 +0000 | [diff] [blame] | 1 | ------------------------------ |
| 2 | shFlags.sh 1.0.1 Release Notes |
| 3 | ------------------------------ |
| 4 | |
| 5 | Preface |
| 6 | ------- |
| 7 | Copyright 2008 Kate Ward. All Rights Reserved. |
| 8 | Released under the LGPL (GNU Lesser General Public License) |
| 9 | |
| 10 | Author: Kate Ward (kate.ward@forestent.com) |
| 11 | |
| 12 | This document covers any known issues and workarounds for the stated release of |
| 13 | shFlags. |
| 14 | |
| 15 | General info |
| 16 | ------------ |
| 17 | |
| 18 | This is both a minor bug fix release, and a minor new feature release of |
| 19 | shFlags. It adds several warning messages, fixes three issues, and now displays |
| 20 | the default value behind the help string when help is requested. Additionally, |
| 21 | the coding standards have been modified slightly and officially documented. |
| 22 | They were taken from the standards used by shUnit2 (the unit testing framework |
| 23 | used for the unit testing). |
| 24 | |
| 25 | Please see the CHANGES-1.0.txt file for a complete list of changes. |
| 26 | |
| 27 | The unit tests |
| 28 | -------------- |
| 29 | |
| 30 | shFlags is designed to work on as many environments as possible, but not all |
| 31 | environments are created equal. As such, not all of the unit tests will succeed |
| 32 | on every platform. The unit tests are therefore designed to fail, indicating to |
| 33 | the tester that the supported functionality is not present, but an additional |
| 34 | test is present to verify that shFlags properly caught the limitation and |
| 35 | presented the user with an appropriate error message. |
| 36 | |
| 37 | shFlags tries to support both the standard and enhanced versions of **getopt**. |
| 38 | As each responds differently, and not everything is supported on the standard |
| 39 | version, some unit tests will be skipped (i.e. ASSERTS will not be thrown) when |
| 40 | the standard version of **getopt** is detected. The reason being that there is |
| 41 | no point testing for functionality that is positively known not to exist. A |
| 42 | tally of skipped tests will be kept for later reference. |
| 43 | |
| 44 | To see the test results for the various OSes tested, please visit |
| 45 | http://forestent.com/projects/shflags/testresults/. |
| 46 | |
| 47 | Standard vs Enhanced getopt |
| 48 | --------------------------- |
| 49 | |
| 50 | Here is a matrix of the supported features of the various **getopt** variants. |
| 51 | |
| 52 | +-------------------------+---+---+ |
| 53 | |Feature |std|enh| |
| 54 | +=========================+===+===+ |
| 55 | |short option names | Y | Y | |
| 56 | |long option names | N | Y | |
| 57 | |spaces in string options | N | Y | |
| 58 | +-------------------------+---+---+ |
| 59 | |
| 60 | Known Issues |
| 61 | ------------ |
| 62 | |
| 63 | The **getopt** version provided by default with all versions of Mac OS X (up to |
| 64 | and including 10.5.5) is the standard version. As such, only short flags are |
| 65 | supported. |
| 66 | |
| 67 | The **getopt** version provided by default with all versions of Solaris (up to |
| 68 | and including Solaris 10 and OpenSolaris) is the standard version. As such, |
| 69 | only short flags are supported. |
| 70 | |
| 71 | Workarounds |
| 72 | ----------- |
| 73 | |
| 74 | The Zsh shell requires the ``shwordsplit`` option to be set, and the special |
| 75 | ``FLAGS_PARENT`` variable must be defined. |
| 76 | |
| 77 | |
| 78 | .. vim:fileencoding=latin1:ft=rst:spell:tw=80 |