]> git.ipfire.org Git - thirdparty/bash.git/blobdiff - README
Bash-5.1 patch 4: fix key-value pair associative array assignment word expansions
[thirdparty/bash.git] / README
diff --git a/README b/README
index 92cf3c095b1e9ca960326e4d551c261e54af675e..70b7a8517415c2fcf324693ee33aca429fd99977 100644 (file)
--- a/README
+++ b/README
@@ -1,8 +1,8 @@
 Introduction
 ============
 
-This is GNU Bash, version 2.05a.  Bash is the GNU Project's Bourne
-Again SHell, a complete implementation of the POSIX.2 shell spec,
+This is GNU Bash, version 5.1.  Bash is the GNU Project's Bourne
+Again SHell, a complete implementation of the POSIX shell spec,
 but also with interactive command line editing, job control on
 architectures that support it, csh-like features such as history
 substitution and brace expansion, and a slew of other features. 
@@ -11,25 +11,26 @@ type of shell, see the file `doc/bashref.texi'.  There is also a
 large Unix-style man page.  The man page is the definitive description
 of the shell's features. 
 
-See the file CWRU/POSIX.NOTES for a discussion of how Bash differs
-from the POSIX.2 spec and a description of the Bash `posix mode'.
+See the file POSIX for a discussion of how the Bash defaults differ
+from the POSIX spec and a description of the Bash `posix mode'.
 
 There are some user-visible incompatibilities between this version
-of Bash and the previous widely-distributed version, bash-1.14.
-For details, see the file COMPAT.  The NEWS file tersely lists
-features that are new in this release. 
+of Bash and previous widely-distributed versions, bash-4.4 and
+bash-5.0.  For details, see the file COMPAT.  The NEWS file tersely
+lists features that are new in this release. 
 
-Bash is free software, distributed under the terms of the [GNU]
-General Public License, version 2.  For more information, see the
-file COPYING.
+Bash is free software, distributed under the terms of the [GNU] General
+Public License as published by the Free Software Foundation,
+version 3 of the License (or any later version).  For more information,
+see the file COPYING. 
 
 A number of frequently-asked questions are answered in the file
 `doc/FAQ'.
 
-To compile Bash, try typing `./configure', then `make'.  Bash
-auto-configures the build process, so no further intervention
-should be necessary.  Bash builds with `gcc' by default if it is
-available.  If you want to use `cc' instead, type
+To compile Bash, type `./configure', then `make'.  Bash auto-configures
+the build process, so no further intervention should be necessary.  Bash
+builds with `gcc' by default if it is available.  If you want to use `cc'
+instead, type
 
        CC=cc ./configure
 
@@ -67,9 +68,9 @@ built at the same time as bash.  If bash fails to build, try building
 bashbug directly with `make bashbug'.  If you cannot build `bashbug',
 please send mail to bug-bash@gnu.org with the following information:
 
-       * the version number and release status of Bash (e.g., 2.01-release)
-       * the machine and OS that it is running on (look at the file
-         `.made' in the bash build directory)
+       * the version number and release status of Bash (e.g., 2.05a-release)
+       * the machine and OS that it is running on (you may run
+         `bashversion -l' from the bash build directory for this information)
        * a list of the compilation flags or the contents of `config.h', if
          appropriate
        * a description of the bug
@@ -78,13 +79,33 @@ please send mail to bug-bash@gnu.org with the following information:
 
 The `bashbug' program includes much of this automatically.
 
+Questions and requests for help with bash and bash programming may be
+sent to the help-bash@gnu.org mailing list.
+
 If you would like to contact the Bash maintainers directly, send mail
 to bash-maintainers@gnu.org.
 
 While the Bash maintainers do not promise to fix all bugs, we would
 like this shell to be the best that we can make it.
 
+Other Packages
+==============
+
+This distribution includes, in examples/bash-completion, a recent version
+of the `bash-completion' package, which provides programmable completions
+for a number of commands. It's available as a package in many distributions,
+and that is the first place from which to obtain it. If it's not a package
+from your vendor, you may install the included version.
+
+The latest version of bash-completion is always available from
+https://github.com/scop/bash-completion.
+
 Enjoy!
 
 Chet Ramey
-chet@po.cwru.edu
+chet.ramey@case.edu
+
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.  This file is offered as-is,
+without any warranty.