Index of /bashinfo/source/bash-3.1

Icon  Name                    Last modified      Size  Description
[DIR] Parent Directory - [TXT] ABOUT-NLS 09-Dec-2003 12:39 38K [TXT] AUTHORS 10-Jan-2004 20:14 16K [TXT] CHANGES 07-Dec-2005 09:08 206K [TXT] COMPAT 05-Dec-2005 17:03 8.8K [TXT] COPYING 07-Jul-1997 17:03 18K [DIR] CWRU/ 06-Dec-2005 09:57 - [TXT] INSTALL 22-Oct-2005 17:02 16K [   ] MANIFEST 18-Oct-2005 10:42 21K [   ] MANIFEST.doc 19-Nov-2001 13:36 401 [TXT] Makefile.in 25-Oct-2005 14:37 72K [TXT] NEWS 17-Nov-2005 10:36 48K [TXT] NOTES 14-Oct-2003 11:27 13K [TXT] POSIX 19-Oct-2005 16:57 7.5K [TXT] RBASH 19-Oct-2005 16:57 1.7K [TXT] Y2K 10-Jan-2004 20:16 205 [TXT] aclocal.m4 09-May-2005 15:23 125K [TXT] alias.c 13-Mar-2002 14:03 15K [TXT] alias.h 02-Aug-2001 11:27 2.1K [TXT] array.c 01-Jun-2005 16:39 19K [TXT] array.h 01-Jun-2003 15:50 3.7K [TXT] arrayfunc.c 04-Jul-2005 20:25 20K [TXT] arrayfunc.h 07-Nov-2004 15:12 2.1K [TXT] bashansi.h 15-Oct-2001 09:29 1.3K [TXT] bashhist.c 30-Sep-2005 22:30 21K [TXT] bashhist.h 01-Jul-2005 15:44 2.2K [TXT] bashintl.h 18-Dec-2003 17:12 1.3K [TXT] bashjmp.h 03-Jun-2003 13:45 1.5K [TXT] bashline.c 05-Nov-2005 15:07 83K [TXT] bashline.h 25-Apr-2003 18:17 1.8K [TXT] bashtypes.h 02-Jan-2002 14:03 1.1K [TXT] bracecomp.c 13-Mar-2002 14:04 5.3K [TXT] braces.c 17-Sep-2004 18:42 12K [TXT] builtins.h 30-Dec-2004 13:59 2.1K [DIR] builtins/ 06-Dec-2005 09:57 - [TXT] command.h 09-Jul-2005 14:19 13K [TXT] config-bot.h 19-Mar-2004 17:56 5.7K [TXT] config-top.h 29-Apr-2005 16:36 3.4K [TXT] config.h.in 04-Sep-2005 22:35 25K [   ] configure 01-Dec-2005 09:44 650K [TXT] configure.in 01-Dec-2005 09:36 33K [TXT] conftypes.h 27-Oct-2005 16:05 1.7K [TXT] copy_cmd.c 07-Oct-2003 11:43 11K [DIR] cross-build/ 06-Dec-2005 09:57 - [TXT] dispose_cmd.c 11-Feb-2005 11:49 6.0K [TXT] dispose_cmd.h 11-Feb-2005 11:50 1.4K [DIR] doc/ 28-May-2007 03:49 - [TXT] error.c 30-Jun-2005 10:25 9.1K [TXT] error.h 25-Mar-2002 10:02 2.8K [TXT] eval.c 03-Oct-2005 14:48 6.5K [DIR] examples/ 06-Dec-2005 09:56 - [TXT] execute_cmd.c 05-Nov-2005 14:37 112K [TXT] execute_cmd.h 07-May-2001 10:39 1.6K [TXT] expr.c 15-Feb-2005 10:07 26K [TXT] externs.h 11-Nov-2005 23:10 14K [TXT] findcmd.c 17-Aug-2005 16:49 16K [TXT] findcmd.h 13-Sep-2001 15:24 1.3K [TXT] flags.c 16-Jul-2004 21:19 9.9K [TXT] flags.h 12-Sep-2003 17:27 2.4K [TXT] general.c 28-Aug-2005 15:56 25K [TXT] general.h 28-Aug-2005 15:56 9.8K [TXT] hashcmd.c 19-Mar-2002 10:19 5.2K [TXT] hashcmd.h 19-Mar-2002 10:11 1.5K [TXT] hashlib.c 18-Mar-2002 10:30 9.6K [TXT] hashlib.h 26-Feb-2002 15:00 3.0K [DIR] include/ 06-Dec-2005 09:57 - [TXT] input.c 14-Jul-2005 08:29 15K [TXT] input.h 30-Jan-2002 09:11 4.3K [TXT] jobs.c 11-Nov-2005 23:13 101K [TXT] jobs.h 18-Oct-2005 11:03 8.0K [DIR] lib/ 06-Dec-2005 09:56 - [TXT] list.c 18-Mar-2002 13:13 3.5K [TXT] locale.c 01-Aug-2004 21:30 12K [TXT] mailcheck.c 05-Nov-2004 20:00 10K [TXT] mailcheck.h 05-Aug-1999 07:21 1.3K [TXT] make_cmd.c 07-Jul-2005 08:14 21K [TXT] make_cmd.h 11-Feb-2005 11:50 2.8K [TXT] mksyntax.c 12-Sep-2003 18:36 6.9K [TXT] nojobs.c 11-Nov-2005 23:13 21K [TXT] parse.y 11-Nov-2005 23:14 128K [TXT] parser-built 14-Nov-2005 09:53 0 [TXT] parser.h 05-Aug-1999 07:11 1.3K [TXT] patchlevel.h 20-Jul-2005 13:58 1.2K [TXT] pathexp.c 06-May-2002 13:43 9.6K [TXT] pathexp.h 19-Feb-2005 17:23 3.8K [TXT] pathnames.h.in 25-Feb-2003 11:31 1.2K [TXT] pcomplete.c 16-Nov-2005 13:42 35K [TXT] pcomplete.h 25-Apr-2003 17:37 4.4K [TXT] pcomplib.c 19-Dec-2003 15:59 4.3K [DIR] po/ 06-Dec-2005 09:57 - [TXT] print_cmd.c 04-Jul-2005 13:05 30K [TXT] quit.h 10-Sep-2001 10:08 1.3K [TXT] redir.c 11-Oct-2005 15:58 29K [TXT] redir.h 11-Oct-2005 10:11 1.4K [TXT] shell.c 04-Sep-2005 22:32 48K [TXT] shell.h 01-Jun-2003 15:04 4.3K [TXT] sig.c 22-Oct-2005 17:04 13K [TXT] sig.h 18-Oct-2005 16:43 4.2K [TXT] siglist.c 02-Aug-2001 12:11 4.6K [TXT] siglist.h 04-Oct-2001 15:14 1.5K [TXT] stringlib.c 18-Mar-2002 13:31 6.5K [TXT] subst.c 24-Oct-2005 09:51 205K [TXT] subst.h 07-Nov-2004 15:12 10K [DIR] support/ 06-Dec-2005 09:57 - [TXT] syntax.h 14-Apr-2004 23:19 3.3K [TXT] test.c 19-Feb-2005 17:26 21K [TXT] test.h 23-Sep-1997 13:04 1.3K [DIR] tests/ 06-Dec-2005 09:57 - [TXT] trap.c 11-Feb-2005 11:51 27K [TXT] trap.h 18-Nov-2004 10:05 2.9K [TXT] unwind_prot.c 28-Feb-2002 14:34 7.8K [TXT] unwind_prot.h 28-Feb-2002 12:16 1.9K [TXT] variables.c 12-Nov-2005 21:22 104K [TXT] variables.h 11-Nov-2005 19:40 13K [TXT] version.c 16-May-2005 11:58 2.3K [TXT] xmalloc.c 19-Dec-2003 16:36 4.5K [TXT] xmalloc.h 05-Dec-2001 09:18 1.8K [TXT] y.tab.c 14-Nov-2005 09:53 179K [TXT] y.tab.h 14-Nov-2005 09:53 1.0K
Introduction
============

