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 |
=========================== |