Clarify our position on bash and other shells.
Change-Id: I30e801afa03f8d7235556b0933d0205a30310899
... | ... |
@@ -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 |
=========================== |