xref: /bash/
Name Date Size

..27-Apr.-20224 KiB

.gitignoreH A D16-Dec.-20201.8 KiB

ABOUT-NLSH A D07-Jan.-201991.8 KiB

aclocal.m4H A D06-Dec.-202056 KiB

alias.cH A D06-Dec.-202014.9 KiB

alias.hH A D06-Dec.-20202.2 KiB

array.cH A D06-Dec.-202026.6 KiB

array.hH A D06-Dec.-20204.4 KiB

arrayfunc.cH A D04-May-202139.2 KiB

arrayfunc.hH A D20-Dec.-20203.8 KiB

assoc.cH A D06-Dec.-202012.1 KiB

assoc.hH A D06-Dec.-20202.4 KiB

AUTHORSH A D13-Aug.-201716.8 KiB

bashansi.hH A D13-Aug.-20171.2 KiB

bashhist.cH A D06-Dec.-202028.6 KiB

bashhist.hH A D06-Dec.-20202.9 KiB

bashintl.hH A D07-Jan.-20191.4 KiB

bashjmp.hH A D07-Jan.-20191.6 KiB

bashline.cH A D06-Dec.-2020126.7 KiB

bashline.hH A D06-Dec.-20202.5 KiB

bashtypes.hH A D13-Aug.-20171.1 KiB

bracecomp.cH A D06-Dec.-20205.7 KiB

braces.cH A D06-Dec.-202019.6 KiB

builtins/H17-Nov.-20214 KiB

builtins.hH A D07-Jan.-20192.3 KiB

ChangeLogH A D06-Dec.-2020340.8 KiB

CHANGESH A D06-Dec.-2020405.3 KiB

command.hH A D17-Nov.-202115.5 KiB

COMPATH A D06-Dec.-202025.1 KiB

config-bot.hH A D06-Dec.-20206.4 KiB

config-top.hH A D06-Dec.-20207.5 KiB

config.h.inH A D06-Dec.-202030.6 KiB

configureH A D06-Dec.-2020581.4 KiB

configure.acH A D06-Dec.-202040.1 KiB

configure.inH A D13-Aug.-201734.9 KiB

conftypes.hH A D13-Aug.-20171.7 KiB

copy_cmd.cH A D06-Dec.-202011.9 KiB

COPYINGH A D13-Aug.-201734.3 KiB

cross-build/H07-Jan.-20194 KiB

CWRU/H06-Dec.-20204 KiB

dispose_cmd.cH A D13-Aug.-20176.2 KiB

dispose_cmd.hH A D06-Dec.-20201.4 KiB

doc/H06-Dec.-20204 KiB

error.cH A D06-Dec.-202010.1 KiB

error.hH A D06-Dec.-20203 KiB

eval.cH A D06-Dec.-20209.3 KiB

examples/H07-Jan.-20194 KiB

execute_cmd.cH A D17-Nov.-2021166.1 KiB

execute_cmd.hH A D06-Dec.-20204 KiB

expr.cH A D06-Dec.-202035.2 KiB

externs.hH A D06-Dec.-202019.7 KiB

findcmd.cH A D06-Dec.-202019.2 KiB

findcmd.hH A D06-Dec.-20201.6 KiB

flags.cH A D06-Dec.-202010.3 KiB

flags.hH A D06-Dec.-20202.6 KiB

general.cH A D06-Dec.-202033.6 KiB

general.hH A D06-Dec.-202012.1 KiB

hashcmd.cH A D06-Dec.-20205.1 KiB

hashcmd.hH A D06-Dec.-20201.4 KiB

hashlib.cH A D06-Dec.-202012 KiB

hashlib.hH A D06-Dec.-20203 KiB

include/H06-Dec.-20204 KiB

input.cH A D06-Dec.-202016.4 KiB

input.hH A D06-Dec.-20204.5 KiB

INSTALLH A D07-Jan.-201917.8 KiB

jobs.cH A D17-Nov.-2021134.5 KiB

jobs.hH A D06-Dec.-202011 KiB

lib/H13-Aug.-20174 KiB

list.cH A D13-Aug.-20173.4 KiB

locale.cH A D06-Dec.-202016.1 KiB

m4/H06-Dec.-20204 KiB

mailcheck.cH A D06-Dec.-202011.4 KiB

mailcheck.hH A D06-Dec.-20201.3 KiB

make_cmd.cH A D06-Dec.-202022.5 KiB

make_cmd.hH A D06-Dec.-20203 KiB

Makefile.inH A D20-Dec.-202086.2 KiB

MANIFESTH A D06-Dec.-202032.1 KiB

MANIFEST.docH A D13-Aug.-2017401

mksyntax.cH A D13-Aug.-20177.2 KiB

NEWSH A D06-Dec.-202099.8 KiB

nojobs.cH A D17-Nov.-202124 KiB

NOTESH A D06-Dec.-202014 KiB

parse.yH A D04-Jan.-2022191.4 KiB

parser-builtH A D06-Dec.-20206.1 KiB

parser.hH A D06-Dec.-20203.7 KiB

patchlevel.hH A D04-Jan.-20221.1 KiB

pathexp.cH A D06-Dec.-202016.4 KiB

pathexp.hH A D06-Dec.-20204.3 KiB

pathnames.h.inH A D13-Aug.-20171.2 KiB

pcomplete.cH A D06-Dec.-202046.2 KiB

pcomplete.hH A D06-Dec.-20205 KiB

pcomplib.cH A D06-Dec.-20204.4 KiB

po/H20-Feb.-20214 KiB

