Browse code

Update minimum bash version

Clarify our position on bash and other shells.

Change-Id: I30e801afa03f8d7235556b0933d0205a30310899

Dean Troyer authored on 2015/02/05 03:35:39
Showing 2 changed files
... ...
@@ -6,7 +6,7 @@ General
6 6
 -------
7 7
 
8 8
 DevStack is written in UNIX shell script.  It uses a number of bash-isms
9
-and so is limited to Bash (version 3 and up) and compatible shells.
9
+and so is limited to Bash (version 4 and up) and compatible shells.
10 10
 Shell script was chosen because it best illustrates the steps used to
11 11
 set up and interact with OpenStack components.
12 12
 
... ...
@@ -70,6 +70,18 @@ Q: What about Fedora/RHEL/CentOS?
70 70
 Q: Are there any differences between Ubuntu and Fedora support?
71 71
     A: Neutron is not fully supported prior to Fedora 18 due lack of
72 72
     OpenVSwitch packages.
73
+Q: Why can't I use another shell?
74
+    A: DevStack now uses some specific bash-ism that require Bash 4, such
75
+    as associative arrays. Simple compatibility patches have been accepted
76
+    in the past when they are not complex, at this point no additional
77
+    compatibility patches will be considered except for shells matching
78
+    the array functionality as it is very ingrained in the repo and project
79
+    management.
80
+Q: But, but, can't I test on OS/X?
81
+   A: Yes, even you, core developer who complained about this, needs to
82
+   install bash 4 via homebrew to keep running tests on OS/X.  Get a Real
83
+   Operating System.   (For most of you who don't know, I am refering to
84
+   myself.)
73 85
 
74 86
 Operation and Configuration
75 87
 ===========================