This is GNU Bash, version 3.1.  Bash is the GNU Project's Bourne
Again SHell, a complete implementation of the POSIX.2 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. 
For more information on the features of Bash that are new to this
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 POSIX for a discussion of how the Bash defaults differ
from the POSIX.2 spec and a description of the Bash `posix mode'.

There are some user-visible incompatibilities between this version
of Bash and a 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. 

Bash is free software, distributed under the terms of the [GNU]
General Public License, version 2.  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

	CC=cc ./configure

if you are using a Bourne-style shell.  If you are not, the following
may work:

	env CC=cc ./configure

Read the file INSTALL in this directory for more information about how
to customize and control the build process.  The file NOTES contains
platform-specific installation and configuration information.

If you are a csh user and wish to convert your csh aliases to Bash
aliases, you may wish to use the script `examples/misc/alias-conv.sh'
as a starting point.  The script `examples/misc/cshtobash' is a
more ambitious script that attempts to do a more complete job.

Reporting Bugs
==============

Bug reports for bash should be sent to:

	bug-bash@gnu.org

using the `bashbug' program that is built and installed at the same
time as bash.

The discussion list `bug-bash@gnu.org' often contains information
about new ports of Bash, or discussions of new features or behavior
changes that people would like.  This mailing list is also available
as a usenet newsgroup: gnu.bash.bug. 

When you send a bug report, please use the `bashbug' program that is
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.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
	* a recipe for recreating the bug reliably
	* a fix for the bug if you have one!

The `bashbug' program includes much of this automatically.

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.

Enjoy!

Chet Ramey
chet@po.cwru.edu