POSIXH A D06-Dec.-202010.6 KiB

print_cmd.cH A D06-Dec.-202038.3 KiB

quit.hH A D13-Aug.-20172.5 KiB

RBASHH A D06-Dec.-20202.4 KiB

READMEH A D06-Dec.-20204.2 KiB

redir.cH A D06-Dec.-202041.8 KiB

redir.hH A D06-Dec.-20201.6 KiB

shell.cH A D06-Dec.-202056.7 KiB

shell.hH A D06-Dec.-20205.9 KiB

sig.cH A D17-Nov.-202120.7 KiB

sig.hH A D06-Dec.-20204.6 KiB

siglist.cH A D06-Dec.-20204.7 KiB

siglist.hH A D06-Dec.-20201.5 KiB

stringlib.cH A D13-Aug.-20176.5 KiB

subst.cH A D04-Jan.-2022332.5 KiB

subst.hH A D06-Dec.-202015.1 KiB

support/H06-Dec.-20204 KiB

syntax.hH A D06-Dec.-20203.5 KiB

test.cH A D06-Dec.-202021 KiB

test.hH A D06-Dec.-20201.2 KiB

tests/H06-Dec.-202020 KiB

trap.cH A D17-Nov.-202139.6 KiB

trap.hH A D06-Dec.-20204 KiB

unwind_prot.cH A D06-Dec.-20208.9 KiB

unwind_prot.hH A D06-Dec.-20202 KiB

variables.cH A D06-Dec.-2020162.7 KiB

variables.hH A D06-Dec.-202017.9 KiB

version.cH A D06-Dec.-20202.8 KiB

xmalloc.cH A D06-Dec.-20204.7 KiB

xmalloc.hH A D06-Dec.-20201.9 KiB

y.tab.cH A D04-Jan.-2022277.1 KiB

y.tab.hH A D06-Dec.-20206.1 KiB

Y2KH A D13-Aug.-2017205


4This is GNU Bash, version 5.1.  Bash is the GNU Project's Bourne
5Again SHell, a complete implementation of the POSIX shell spec,
6but also with interactive command line editing, job control on
7architectures that support it, csh-like features such as history
8substitution and brace expansion, and a slew of other features. 
9For more information on the features of Bash that are new to this
10type of shell, see the file `doc/bashref.texi'.  There is also a
11large Unix-style man page.  The man page is the definitive description
12of the shell's features. 
14See the file POSIX for a discussion of how the Bash defaults differ
15from the POSIX spec and a description of the Bash `posix mode'.
17There are some user-visible incompatibilities between this version
18of Bash and previous widely-distributed versions, bash-4.4 and
19bash-5.0.  For details, see the file COMPAT.  The NEWS file tersely
20lists features that are new in this release. 
22Bash is free software, distributed under the terms of the [GNU] General
23Public License as published by the Free Software Foundation,
24version 3 of the License (or any later version).  For more information,
25see the file COPYING. 
27A number of frequently-asked questions are answered in the file
30To compile Bash, type `./configure', then `make'.  Bash auto-configures
31the build process, so no further intervention should be necessary.  Bash
32builds with `gcc' by default if it is available.  If you want to use `cc'
33instead, type
35	CC=cc ./configure
37if you are using a Bourne-style shell.  If you are not, the following
38may work:
40	env CC=cc ./configure
42Read the file INSTALL in this directory for more information about how
43to customize and control the build process.  The file NOTES contains
44platform-specific installation and configuration information.
46If you are a csh user and wish to convert your csh aliases to Bash
47aliases, you may wish to use the script `examples/misc/alias-conv.sh'
48as a starting point.  The script `examples/misc/cshtobash' is a
49more ambitious script that attempts to do a more complete job.
51Reporting Bugs
54Bug reports for bash should be sent to:
56	bug-bash@gnu.org
58using the `bashbug' program that is built and installed at the same
59time as bash.
61The discussion list `bug-bash@gnu.org' often contains information
62about new ports of Bash, or discussions of new features or behavior
63changes that people would like.  This mailing list is also available
64as a usenet newsgroup: gnu.bash.bug. 
66When you send a bug report, please use the `bashbug' program that is
67built at the same time as bash.  If bash fails to build, try building
68bashbug directly with `make bashbug'.  If you cannot build `bashbug',
69please send mail to bug-bash@gnu.org with the following information:
71	* the version number and release status of Bash (e.g., 2.05a-release)
72	* the machine and OS that it is running on (you may run
73	  `bashversion -l' from the bash build directory for this information)
74	* a list of the compilation flags or the contents of `config.h', if
75	  appropriate
76	* a description of the bug
77	* a recipe for recreating the bug reliably
78	* a fix for the bug if you have one!
80The `bashbug' program includes much of this automatically.
82Questions and requests for help with bash and bash programming may be
83sent to the help-bash@gnu.org mailing list.
85If you would like to contact the Bash maintainers directly, send mail
86to bash-maintainers@gnu.org.
88While the Bash maintainers do not promise to fix all bugs, we would
89like this shell to be the best that we can make it.
91Other Packages
94This distribution includes, in examples/bash-completion, a recent version
95of the `bash-completion' package, which provides programmable completions
96for a number of commands. It's available as a package in many distributions,
97and that is the first place from which to obtain it. If it's not a package
98from your vendor, you may install the included version.
100The latest version of bash-completion is always available from
105Chet Ramey
108Copying and distribution of this file, with or without modification,
109are permitted in any medium without royalty provided the copyright
110notice and this notice are preserved.  This file is offered as-is,
111without any warranty.